Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Roles (RBAC — 5 niveles)

En esta página (11)

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):

RolPerfilResumen
viewerConsumeve dashboards e informes
memberAnalista básicotodo lo del viewer + interactúa (filtros/drill) y exporta
adminOperadortodo lo del member + ejecuta consultas/refresh/IA, gestiona contenido, fuentes, personas y claves
ownerDueñotodo lo del admin + facturación, eliminación del workspace y asignación de roles

Organización (dimensión separada):

RolPerfilResumen
org_adminAdministra la estructuragestiona workspaces/miembros/configuración de la org — sin acceso a los datos

owner es estructural (el dueño del workspace). Un miembro común nunca se convierte en owner por configuración — el borde es fail-closed.

Matriz rol × capacidad#

Acción (RBAC)viewermemberadminownerorg_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 de owner vía JSON → viewer (fail-closed).
  • El rol org_admin se 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_admin solo habilita acciones org.* — 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_admin aislado 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íntomaCausa probableQué hacer
El miembro no puede facturarsolo owner tiene billing.manageacción exclusiva del dueño
"Acción no permitida para el rol"rol por debajo del exigidoeleva el rol (lo asigna el owner)
org_admin sin ver datoscomportamiento esperadohazte miembro del workspace objetivo
El rol "cayó" a viewerJSON inválido / intento de ownercorrige el rol a admin/member/viewer

Próximos pasos: Seguridad por fila (RLS).

Enlaces relacionados