Saltar al contenido
Logotipo de Aurabase
aurabase

Seguridad y RBAC

Seguridad a nivel de fila nativa Postgres, roles predefinidos, RBAC multiinquilino, registros de auditoría. Sus reglas residen en la base de datos: comprobables, versionadas e imposibles de eludir en el lado del cliente.

Explicación9 min leerNivel avanzadoRevisado el 15 abr 2026

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

La seguridad vive en la base.#

Aurabase usa la seguridad de nivel de fila nativa de PostgreSQL(RLS). Esto significa que sus reglas de acceso están escritas en SQL, almacenadas en la base de datos y aplicadas a cada solicitud, incluidas las realizadas por el SDK, PostgREST o psql directo.

En un proyecto MongoDB, no existe RLS. El aislamiento está garantizado por un campo reservado _owner_id: cualquier lectura de un rol no privilegiado se filtra en el sub del JWT, y cualquier escritura sella este campo. Tres consecuencias a tener en cuenta antes de depurar una lista vacía: un documento creado con una clave service_role tiene no _owner_id y por lo tanto se vuelve invisible para todos los usuarios autenticados (respuesta [] en HTTP 200, sin error); una persona que llama anon sin un JWT recibe un 403 en una colección no pública; y _owner_id, reservado, nunca podrá ser modificado por el cliente. Se abre una colección para que todos puedan leerla mediante la suscripción explícita public_read.

Eludir una política es imposible por parte del cliente. La puerta de enlace valida cada JWT antes de abrir una conexión Postgres con el rol apropiado. Las reclamaciones (auth.uid(), auth.role(), auth.tenant()) se inyectan a través de request.jwt.claims y no se pueden modificar desde una consulta SQL.

Información

Las tablas creadas a través de Aurabase (Studio, API de tablas, migraciones o /raw) obtienen ENABLE y FORCE ROW LEVEL SECURITY automáticamente de forma predeterminada (a menos que se deshabiliten explícitamente en DDL). Verifique siempre RLS en tablas creadas a través de una conexión directa psql con alter table ... enable row level security antes de agregar políticas.

JWT → reclamos → póliza → línea#

Cada consulta sigue el mismo camino. La puerta de enlace decodifica el JWT, verifica su firma (ES256 con el secreto derivado del proyecto de forma predeterminada; RS256 con un JWKS solo cuando se configura una clave RSA), extrae las reclamaciones y abre una conexión Postgres con SET LOCAL role + SET LOCAL request.jwt.claims. Todas las políticas que hacen referencia a auth.*() utilizan estas afirmaciones.

fluxtext
Client  →  Gateway     verify JWT (ES256 via JWKS, project key)
           ↓           extract { sub, role, tenant, exp }
        Postgres      SET LOCAL role = authenticated
                      SET LOCAL request.jwt.claims = {...}
           ↓
        SELECT ... FROM posts WHERE ...
           ↓ (RLS injecte la policy USING)
        SELECT ... FROM posts WHERE author_id = auth.uid()

Tres roles Postgres, jerarquía clara#

RolReclamacionesDescripción
anonSin user_idSolicitudes realizadas con la clave anónima y sin usuario firmado JWT
authenticatedauth.uid() es el usuarioUn usuario que haya iniciado sesión con un JWT válido, de cualquier sesión Aurabase
service_roleOmite RLSClave de backend que aprueba todas las políticas. Sólo servidor.

Cinco patrones esenciales#

Las políticas se adjuntan a una tabla + una operación (SELECCIONAR/INSERTAR/ACTUALIZAR/ELIMINAR) + un rol. Se combinan varias pólizas del mismo par en OR. Utilice using para filtrar filas existentes, with check para validar nuevos valores.

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

-- Lectura: solo autor
create policy "posts_own_read"
  on posts for select
  to aura_authenticated
  using (auth.uid() = author_id);
Consejo

Pruebe sus políticas con pg_prove. Un archivo rls_posts.sql por tabla, ejecutado en CI en cada migración. Consulte la guía RLS.

Más allá de anónimo/autenticado#

Los roles de la aplicación (administrador, editor, visor, facturación, etc.) residen en la matriz roles del app_metadata del usuario, que solo el servidor puede escribir (la API de administrador PUT /admin/users/{id} con una clave service_role o el enlace del token de acceso). Cada usuario puede tener N roles. Viajan en el token bajo app_metadata.roles y auth.has_role('admin') los lee en sus pólizas. user_metadata nunca otorga un rol: los usuarios pueden editarlo ellos mismos. No los confunda con el reclamo role del token (anon o authenticated: el nivel Postgres, leído por auth.role()) ni con el campo role del usuario (una etiqueta gratuita que se muestra en Studio, como user o editor): ninguno de estos otorga un rol de aplicación.

policies/admin.sqlsql
-- El administrador ve todo
create policy "posts_admin_read"
  on posts for select
  to aura_authenticated
  using (auth.has_role('admin'));

-- Facturación ve columnas confidenciales en una vista dedicada
create view posts_billing as
  select id, author_id, revenue_cents from posts
  where auth.has_role('billing');

Seguimiento completo, exportación SIEM#

Cada evento de seguridad se registra en project_{uuid}_auth.auth_audit_log: inicio de sesión, cierre de sesión, cambio de contraseña, mfa_enroll, rol_granted, servicio_role_access, error_auth. Retención de 30 días en Pro, 2 años en Enterprise.

Información

Exportación automática a su SIEM (Splunk, Datadog, Elastic) a través de webhook o transmisión Kafka. Consulte /docs/compliance para obtener esquemas de eventos detallados.

para ir más lejos#