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.
¿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().
- Nombres de roles. Las funciones canónicas de la base de datos son
aura_anon,aura_authenticatedyaura_service_role. En los clústeres administrados, los alias de grupoanon,authenticatedyservice_roletambién se asignan a ellos (tenga en cuenta queBYPASSRLSpermanece estrictamente solo enaura_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áticamenteENABLEyFORCE ROW LEVEL SECURITY(a menos queDISABLE ROW LEVEL SECURITYse 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_anonyaura_authenticatedno 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 aaura_anonoaura_authenticateden 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()esNULLpara la clave pública y para una claveservice_role; devuelve una identificación solo para un usuario que ha iniciado sesión. Utiliceto aura_authenticatedpara 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.
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);
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).
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().
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:
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
SELECTcoincidente devuelve[]con unmeta.hintque nombra el rol y la política a agregar.aura db raw "select * from posts" --as anonmuestra lo que ve un visitante. - RLS ¿deshabilitado?
aura db table listmarca 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 = truese 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