Tres capas independientes deciden el acceso: rol (RBAC) — lo que puedes hacer; RLS — qué filas ves; verificación de cuenta al día — si la cuenta está al día. Consulta Roles, RLS y Suspensión.
Permisos / RBAC / RLS#
| Síntoma | Causa probable | Cómo verificar | Solución | Prevención |
|---|---|---|---|---|
"Acción no permitida para el rol" (403) | rol inferior al exigido | revisa el rol en la matriz RBAC | el owner eleva el rol | asigna el rol mínimo por función |
| El miembro no puede ejecutar consulta/refresh/IA | la acción costosa exige admin+ | consulta la matriz de roles | eleva a admin o usa una cuenta adecuada | reserva las acciones costosas para admins |
| La persona ve cero filas | RLS fail-closed (atributo ausente) | revisa el atributo del miembro | define el atributo (ej.: filial) en el perfil | estandariza los atributos al registrar |
| La persona ve filas de más | grant de RLS no configurado | revisa el grant del dashboard | crea el grant {column, memberAttribute} | revisa la RLS al publicar |
| El atributo de RLS "no se aplica" | diferencia de mayúsculas/typo | la clave se normaliza | revisa el nombre del atributo | usa nombres de atributo consistentes |
| El miembro ve PII indebidamente | viewPII activado | revisa el permiso granular | desactiva viewPII en el perfil | mínimo privilegio por defecto |
| La columna PII desapareció del dashboard | enmascaramiento por viewPII | esperado para quien no tiene viewPII | concede viewPII si corresponde | clasifica la PII en el catálogo |
Todo devuelve 402 | suscripción vencida/suspendida | consulta Suspensión | el owner regulariza en Planes | da seguimiento a la facturación |
org_admin no ve datos | comportamiento esperado (la org es estructural) | confirma la membresía en el workspace | hazte miembro del workspace de destino | separa la administración del acceso a datos |
Exportación (xlsx / pdf / pptx)#
| Síntoma | Causa probable | Cómo verificar | Solución | Prevención |
|---|---|---|---|---|
| Exportar bloqueado | rol sin exportación de datos o 402 | revisa rol/facturación | eleva el rol / regulariza el pago | reserva la exportación a member+ |
| La exportación tiene más filas que la pantalla | virtualización (pantalla ≠ exportación) | compara pantalla vs. archivo | la exportación trae el total (esperado) | comunica la diferencia a los usuarios |
| El PDF del informe no se genera | dependencia de PDF no configurada | consulta Exportación y distribución | confirma el aprovisionamiento | prueba el envío antes de programarlo |
| La exportación con RLS no recorta | RLS por destinatario no configurada | revisa la suscripción del informe | configura el filtro por destinatario | valida la RLS en el envío de informes |
| Apareció PII en una exportación | quien exportó tiene viewPII | revisa el permiso del autor | quita viewPII a quien no deba tenerlo | gobierna la PII por rol/permiso |
Verificación rápida#
403→ problema de rol/alcance (RBAC). Ajusta el rol.- Cero filas → problema de RLS (atributo ausente = denyAll). Define el atributo.
402→ problema de facturación (no de permisos). Regulariza.
Relacionados#
Última revisión: 2026-09-08. RBAC y RLS son fail-closed: sin permiso, el acceso se niega.