Naar de inhoud springen
Aurabase-logo
aurabasis

Beveiliging en RBAC

Beveiliging op rijniveau native Postgres, vooraf gedefinieerde rollen, RBAC voor meerdere tenants, auditlogboeken. Uw regels bevinden zich in de database: testbaar, voorzien van versiebeheer, onmogelijk te omzeilen aan de clientzijde.

Uitleg9 min lezenNiveau gevorderdHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

De beveiliging woont in de basis#

Aurabase maakt gebruik van PostgreSQL's eigen Beveiliging op rijniveau (RLS). Dit betekent dat uw toegangsregels zijn geschreven in SQL, zijn opgeslagen in de database en zijn toegepast op elk verzoek, inclusief verzoeken die zijn gedaan door de SDK, PostgREST of direct psql.

In een MongoDB-project is er geen RLS. Isolatie wordt verzekerd door een gereserveerd veld _owner_id: elke lezing van een niet-bevoorrechte rol wordt gefilterd op de sub van de JWT, en elk schrijven stempelt dit veld. Drie gevolgen waar u rekening mee moet houden voordat u fouten in een lege lijst gaat opsporen: een document dat is gemaakt met een sleutel service_role heeft geen _owner_id en wordt daarom onzichtbaar voor alle geauthenticeerde gebruikers (antwoord [] in HTTP 200, zonder fouten); een anon-beller zonder JWT ontvangt een 403 op een niet-openbare collectie; en _owner_id, voorbehouden, kunnen nooit door de klant worden gewijzigd. Een verzameling wordt voor iedereen geopend door de expliciete opt-in public_read.

Aan de kant van de klant is het omzeilen van een beleid onmogelijk. De gateway valideert elke JWT voordat een Postgres-verbinding met de juiste rol wordt geopend. De claims (auth.uid(), auth.role(), auth.tenant()) worden geïnjecteerd via request.jwt.claims - kunnen niet worden gewijzigd vanuit een SQL-query.

Info

Tabellen die zijn gemaakt via Aurabase (Studio, tabel-API, migraties of /raw) krijgen standaard automatisch ENABLE en FORCE ROW LEVEL SECURITY (tenzij expliciet uitgeschakeld in DDL). Controleer altijd RLS op tabellen die zijn gemaakt via een directe psql-verbinding met alter table ... enable row level security voordat u beleid toevoegt.

JWT → claims → polis → regel#

Elke query volgt hetzelfde pad. De gateway decodeert de JWT, verifieert de handtekening (ES256 standaard met het project-afgeleide geheim; RS256 alleen met een JWKS wanneer een RSA-sleutel is geconfigureerd), extraheert de claims en opent een Postgres-verbinding met SET LOCAL role + SET LOCAL request.jwt.claims. Al het beleid dat verwijst naar auth.*() gebruikt deze claims.

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()

Drie Postgres rollen, duidelijke hiërarchie#

RolClaimsBeschrijving
anonNee user_idVerzoeken gedaan met de anon-sleutel en geen ondertekende gebruiker JWT
authenticatedauth.uid() is de gebruikerEen aangemelde gebruiker met een geldige JWT, uit een Aurabase-sessie
service_roleOmzeilt RLSBackend-sleutel die elk beleid doorstaat. Alleen server.

Vijf essentiële patronen#

Beleid is gekoppeld aan een tabel + een bewerking (SELECT/INSERT/UPDATE/DELETE) + een rol. Meerdere beleidsregels voor hetzelfde paar worden gecombineerd in OR. Gebruik using om bestaande rijen te filteren, with check om nieuwe waarden te valideren.

migrations/posts_rls.sqlsql
alter table posts enable row level security;

-- Lezen: alleen auteur
create policy "posts_own_read"
  on posts for select
  to aura_authenticated
  using (auth.uid() = author_id);
Tip

Test uw beleid met pg_prove. Eén rls_posts.sql-bestand per tabel, uitgevoerd in CI bij elke migratie. Zie de RLS handleiding.

Verder dan anoniem/geauthenticeerd#

De applicatierollen (admin, editor, viewer, facturering, etc.) bevinden zich in de roles array van de app_metadata van de gebruiker, die alleen de server kan schrijven (de admin API PUT /admin/users/{id} met een service_role sleutel, of de access-token hook). Elke gebruiker kan N rollen hebben. Ze reizen in het token onder app_metadata.roles en auth.has_role('admin') leest ze in uw beleid. user_metadata kent nooit een rol toe: gebruikers kunnen deze zelf bewerken. Verwar ze niet met de role claim van het token (anon of authenticated: de Postgres laag, gelezen door auth.role()) noch met het role veld van de gebruiker (een gratis label dat in Studio wordt weergegeven, zoals user of editor): geen van deze kent een applicatierol toe.

policies/admin.sqlsql
-- De beheerder ziet alles
create policy "posts_admin_read"
  on posts for select
  to aura_authenticated
  using (auth.has_role('admin'));

-- Facturering ziet gevoelige kolommen in een speciale weergave
create view posts_billing as
  select id, author_id, revenue_cents from posts
  where auth.has_role('billing');

Volledige tracering, SIEM-export#

Elke beveiligingsgebeurtenis wordt geregistreerd in project_{uuid}_auth.auth_audit_log: aanmelden, afmelden, wachtwoord wijzigen, mfa_enroll, rol toegekend, service_role_access, mislukte_auth. Retentie van 30 dagen op Pro, 2 jaar op Enterprise.

Info

Automatische export naar uw SIEM (Splunk, Datadog, Elastic) via webhook of Kafka-stream. Zie /docs/compliance voor gedetailleerde gebeurtenisschema's.

Om verder te gaan#