Saltar al contenido

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

Actualizado el 2026-09-08

Tutorial: configurar seguridad por fila (RLS) en un dashboard

Hacer que dos personas abran el mismo panel y vean filas diferentes, con RLS por atributo del miembro (fail-closed).

En esta página (8)

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

  1. 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.

  2. Crea el grant en el dashboard

    En el panel de compartir/seguridad del dashboard, agrega el grant por atributo: {column: "filial", memberAttribute: "filial"}.

  3. Publica

    La RLS pasa a valer en la lectura segura del dashboard y en el envío de informes.

  4. Prueba con cada perfil

    Ábrelo como el gerente de Campinas (ve solo Campinas) y como la de Sorocaba (ve solo Sorocaba).

  5. 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áusula IN.

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 viewPII y 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íntomaCausa probableQué hacer
La persona ve cero filasatributo ausente/vacío (denyAll)define el atributo en el perfil
La persona ve filas de másgrant no configurado en el dashboardcrea el grant {column, memberAttribute}
El atributo "no funciona"diferencia de mayúsculas/error de escriturala clave se normaliza; revisa el nombre
La RLS no se aplica en el correosuscripción sin RLS por destinatarioconfigura el filtro por destinatario

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados