Sécurité & RBAC
Row-Level Security natif Postgres, rôles prédéfinis, RBAC multi-tenant, audit logs. Vos règles vivent dans la base — testables, versionnées, impossibles à contourner côté client.
La sécurité vit dans la base#
Aurabase utilise le Row-Level Security (RLS) natif de PostgreSQL. Cela signifie que vos règles d'accès sont écrites en SQL, stockées dans la base, appliquées à chaque requête — y compris celles faites par le SDK, PostgREST, ou psql direct.
Sur un projet MongoDB, il n'y a pas de RLS. L'isolation y est assurée par un champ réservé _owner_id : toute lecture d'un rôle non privilégié est filtrée sur le sub du JWT, et toute écriture estampille ce champ. Trois conséquences à connaître avant de déboguer une liste vide : un document créé avec une clé service_role n'a aucun _owner_id et devient donc invisible à tous les utilisateurs authentifiés (réponse [] en HTTP 200, sans erreur) ; un appelant anon sans JWT reçoit un 403 sur une collection non publique ; et _owner_id, réservé, n'est jamais modifiable par le client. Une collection s'ouvre en lecture à tous par l'opt-in explicite public_read.
Contourner une policy est impossible côté client. Le gateway valide chaque JWT avant d'ouvrir une connexion Postgres avec le rôle approprié. Les claims (auth.uid(), auth.role(), auth.tenant()) sont injectés via request.jwt.claims — non modifiables depuis une requête SQL.
Les tables créées via Aurabase (Studio, API de tables, migrations ou /raw) reçoivent automatiquement ENABLE et FORCE ROW LEVEL SECURITY par défaut (sauf désactivation explicite en DDL). Vérifiez systématiquement RLS sur les tables créées via une connexion psql directe avec alter table ... enable row level security avant d'ajouter vos policies.
JWT → claims → policy → ligne#
Chaque requête suit le même chemin. Le gateway décode le JWT, vérifie sa signature (ES256 avec le secret dérivé du projet par défaut ; RS256 avec un JWKS seulement si une clé RSA est configurée), extrait les claims, ouvre une connexion Postgres avec SET LOCAL role + SET LOCAL request.jwt.claims. Toutes les policies qui référencent auth.*() utilisent ces claims.
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()
Trois rôles Postgres, hiérarchie claire#
RôleClaimsDescription
anon``Aucun user_idRequêtes avec la clé anon, sans JWT user signé
authenticated``auth.uid() = userUtilisateur signé avec JWT valide (toute session Aurabase)
service_role``Bypass RLSClé backend — passe toutes les policies. Serveur uniquement.
Cinq patterns essentiels#
Les policies sont attachées à une table + une opération (SELECT/INSERT/UPDATE/DELETE) + un rôle. Plusieurs policies sur la même paire sont combinées en OR. Utilisez using pour filtrer les lignes existantes, with check pour valider les nouvelles valeurs.
alter table posts enable row level security;
-- Lecture : auteur uniquement
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
Testez vos policies avec pg_prove. Un fichier rls_posts.sql par table, exécuté en CI à chaque migration. Voir le guide RLS.
Au-delà de anon / authenticated#
Les rôles applicatifs (admin, editor, viewer, billing…) vivent dans le tableau roles de l'app_metadata de l'utilisateur, que seul le serveur peut écrire (l'API admin PUT /admin/users/{id} avec une clé service_role, ou le hook de jeton d'accès). Chaque utilisateur peut avoir N rôles. Ils voyagent dans le token sous app_metadata.roles, et auth.has_role('admin') les lit dans vos policies. user_metadata n'accorde jamais un rôle : l'utilisateur peut le modifier lui-même. Ne les confondez ni avec le claim role du jeton (anon ou authenticated : le palier Postgres, lu par auth.role()), ni avec le champ role de l'utilisateur (une étiquette libre affichée dans le Studio, comme user ou editor) : aucun des deux n'accorde de rôle applicatif.
-- Admin voit tout
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- Billing voit les colonnes sensibles en vue dédiée
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
Trace complète, export SIEM#
Chaque événement sécurité est logué dans project_{uuid}_auth.auth_audit_log : signin, signout, password_change, mfa_enroll, role_granted, service_role_access, failed_auth. Rétention 30 jours sur Pro, 2 ans sur Enterprise.
Export automatique vers votre SIEM (Splunk, Datadog, Elastic) via webhook ou stream Kafka. Voir /docs/compliance pour les schémas d'événement détaillés.