Aller au contenu
Logo Aurabase
aurabase

Sécurité au niveau des lignes en production

Trois modèles RLS couvrant 95 % des cas d'utilisation : propriété, multi-tenant, organisation hiérarchique. Avec pg_prove et tests de débogage.

Guide pratique12 min de lectureNiveau avancéRévisé le 15 avr. 2026

La source anglaise a changé depuis cette traduction. Certaines informations peuvent être en retard.
Cette page a été traduite automatiquement. La version anglaise fait foi.

Qu'est-ce que RLS#

La sécurité au niveau des lignes est une fonctionnalité native PostgreSQL qui filtre les lignes renvoyées (ou acceptées) à la volée, en évaluant une expression SQL qui peut dépendre du rôle actuel et des revendications JWT. Aurabase injecte les réclamations des utilisateurs via request.jwt.claims et expose les assistants auth.uid(), auth.role(), auth.tenant(), auth.has_role().

Trois choses à savoir avant de rédiger une politique
  • Noms de rôle. Les rôles canoniques de base de données sont aura_anon, aura_authenticated et aura_service_role. Sur les clusters gérés, les alias de groupe anon, authenticated et service_role leur correspondent également (notez que BYPASSRLS reste strictement sur aura_service_role seul).
  • RLS est activé par défaut pour les tables créées via Aurabase. Toute table créée avec /raw, une migration, Studio ou l'API de table reçoit automatiquement ENABLE et FORCE ROW LEVEL SECURITY (sauf si DISABLE ROW LEVEL SECURITY est explicitement exécuté dans le même lot DDL) : les requêtes publiques/anon renvoient [] jusqu'à ce que vous ajoutiez une stratégie. Les tables créées par une connexion directe PostgreSQL (psql, Prisma, Drizzle) ne passent jamais par ce hook : elles n'ont aucune RLS et, en contrepartie, aucun accès pour les clés publiques : aura_anon et aura_authenticated n'ont aucun privilège dessus tant que vous ne l'accordez pas. Pour exposer une telle table au SDK, activez d'abord RLS, puis accordez les droits et ajoutez une stratégie : ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... N'accordez jamais de droits à aura_anon ou aura_authenticated sur une table dont la RLS est désactivée : toute personne qui détient la clé publique, ou tout utilisateur inscrit, lirait (et, avec des droits d'écriture, modifierait) toutes ses lignes.
  • La clé publique n'a aucun utilisateur. auth.uid() est NULL pour la clé publique et pour une clé service_role ; il renvoie un identifiant uniquement pour un utilisateur connecté. Utilisez to aura_authenticated pour restreindre une stratégie aux utilisateurs connectés.

Propriété - chaque utilisateur a ses propres lignes#

Cas d'utilisation : profils, notes, publications où chaque ligne appartient à un utilisateur unique via user_id ou 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);
Astuce

Combinez for all avec using + with check pour couvrir SELECT/UPDATE/DELETE dans une seule police. L'INSERT utilise uniquement with check.

Multi-tenant – portée par organisation#

Cas d'utilisation : B2B SaaS où chaque utilisateur appartient à une organisation et voit toutes les données de son organisation. Le JWT porte app_metadata.tenant, que l'assistant auth.tenant() renvoie (NULL en cas d'absence ou s'il n'y a pas d'UUID, donc la politique refuse).

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());

-- Indice de performance indispensable
create index idx_orders_tenant on orders(tenant_id);

Organisation hiérarchique – autorisations par rôle#

Cas d'utilisation : SaaS où les rôles dans une organisation (administrateur, membre, spectateur) ont des autorisations différentes. Nous combinons auth.tenant() avec 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 — une assertion par politique#

Testez vos policies — en vrai utilisateur, en CI

Les policies sont du code : testez-les. aura db raw ... --as authenticated --user <uuid> exécute le SQL dans PostgreSQL avec auth.uid() et auth.role() positionnés pour cet utilisateur (ajoutez --dry-run pour annuler les écritures), de sorte que la réponse est exactement ce que verra votre application :

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 ne doit pas voir le post d'Alice
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alice doit le voir
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Un visiteur ne voit rien
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

Lancez-le en CI après aura db push. Le simulateur RLS du Studio (Database › une table › RLS simulator) exécute la même vérification dans une transaction PostgreSQL annulée et le précise à côté du résultat ; pgTAP et pg_prove exigent une connexion PostgreSQL directe, que tous les déploiements ne publient pas.

Quand la politique ne fait pas ce que tu veux#

  • Résultat vide ? La lecture, anonyme ou connectée, d'une table avec RLS et sans policy SELECT correspondante renvoie [] avec un meta.hint qui nomme le rôle et la policy à ajouter. aura db raw "select * from posts" --as anon montre ce que voit un visiteur.
  • RLS désactivée ? aura db table list marque les tables avec [RLS], et l'Advisor signale les tables dont la RLS est désactivée ainsi que celles qui ont la RLS sans policy. Désactiver la RLS (aura db table rls posts off) rend la table lisible par quiconque détient la clé publique.
  • Vues. Une vue lit avec les privilèges du lecteur (security_invoker = true est appliqué à chaque vue que vous créez) : les policies de ses tables s'appliquent donc.
  • Politiques qui s'additionnent: plusieurs politiques sur la même table + opération + rôle se combinent en OR. Restreindre avec AND dans une seule stratégie si nécessaire
  • Permissions GRANT manquantes: même avec une politique, le rôle doit avoir grant select on posts to aura_authenticated
  • Revendications non injectées: depuis Postgres, select current_setting('request.jwt.claims', true) — null signifie que vous êtes en base de données directe, pas via la passerelle

Pour aller plus loin#