Sicurezza e RBAC
Sicurezza a livello di riga nativa Postgres, ruoli predefiniti, RBAC multi-tenant, log di controllo. Le tue regole risiedono nel database: testabili, con versione, impossibili da aggirare sul lato client.
La sicurezza vive nella base#
Aurabase utilizza la sicurezza a livello di riga nativa di PostgreSQL(RLS). Ciò significa che le tue regole di accesso sono scritte in SQL, archiviate nel database, applicate a ogni richiesta, comprese quelle effettuate dall'SDK, PostgREST o psql diretto.
In un progetto MongoDB, non esiste RLS. L'isolamento è assicurato da un campo riservato _owner_id: ogni lettura di un ruolo non privilegiato viene filtrata sull' sub dell' JWT, ed ogni scrittura timbra questo campo. Tre conseguenze da tenere presente prima di eseguire il debug di una lista vuota: un documento creato con una chiave service_role non ha nessun _owner_id e quindi diventa invisibile a tutti gli utenti autenticati (risposta [] in HTTP 200, senza errori); un chiamante anon senza JWT riceve un 403 su una raccolta non pubblica; e _owner_id, riservato, non può mai essere modificato dal client. Una raccolta viene aperta per la lettura a tutti tramite l'esplicito consenso esplicito public_read.
Eludere una policy è impossibile sul lato client. Il gateway convalida ogni JWT prima di aprire una connessione Postgres con il ruolo appropriato. Le attestazioni (auth.uid(), auth.role(), auth.tenant()) vengono inserite tramite request.jwt.claims e non possono essere modificate da una query SQL.
Le tabelle create tramite Aurabase (Studio, API tabella, migrazioni o /raw) ottengono ENABLE e FORCE ROW LEVEL SECURITY automaticamente per impostazione predefinita (a meno che non siano esplicitamente disabilitate in DDL). Verifica sempre RLS sulle tabelle create tramite una connessione diretta psql con alter table ... enable row level security prima di aggiungere policy.
JWT → sinistri → polizza → linea#
Ogni query segue lo stesso percorso. Il gateway decodifica JWT, ne verifica la firma (ES256 con il segreto derivato dal progetto per impostazione predefinita; RS256 con un JWKS solo quando è configurata una chiave RSA), estrae le attestazioni, apre una connessione Postgres con SET LOCAL role + SET LOCAL request.jwt.claims. Tutte le policy che fanno riferimento a auth.*() utilizzano queste affermazioni.
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()
Tre ruoli Postgres, gerarchia chiara#
| Ruolo | Reclami | Descrizione |
|---|---|---|
anon | No user_id | Richieste effettuate con chiave anon e senza utente firmato JWT |
authenticated | auth.uid() è l'utente | Un utente che ha effettuato l'accesso con un JWT valido, da qualsiasi sessione Aurabase |
service_role | Bypassa RLS | Chiave backend che passa ogni policy. Solo server. |
Cinque modelli essenziali#
Le policy sono allegate a una tabella + un'operazione (SELECT/INSERT/UPDATE/DELETE) + un ruolo. Più policy sulla stessa coppia vengono combinate in OR. Utilizza using per filtrare le righe esistenti, with check per convalidare nuovi valori.
alter table posts enable row level security;
-- Lettura: solo autore
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
Metti alla prova le tue policy con pg_prove. Un file rls_posts.sql per tabella, eseguito in CI a ogni migrazione. Consulta la guida RLS.
Oltre anon/autenticato#
I ruoli dell'applicazione (amministratore, editor, visualizzatore, fatturazione, ecc.) risiedono nell'array roles dell'utente app_metadata, che solo il server può scrivere (l'API di amministrazione PUT /admin/users/{id} con una chiave service_role o l'hook del token di accesso). Ogni utente può avere N ruoli. Viaggiano nel token sotto app_metadata.roles e auth.has_role('admin') li legge nelle tue policy. user_metadata non concede mai un ruolo: gli utenti possono modificarlo da soli. Non confonderli con la dichiarazione role del token (anon o authenticated: il livello Postgres, letto da auth.role()) né con il campo role dell'utente (un'etichetta gratuita mostrata in Studio, come user o editor): nessuna di queste concessioni un ruolo applicativo.
-- L'amministratore vede tutto
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- La fatturazione vede le colonne sensibili nella vista dedicata
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
Traccia completa, esportazione SIEM#
Ogni evento di sicurezza viene registrato in project_{uuid}_auth.auth_audit_log: signin, signout, password_change, mfa_enroll, role_granted, service_role_access, fail_auth. Conservazione di 30 giorni su Pro, 2 anni su Enterprise.
Esportazione automatica nel tuo SIEM (Splunk, Datadog, Elastic) tramite webhook o flusso Kafka. Vedi /docs/compliance per gli schemi dettagliati degli eventi.