Saltar al contenido
Logotipo de Aurabase
aurabase

Seguridad a nivel de fila en producción

Tres patrones RLS que cubren el 95 % de los casos de uso: propiedad, multiinquilino y organización jerárquica. Con pg_prove y pruebas de depuración.

Guía práctica12 min leerNivel avanzadoRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

¿Qué es RLS?#

La seguridad a nivel de fila es una característica nativa de PostgreSQL que filtra las filas devueltas (o aceptadas) sobre la marcha, mediante la evaluación de una expresión SQL que puede depender de la función actual y de las reclamaciones de JWT. Aurabase inyecta reclamos de usuario a través de request.jwt.claims y expone los ayudantes auth.uid(), auth.role(), auth.tenant(), auth.has_role().

Tres cosas que debe saber antes de redactar una póliza
  • Nombres de roles. Las funciones canónicas de la base de datos son aura_anon, aura_authenticated y aura_service_role. En los clústeres administrados, los alias de grupo anon, authenticated y service_role también se asignan a ellos (tenga en cuenta que BYPASSRLS permanece estrictamente solo en aura_service_role).
  • RLS está activado de forma predeterminada para las tablas creadas mediante Aurabase. Cualquier tabla creada con /raw, una migración, Studio o la API de tabla recibe automáticamente ENABLE y FORCE ROW LEVEL SECURITY (a menos que DISABLE ROW LEVEL SECURITY se ejecute explícitamente en el mismo lote DDL): las consultas públicas/anónimas devuelven [] hasta que agregue una política. Las tablas creadas a través de una conexión directa PostgreSQL (psql, Prisma, Drizzle) nunca pasan a través de ese gancho, por lo que obtienen no RLS y, en su lugar, no tienen acceso a las claves públicas: aura_anon y aura_authenticated no tienen privilegios sobre ellas hasta que lo concedes. Para exponer dicha tabla al SDK, primero habilite RLS, luego otorgue y agregue una política: ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Nunca conceda a aura_anon o aura_authenticated en una tabla cuyo RLS esté desactivado: cada titular de la clave pública, o cada usuario registrado, leería (y, con concesiones de escritura, modificaría) todas sus filas.
  • La clave pública no tiene usuario. auth.uid() es NULL para la clave pública y para una clave service_role; devuelve una identificación solo para un usuario que ha iniciado sesión. Utilice to aura_authenticated para restringir una política a usuarios que hayan iniciado sesión.

Propiedad: cada usuario tiene sus propias líneas#

Casos de uso: perfiles, notas, publicaciones donde cada línea pertenece a un usuario único a través de user_id o author_id.

migrations/posts_rls.sqlsql
alter table posts enable row level security;

create policy "posts_own_read" on posts
  for select to aura_authenticated
  using (auth.uid() = author_id);

create policy "posts_own_write" on posts
  for all to aura_authenticated
  using (auth.uid() = author_id)
  with check (auth.uid() = author_id);
Consejo

Combine for all con using + with check para cubrir SELECCIONAR/ACTUALIZAR/ELIMINAR en una sola póliza. El INSERT solo usa with check.

Multiinquilino: alcance por organización#

Caso de uso: B2B SaaS donde cada usuario pertenece a una organización y ve todos los datos de su organización. El JWT lleva app_metadata.tenant, que devuelve el ayudante auth.tenant() (NULL cuando está ausente o no es un UUID, por lo que la política lo niega).

migrations/tenant_rls.sqlsql
create policy "orders_tenant_scope" on orders
  for all to aura_authenticated
  using (tenant_id = auth.tenant())
  with check (tenant_id = auth.tenant());

-- Índice indispensable para el rendimiento.
create index idx_orders_tenant on orders(tenant_id);

Organización jerárquica: permisos por rol#

Caso de uso: SaaS donde los roles en una organización (administrador, miembro, espectador) tienen permisos diferentes. Combinamos auth.tenant() con auth.has_role().

migrations/org_rls.sqlsql
create policy "invoices_read" on invoices
  for select to aura_authenticated
  using (
    tenant_id = auth.tenant()
    and (auth.has_role('admin') or auth.has_role('billing'))
  );

create policy "invoices_write" on invoices
  for all to aura_authenticated
  using (tenant_id = auth.tenant() and auth.has_role('admin'))
  with check (tenant_id = auth.tenant());

pg_prove: una afirmación por política#

Pruebe sus políticas, como usuario real, en CI

Las políticas son código, así que pruébelas. aura db raw ... --as authenticated --user <uuid> ejecuta el SQL dentro de PostgreSQL con auth.uid() y auth.role() configurados para ese usuario (agregue --dry-run para revertir las escrituras), por lo que la respuesta es exactamente lo que verá su aplicación:

tests/rls.shbash
set -euo pipefail
ALICE=$(aura auth users create --email alice@example.com --password 'Passw0rd!long1' --json | jq -r .id)
BOB=$(aura auth users create --email bob@example.com --password 'Passw0rd!long1' --json | jq -r .id)

aura db raw "insert into posts(author_id, title) values ('$ALICE', 'hello')"
# Bob no debe ver la publicación de Alice.
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alicia debe verlo
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Un visitante no ve nada.
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

Ejecútelo en CI después de aura db push. El simulador RLS de Studio (Base de datos › una tabla › simulador RLS) ejecuta la misma verificación dentro de una transacción PostgreSQL revertida y lo dice al lado del resultado; pgTAP y pg_prove necesitan una conexión directa PostgreSQL, que no todas las implementaciones publican.

Cuando la póliza no hace lo que quieres#

  • ¿Resultado vacío? Una lectura anónima o registrada de una tabla con RLS y ninguna política SELECT coincidente devuelve [] con un meta.hint que nombra el rol y la política a agregar. aura db raw "select * from posts" --as anon muestra lo que ve un visitante.
  • RLS ¿deshabilitado? aura db table list marca tablas con [RLS] y el asesor advierte sobre tablas con RLS deshabilitado y tablas con RLS pero sin política. Desactivar RLS (aura db table rls posts off) hace que cualquier persona que tenga la clave pública pueda leer la tabla.
  • Vistas. Una vista lee con los privilegios del lector (security_invoker = true se aplica a cada vista que crea), por lo que se aplican las políticas de sus tablas.
  • Políticas que se suman: múltiples políticas en la misma tabla + operación + rol se combinan en OR. Restringir con AND en una sola política si es necesario
  • Faltan permisos GRANT: incluso con una política, el rol debe tener grant select on posts to aura_authenticated
  • Reclamaciones no inyectadas: de Postgres, select current_setting('request.jwt.claims', true): nulo significa que está en la base de datos directa, no a través de la puerta de enlace

para ir más lejos#