--- title: Módulo ACL- Gestión de Roles, Permisos y Autorizacione slug: modulo-acl-gestion-de-roles-permisos-y-autorizacione docTags: createdAt: 2026-01-25T18:20:19.099Z --- ## 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. :::hint{type="success"} 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. | ## ```mermaid 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): 1. **Mi Perfil** → Ver datos propios y roles asignados. 2. **Roles** → Crear, editar, eliminar y consultar roles. 3. **Colaboradores** → Asignar/quitar roles a usuarios. 4. **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** 1. Ir a **Roles → Crear rol** 2. Completar: - **Nombre del rol** (obligatorio) - **Descripción** (opcional) 3. Elegir tipo de configuración: - **Simple** → Básico / Medio / Completo (preconfigurados) - **Personalizada** (recomendada para control fino) 4. 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. 5. Marcar la casilla **“Habilitar este rol como firmante”** si quieres que pueda aprobar acciones de otros roles. 6. Pulsar **Crear rol** 7. Al final podrás elegir: - **Asignar rol** (a uno o más colaboradores) - **Ir a inicio** (asignarás después) **Editar un rol existente** 1. En la lista de roles → botón lápiz ✏️ 2. 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 3. 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** 1. Ir a **Colaboradores → Asignar rol** 2. Buscar por email completo (puedes agregar varios) 3. Marcar uno o varios roles a asignar 4. (Opcional) Ver detalle de cada rol con el desplegable 5. Pulsar **Asignar rol** **Quitar rol a un colaborador** 1. En la lista de colaboradores → botón lápiz ✏️ del usuario 2. Panel lateral → sección “Roles asignados” 3. Desmarcar el/los rol/es que deseas quitar o usar “Eliminar todos los roles” 4. 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.) |