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.
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().
- Noms de rôle. Les rôles canoniques de base de données sont
aura_anon,aura_authenticatedetaura_service_role. Sur les clusters gérés, les alias de groupeanon,authenticatedetservice_roleleur correspondent également (notez queBYPASSRLSreste strictement suraura_service_roleseul). - 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 automatiquementENABLEetFORCE ROW LEVEL SECURITY(sauf siDISABLE ROW LEVEL SECURITYest 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_anonetaura_authenticatedn'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_anonouaura_authenticatedsur 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()estNULLpour la clé publique et pour une cléservice_role; il renvoie un identifiant uniquement pour un utilisateur connecté. Utilisezto aura_authenticatedpour 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.
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);
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).
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().
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 :
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
SELECTcorrespondante renvoie[]avec unmeta.hintqui nomme le rôle et la policy à ajouter.aura db raw "select * from posts" --as anonmontre ce que voit un visiteur. - RLS désactivée ?
aura db table listmarque 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 = trueest 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