Vai al contenuto
Logo Aurabase
aurabase

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.

Spiegazione9 min lettoLivello avanzatoRevisionato il 15 apr 2026

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

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.

Informazioni

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.

fluxtext
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#

RuoloReclamiDescrizione
anonNo user_idRichieste effettuate con chiave anon e senza utente firmato JWT
authenticatedauth.uid() è l'utenteUn utente che ha effettuato l'accesso con un JWT valido, da qualsiasi sessione Aurabase
service_roleBypassa RLSChiave 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.

migrations/posts_rls.sqlsql
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);
Suggerimento

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.

policies/admin.sqlsql
-- 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.

Informazioni

Esportazione automatica nel tuo SIEM (Splunk, Datadog, Elastic) tramite webhook o flusso Kafka. Vedi /docs/compliance per gli schemi dettagliati degli eventi.

Per andare oltre#