La RLS hace que dos personas abran el mismo dashboard y vean filas diferentes — el gerente de Campinas ve Campinas, la de Sorocaba ve Sorocaba. Este tutorial muestra el camino práctico desde el punto de vista del dashboard. La referencia conceptual completa (estática × ABAC, planes, topes, solución de problemas) está en Seguridad por fila (RLS / ABAC).
Workspace del ejemplo: Comércio Aurora Ltda (aurora), dashboard "Vendas por
filial" (ventas por sucursal).
Dos formas de RLS#
- Estática
{column, values}— fija los valores permitidos. Simple, pero exige un grant por persona; no escala más allá de unas pocas decenas. - Por atributo del miembro (ABAC)
{column, memberAttribute}— el grant dice de dónde viene el valor; el valor vive en el atributo del miembro. Un grant sirve a cientos de personas. Es lo recomendado.
Requisitos previos#
- Un plan con RLS (a partir de Growth — consulta Planes).
- Rol admin/owner para configurar grants y atributos.
- Dashboard publicado sobre un modelo con la columna de recorte (p. ej.,
vendas.filial).
Paso a paso (ABAC, recomendado)#
Define el atributo en el miembro
En Usuarios y permisos, dale al miembro el atributo
filial(sucursal) (p. ej., "Campinas"). Vive en el perfil del miembro, sin columna nueva en la base de datos. Consulta Usuarios, grupos y permisos.Crea el grant en el dashboard
En el panel de compartir/seguridad del dashboard, agrega el grant por atributo:
{column: "filial", memberAttribute: "filial"}.Publica
La RLS pasa a valer en la lectura segura del dashboard y en el envío de informes.
Prueba con cada perfil
Ábrelo como el gerente de Campinas (ve solo Campinas) y como la de Sorocaba (ve solo Sorocaba).
Prueba el fail-closed
Ábrelo como alguien SIN el atributo
filial: debe ver cero filas — nunca "todo".
Resultado esperado#
- Campinas ve solo Campinas; Sorocaba, solo Sorocaba.
- Miembro sin el atributo → denyAll (ninguna fila), nunca "sin filtro".
- Multivalor (p. ej.,
regiao = ["Sul", "Sudeste"]) se convierte en una cláusulaIN.
La RLS atraviesa exportaciones, envíos e IA#
Este es el punto que mucha gente olvida — y que ingestia.bi garantiza:
- Las exportaciones (XLSX/CSV/PDF) leen el snapshot con la RLS de quien lo solicita; el PDF bajo demanda usa un token efímero que lleva la RLS de la sesión (consulta Exportación y distribución).
- Las suscripciones por correo/WhatsApp aplican RLS por destinatario (el filtro de la suscripción se suma a la RLS, nunca la amplía).
- La IA lee la misma vista segura de la pantalla: el Q&A y los insights nunca ven más de lo que ve quien preguntó (consulta Preguntas sobre el panel y Privacidad, envío externo y presupuesto de IA).
Límites y salvedades#
- La RLS filtra filas; para ocultar columnas sensibles usa el permiso
viewPIIy la gobernanza de PII (ortogonal a la RLS). - Topes por miembro: hasta 20 atributos, clave ≤ 60 y valor ≤ 200 caracteres, hasta 50 valores por atributo.
- El aislamiento entre clientes se hace por workspace (cada uno con su datalake); la RLS filtra filas entre las personas del mismo workspace.
Errores comunes#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| La persona ve cero filas | atributo ausente/vacío (denyAll) | define el atributo en el perfil |
| La persona ve filas de más | grant no configurado en el dashboard | crea el grant {column, memberAttribute} |
| El atributo "no funciona" | diferencia de mayúsculas/error de escritura | la clave se normaliza; revisa el nombre |
| La RLS no se aplica en el correo | suscripción sin RLS por destinatario | configura el filtro por destinatario |
Relacionados#
- Seguridad por fila (RLS / ABAC)
- Roles (RBAC)
- Tutorial: publicar y compartir
- Exportación y distribución
Última revisión: 2026-09-08.