El control de acceso basado en roles (RBAC) define qué puede hacer cada persona. Son 4 roles de workspace (con herencia acumulada) más 1 rol de organización, ortogonal.
Los 5 roles#
Workspace (herencia acumulada owner ⊇ admin ⊇ member ⊇ viewer):
| Rol | Perfil | Resumen |
|---|---|---|
viewer | Consume | ve dashboards e informes |
member | Analista básico | todo lo del viewer + interactúa (filtros/drill) y exporta |
admin | Operador | todo lo del member + ejecuta consultas/refresh/IA, gestiona contenido, fuentes, personas y claves |
owner | Dueño | todo lo del admin + facturación, eliminación del workspace y asignación de roles |
Organización (dimensión separada):
| Rol | Perfil | Resumen |
|---|---|---|
org_admin | Administra la estructura | gestiona workspaces/miembros/configuración de la org — sin acceso a los datos |
owneres estructural (el dueño del workspace). Un miembro común nunca se convierte enownerpor configuración — el borde es fail-closed.
Matriz rol × capacidad#
| Acción (RBAC) | viewer | member | admin | owner | org_admin |
|---|---|---|---|---|---|
| visualización de paneles / consulta de informes | ✓ | ✓ | ✓ | ✓ | — |
| interacción con los datos (filtros/drill) | — | ✓ | ✓ | ✓ | — |
| exportación de datos | — | ✓ | ✓ | ✓ | — |
data.query.run | — | — | ✓ | ✓ | — |
refresh.trigger | — | — | ✓ | ✓ | — |
| recursos de IA | — | — | ✓ | ✓ | — |
| gestión de paneles / gestión de informes | — | — | ✓ | ✓ | — |
source.manage | — | — | ✓ | ✓ | — |
member.manage | — | — | ✓ | ✓ | — |
apikey.manage | — | — | ✓ | ✓ | — |
workspace.settings | — | — | ✓ | ✓ | — |
billing.manage | — | — | — | ✓ | — |
workspace.delete | — | — | — | ✓ | — |
role.assign | — | — | — | ✓ | — |
org.workspace.manage | — | — | — | — | ✓ |
org.member.manage | — | — | — | — | ✓ |
org.settings | — | — | — | — | ✓ |
Disponibilidad#
- Planes: todos. RBAC es núcleo de seguridad.
- Funcionamiento: matriz determinística, cubierta por pruebas automáticas.
Permisos#
- Solo el owner puede asignar roles (
role.assign). - admin puede gestionar personas (
member.manage), pero no la facturación ni la eliminación del workspace.
Configuración#
- El rol del miembro viene de
permissionsJson.role(admin/member/viewer). - Rol ausente/inválido →
member(default heredado); valor desconocido o intento deownervía JSON →viewer(fail-closed). - El rol
org_adminse asigna en el contexto de la organización.
Validación (fail-closed)#
- Rol desconocido/basura → tratado como
viewer(menor privilegio). - Acción desconocida → denegada (no pertenece a ningún conjunto).
org_adminsolo habilita accionesorg.*— nunca datos del workspace.
Ejemplo#
En Comércio Aurora: Maria es owner (hace todo, incluso facturar). João es
admin (ejecuta pipelines, gestiona fuentes y personas, pero no factura). Ana es member
(interactúa y exporta). Los gerentes son viewer. En el Grupo Aurora, João también es
org_admin para administrar la estructura de la organización — sin ver por ello los datos
de ventas.
Costo#
- RBAC no consume recursos de nube: R$ 0.
Seguridad#
- Fail-closed en todo borde; menor privilegio como default.
- RBAC es una verificación anterior a la verificación de cuenta al día: rol sin capacidad → 403 sin siquiera consultar la central de cobro.
org_adminaislado de los datos (la org es estructural).
Límites#
- 5 roles fijos (4 de workspace + 1 de org). Los roles 100% personalizados no forman parte del producto actual.
- Para restringir por fila (ej.: solo la propia sucursal), RBAC no basta — usa RLS/ABAC.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El miembro no puede facturar | solo owner tiene billing.manage | acción exclusiva del dueño |
| "Acción no permitida para el rol" | rol por debajo del exigido | eleva el rol (lo asigna el owner) |
org_admin sin ver datos | comportamiento esperado | hazte miembro del workspace objetivo |
| El rol "cayó" a viewer | JSON inválido / intento de owner | corrige el rol a admin/member/viewer |
Próximos pasos: Seguridad por fila (RLS).