Saltar al contenido principal

Gestión de Roles

La plataforma permite administrar permisos mediante roles, los cuales definen qué acciones puede realizar cada usuario dentro del sistema y del API. Esta sección explica cómo crear, configurar y asignar permisos a un rol, así como las consideraciones generales de uso.

Acceso al módulo de Roles​

Para ingresar a la administración de roles:

  1. En el menú lateral, haz clic en Usuarios.
  2. Luego selecciona la opción Roles.

Menú Usuarios y Roles

Dentro de esta vista se muestran todos los roles existentes y la opción para crear uno nuevo.

¿Para qué sirven los roles?​

Los roles permiten:

  • Definir permisos sobre funciones internas de la plataforma (listar APIs, generar credenciales, administrar usuarios, etc.).
  • Configurar permisos para consultar catálogos y ejecutar flujos.
  • Establecer límites de consumo diario y mensual de consultas hacia catálogos.
  • Controlar qué usuarios pueden tener acceso a funciones específicas del API.

Crear un nuevo rol​

Para crear un rol:

  1. Haz clic en el botón Nuevo rol.
  2. Completa los siguientes campos:
    • ID del rol: identificador único que será utilizado internamente por la plataforma.
    • Nombre del rol: título visible para identificarlo fácilmente.
    • Descripción: propósito o detalle general del rol.
    • Límite diario (opcional): número máximo de consultas de catálogos permitidas por día.
    • Límite mensual (opcional): número máximo de consultas permitidas por mes.

Menú Usuarios y Roles Una vez completados los datos, guarda el rol para continuar con la asignación de permisos.

Configuración de permisos del rol​

Cuando abras la opción Ver y configurar de un rol:

Permisos de funciones de la plataforma​

En la parte superior aparecerá el listado de todas las funciones internas disponibles, por ejemplo:

  • Listar APIs
  • Generar credenciales
  • Consultar catálogos
  • Administrar usuarios
  • Ver reportes
  • Configuración general
    y muchas más.

Cada función puede ser habilitada individualmente según lo que necesites permitir al rol.

Menú Usuarios y Roles

Permisos para catálogos y flujos​

En la parte inferior encontrarás:

  • El listado completo de catálogos de tipo fuente sencilla.
  • El listado de flujos configurados (consultas compuestas).

Desde aquí puedes habilitar los permisos de:

  • Lectura
  • Escritura (si aplica)

Cada vez que se crea un nuevo catálogo o se diseña un nuevo flujo, es indispensable regresar a este módulo y asignar los permisos correspondientes para que los usuarios puedan consultarlos.

Menú Usuarios y Roles​

Actualización de permisos del usuario​

Si un usuario ya está autenticado y posteriormente se le asignan nuevos permisos, debe cerrar sesión y volver a iniciar sesión.
Esto es necesario para refrescar sus permisos y permitirle acceder a las nuevas funcionalidades o catálogos asignados.

Notas importantes​

  • Cada rol debe configurarse completamente antes de asignarlo a usuarios.
  • Al crear nuevos catálogos o flujos, no olvides volver a Roles para habilitar los permisos.
  • Los límites diarios y mensuales son útiles para prevenir abuso o sobrecarga en consultas externas.
  • Los usuarios siempre deben actualizar sesión para reflejar los cambios asignados.