Módulo ACL- Gestión de Roles, Permisos y Autorizacione
Definiciones
El módulo ACL (Access Control Lists) provee las capacidades necesarias para administrar de forma centralizada y segura quién puede hacer qué
dentro de SUGA, mediante un modelo de roles (conjuntos de permisos) y permisos (acciones específicas por módulo).
Implementa el dominio de control de acceso y gobierno operacional, habilitando:
- Seguridad basada en principio de menor privilegio.
- Agilidad operativa: cambios en un rol se aplican a todos sus usuarios automáticamente.
- Control granular por módulo y por acción
SUGA asigna inicialmente el rol Administrador a las personas que el adquirente indique, y desde allí el equipo puede gestionar el resto de roles de forma autónoma.
ACL actúa como una capa que traduce:
Riesgo operativo + segregación de funciones → permisos accionables por módulo → controles auditables
Esto permite al adquirente alinear la operación interna (comercial, soporte, operaciones, finanzas, compliance) con un esquema técnico consistente, trazable y escalable.
SUGA asignará inicialmente el rol Administrador a las personas que la entidad indique. Desde ese momento, esos administradores podrán crear y gestionar todos los roles necesarios de forma autónoma.
Conceptos básicos
Término | Definición |
|---|---|
Rol | Conjunto de permisos que define qué puede hacer un usuario o grupo de usuarios. |
Permiso | Autorización específica para realizar una acción dentro de un módulo. |
Colaborador | Usuario del sistema (persona que tiene login). |
Doble firma / Autorización | Mecanismo que obliga a que ciertas acciones críticas sean aprobadas por uno o más roles adicionales antes de ejecutarse. |
Rol autorizador (firmante) | Rol que tiene permiso para aprobar o rechazar acciones que requieren doble firma. |
Autorizaciones pendientes | Acciones críticas que aún no han sido tomadas por ningún autorizador del rol correspondiente. |
Autorizaciones en curso | Acciones que un autorizador ya se asignó para revisar. |
Autorizaciones realizadas | Historial de acciones ya aprobadas o rechazadas por el usuario logueado. |
flowchart LR
U[Usuario]
%% Roles
U --> R[Modulo Roles]
R --> CR[Crear Rol]
R --> ER[Editar Rol]
R --> DR[Quitar Rol]
%% Colaboradores
U --> C[Modulo Colaboradores]
C --> ARP[Asignar Rol a Persona]
C --> QRP[Quitar Rol a Persona]
%% Autorizaciones
U --> A[Modulo Autorizaciones]
A --> AP[Autorizaciones Pendientes]
AP --> TOMA[Asignar a mi]
A --> AC[Autorizaciones En Curso]
AC --> APR[Aprobar]
AC --> REJ[Rechazar]
Estructura del módulo – Menú principal
El módulo tiene 4 secciones (la visibilidad depende de los permisos del usuario):
- Mi Perfil → Ver datos propios y roles asignados.
- Roles → Crear, editar, eliminar y consultar roles.
- Colaboradores → Asignar/quitar roles a usuarios.
- Autorizaciones → Gestionar aprobaciones (solo visible para roles autorizadores).
Sección “Mi Perfil”
- Muestra nombre, email y todos los roles asignados al usuario que está logueado.
- No permite edición (solo consulta).
Sección “Roles” – Gestión completa de roles
Crear un rol nuevo
- Ir a Roles → Crear rol
- Completar:
- Nombre del rol (obligatorio)
- Descripción (opcional)
- Elegir tipo de configuración:
- Simple → Básico / Medio / Completo (preconfigurados)
- Personalizada (recomendada para control fino)
- Si eliges Personalizada:
- Seleccionar uno o más módulos donde operará el rol.
- Para cada módulo marcar las acciones que tendrá permitidas.
- Para cada acción podrás decidir si requiere doble firma y qué rol/es serán los autorizadores.
- Algunas acciones tienen doble firma obligatoria → deberás elegir al menos un rol firmante.
- Marcar la casilla “Habilitar este rol como firmante” si quieres que pueda aprobar acciones de otros roles.
- Pulsar Crear rol
- Al final podrás elegir:
- Asignar rol (a uno o más colaboradores)
- Ir a inicio (asignarás después)
Editar un rol existente
- En la lista de roles → botón lápiz ✏️
- Puedes modificar:
- Nombre y descripción
- Módulos y acciones permitidas
- Roles firmantes para cada acción
- Agregar o quitar colaboradores que tienen este rol
- Guardar con Editar rol
Eliminar un rol
Botón papelera 🗑️ (Se puede eliminar solo si ningún colaborador lo tiene asignado o si se quitan previamente)
Ver información detallada de un rol
Botón “más” (tres puntos) → permite ver todo sin editar. Desde ahí también puedes pulsar Editar rol si necesitas cambios.
Sección “Colaboradores” – Gestión de usuarios
Asignar rol a uno o más colaboradores
- Ir a Colaboradores → Asignar rol
- Buscar por email completo (puedes agregar varios)
- Marcar uno o varios roles a asignar
- (Opcional) Ver detalle de cada rol con el desplegable
- Pulsar Asignar rol
Quitar rol a un colaborador
- En la lista de colaboradores → botón lápiz ✏️ del usuario
- Panel lateral → sección “Roles asignados”
- Desmarcar el/los rol/es que deseas quitar o usar “Eliminar todos los roles”
- Confirmar
Importante: Si el colaborador es firmante y tiene autorizaciones “en curso”, al quitarle el rol firmante esas autorizaciones volverán a “pendientes”.
Buscar colaboradores
Campo de búsqueda por email en la parte superior.
Buenas prácticas operativas del módulo
Situación | Recomendación |
|---|---|
Roles firmantes | Crear roles específicos como “Aprobador Nivel 1”, “Gerencia” y asignarlos como firmantes. Evitar que el mismo rol que ejecuta la acción sea también firmante de esa misma acción. |
Revisar periódicamente | Roles y asignaciones (al menos cada 6 meses o al haber cambios de personal). |
Mínimo dos personas por rol firmante | Para evitar bloqueos por vacaciones o ausencias. |
Crear roles | Uno por función real (ej. Vendedor Sucursal A, Cajero, Supervisor, Gerente Comercial, Aprobador Descuentos, etc.) |
Acciones críticas* | Siempre configurar doble firma (ej. aprobar descuentos > X%, habilitar medios de pago, dar de baja clientes, etc.) |