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.
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().
- Nomi dei ruoli. I ruoli canonici del database sono
aura_anon,aura_authenticatedeaura_service_role. Sui cluster gestiti, anche gli alias di gruppoanon,authenticatedeservice_rolevengono mappati a essi (nota cheBYPASSRLSrimane rigorosamente solo suaura_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 automaticamenteENABLEeFORCE ROW LEVEL SECURITY(a meno cheDISABLE ROW LEVEL SECURITYnon 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_anoneaura_authenticatednon 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 aaura_anonoaura_authenticatedsu 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()èNULLper la chiave pubblica e per una chiaveservice_role; restituisce un ID solo per un utente registrato. Utilizzato aura_authenticatedper 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.
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);
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).
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().
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:
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
SELECTcorrispondente restituisce[]con unmeta.hintche indica il ruolo e la policy da aggiungere.aura db raw "select * from posts" --as anonmostra ciò che vede un visitatore. - RLS disabilitato?
aura db table listcontrassegna 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 = trueviene 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