La seguridad por fila (RLS) hace que dos personas abran el mismo dashboard y vean filas diferentes. ingestia.io ofrece dos formas: RLS estática y RLS por atributo del miembro (ABAC).
Conceptos#
- RLS estática (
{column, values}): el grant fija los valores permitidos. Simple, pero exige un grant por persona — no escala más allá de unas pocas decenas. - RLS por atributo / ABAC (
{column, memberAttribute}, rowFilter v3): el grant dice de dónde viene el valor permitido, y el valor vive en el atributo del miembro. Un grant{column: "filial", memberAttribute: "filial"}sirve para 200 vendedores, cada uno viendo su propia sucursal.
Disponibilidad#
- Planes: Seguridad por fila (RLS) a partir de Growth (Starter no incluye RLS). Gobernanza de PII/policy tags a partir de Business.
- Funcionamiento: fail-closed — ante la duda, se niega el acceso. La lógica está cubierta por pruebas automáticas.
Permisos#
- Configurar RLS y los atributos del miembro exige el rol admin/owner (acciones
member.manage/ gestión de paneles). - El permiso granular Ver datos PII (
viewPII) controla la visualización de columnas sensibles — ortogonal a la RLS de filas.
Configuración (paso a paso)#
- Define los atributos del miembro (ej.:
filial = "Campinas") en el perfil, en Usuarios y permisos. Los atributos viven dentro delpermissionsJsondel miembro, enatributos— sin columna nueva en la base de datos. - Crea el grant de RLS en el dashboard/modelo:
- estática:
{column: "filial", values: ["Campinas"]}; o - por atributo:
{column: "filial", memberAttribute: "filial"}.
- estática:
- Publica. La RLS se aplica en la lectura segura del dashboard y en el envío de informes.
Topes por miembro: hasta 20 atributos, clave de hasta 60 caracteres, valor de hasta 200
caracteres, hasta 50 valores por atributo (el multivalor se convierte en una cláusula IN).
Validación (regla de oro: FAIL-CLOSED)#
- Miembro sin el atributo, atributo vacío, o identidad sin miembro → no pasa ninguna fila (denyAll). Nunca "sin filtro".
- El multivalor (ej.:
regiao = ["Sul", "Sudeste"]) se convierte enINcon el mismo tope del rowFilter. - Confírmalo abriendo el dashboard como cada perfil: cada uno ve solo su recorte.
Ejemplo#
En Comércio Aurora, el dashboard "Vendas por filial" tiene un grant por atributo
{column: "filial", memberAttribute: "filial"}:
- el gerente de Campinas (
filial = "Campinas") ve solo Campinas; - la gerente de Sorocaba (
filial = "Sorocaba") ve solo Sorocaba; - un analista sin el atributo
filialve cero filas (fail-closed).
La misma regla vale en el envío de informes (la suscripción filtra por destinatario).
Costo#
- Configurar/aplicar RLS: R$ 0 (es un filtro en la lectura; sin costo extra más allá de la propia consulta).
Seguridad#
- Fail-closed en todos los huecos (ausente/anónimo/externo → denyAll).
- Los valores se sanean (lista permitida de tipos; mayúsculas/minúsculas normalizadas) y se aplican los topes — descartar solo estrecha el acceso, nunca lo amplía.
- La RLS se aplica en la fuente única de lectura segura del dashboard y la respeta la IA.
Límites#
- La RLS estática no escala (un grant por persona) — prefiere ABAC para muchos usuarios.
- Cada workspace tiene su propio datalake; un cliente nunca lee los datos de otro. El diseño es fail-closed.
- La RLS filtra filas; para ocultar columnas sensibles, usa
viewPIIy la gobernanza de PII.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| La persona ve cero filas | atributo ausente/vacío (denyAll) | define el atributo en el perfil del miembro |
| 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/typo | 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 |
Próximos pasos: Planes y Consumo y cuotas.