Vai al contenuto
Logo Aurabase
aurabase

Sicurezza a livello di riga nella produzione

Tre modelli RLS che coprono il 95% dei casi d'uso: proprietà, multi-tenant, organizzazione gerarchica. Con pg_prove e test di debug.

Guida pratica12 min lettoLivello avanzatoRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Cos'è RLS#

La sicurezza a livello di riga è una funzionalità nativa di PostgreSQL che filtra al volo le righe restituite (o accettate), valutando un'espressione SQL che può dipendere dal ruolo corrente e dalle attestazioni JWT. Aurabase inserisce le attestazioni dell'utente tramite request.jwt.claims ed espone gli helper auth.uid(), auth.role(), auth.tenant(), auth.has_role().

Tre cose da sapere prima di scrivere una polizza
  • Nomi dei ruoli. I ruoli canonici del database sono aura_anon, aura_authenticated e aura_service_role. Sui cluster gestiti, anche gli alias di gruppo anon, authenticated e service_role vengono mappati a essi (nota che BYPASSRLS rimane rigorosamente solo su aura_service_role).
  • RLS è attivo per impostazione predefinita per le tabelle create tramite Aurabase. Qualsiasi tabella creata con /raw, una migrazione, Studio o l'API della tabella riceve automaticamente ENABLE e FORCE ROW LEVEL SECURITY (a meno che DISABLE ROW LEVEL SECURITY non venga eseguito esplicitamente nello stesso batch DDL): le query pubbliche/anon restituiscono [] finché non aggiungi una policy. Le tabelle create su una connessione diretta PostgreSQL (psql, Prisma, Drizzle) non passano mai attraverso quell'hook, quindi non ottengono no RLS e, invece, nessun accesso per le chiavi pubbliche: aura_anon e aura_authenticated non ha alcun privilegio su di loro finché non lo concedi. Per esporre tale tabella all'SDK, abilitare prima RLS, quindi concedere e aggiungere una policy: ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Non concedere mai a aura_anon o aura_authenticated su una tabella il cui RLS è disattivato: ogni possessore della chiave pubblica, o ogni utente registrato, leggerebbe (e, con le autorizzazioni di scrittura, modificherebbe) tutte le sue righe.
  • La chiave pubblica non ha utente. auth.uid() è NULL per la chiave pubblica e per una chiave service_role; restituisce un ID solo per un utente registrato. Utilizza to aura_authenticated per limitare un criterio agli utenti che hanno effettuato l'accesso.

Proprietà: ogni utente ha le proprie linee#

Casi d'uso: profili, note, post in cui ogni riga appartiene a un utente univoco tramite user_id o 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);
Suggerimento

Combina for all con using + with check per coprire SELECT/UPDATE/DELETE in un unico criterio. L'INSERT utilizza solo with check.

Multi-tenant: ambito per organizzazione#

Caso d'uso: SaaS B2B in cui ogni utente appartiene a un'organizzazione e vede tutti i dati della propria organizzazione. JWT trasporta app_metadata.tenant, che restituisce l'helper auth.tenant() (NULL quando assente o non è un UUID, quindi la policy nega).

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 indispensabile per la prestazione
create index idx_orders_tenant on orders(tenant_id);

Organizzazione gerarchica: autorizzazioni per ruolo#

Caso d'uso: SaaS in cui i ruoli in un'organizzazione (amministratore, membro, visualizzatore) hanno autorizzazioni diverse. Combiniamo auth.tenant() con 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: un'asserzione per policy#

Metti alla prova le tue policy: come utente reale, in CI

Le policy sono codice, quindi testale. aura db raw ... --as authenticated --user <uuid> esegue l'SQL all'interno di PostgreSQL con auth.uid() e auth.role() impostati per quell'utente (aggiungi --dry-run per eseguire il rollback delle riscritture), quindi la risposta è esattamente ciò che vedrà la tua app:

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 non deve vedere il post di Alice
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alice deve vederlo
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Un visitatore non vede nulla
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

Eseguilo in CI dopo aura db push. Il simulatore RLS di Studio (Database › una tabella › RLS simulator) esegue lo stesso controllo all'interno di una transazione PostgreSQL rollback e lo indica accanto al risultato; pgTAP e pg_prove necessitano di una connessione diretta PostgreSQL, che non tutte le distribuzioni pubblicano.

Quando la politica non fa quello che vuoi#

  • Risultato vuoto? Una lettura anonima o con accesso registrato di una tabella con RLS e nessuna policy SELECT corrispondente restituisce [] con un meta.hint che indica il ruolo e la policy da aggiungere. aura db raw "select * from posts" --as anon mostra ciò che vede un visitatore.
  • RLS disabilitato? aura db table list contrassegna le tabelle con [RLS] e Advisor avvisa sulle tabelle con RLS disabilitato e sulle tabelle con RLS ma senza policy. La disattivazione di RLS (aura db table rls posts off) rende la tabella leggibile da chiunque possieda la chiave pubblica.
  • Visualizzazioni. Una vista legge con i privilegi del lettore (security_invoker = true viene applicato a ogni vista creata), quindi si applicano le politiche delle sue tabelle.
  • Policy che si sommano: più policy sulla stessa tabella + operazione + ruolo si combinano in OR. Se necessario, limitare con AND in un unico criterio
  • Autorizzazioni GRANT mancanti: anche con una policy, il ruolo deve avere grant select on posts to aura_authenticated
  • Claims non inseriti: da Postgres, select current_setting('request.jwt.claims', true) — null significa che sei nel DB diretto, non tramite il gateway

Per andare oltre#