Zum Inhalt springen
Aurabase-Logo
Aurabasis

Sicherheit und RBAC

Sicherheit auf Zeilenebene, nativ Postgres, vordefinierte Rollen, mandantenfähiges RBAC, Prüfprotokolle. Ihre Regeln befinden sich in der Datenbank – testbar, versioniert und auf Client-Seite nicht umgehbar.

Erklärung9 Min. gelesenEbene fortgeschrittenÜberarbeitet am 15.04.2026

Diese Seite wurde automatisch übersetzt. Maßgeblich ist die englische Version.

Die Sicherheit lebt in der Basis#

Aurabase verwendet die native Sicherheit auf Zeilenebene (RLS) von PostgreSQL. Das bedeutet, dass Ihre Zugriffsregeln in SQL geschrieben, in der Datenbank gespeichert und auf jede Anfrage angewendet werden – einschließlich derjenigen, die vom SDK, PostgREST oder direktem psql gestellt werden.

In einem MongoDB-Projekt gibt es kein RLS. Die Isolierung wird durch ein reserviertes Feld _owner_id sichergestellt: Jeder Lesevorgang einer nicht privilegierten Rolle wird auf sub des JWT gefiltert, und jeder Schreibvorgang stempelt dieses Feld. Drei Konsequenzen, die Sie beachten sollten, bevor Sie eine leere Liste debuggen: Ein mit einem service_role-Schlüssel erstelltes Dokument hat kein _owner_id und wird daher für alle authentifizierten Benutzer unsichtbar ([]-Antwort in HTTP 200, ohne Fehler); ein anon-Aufrufer ohne JWT erhält einen 403 für eine nicht öffentliche Sammlung; und _owner_id, reserviert, können vom Client niemals geändert werden. Durch das explizite Opt-in public_read wird eine Sammlung zum Lesen für alle geöffnet.

Eine Umgehung einer Richtlinie ist auf Kundenseite nicht möglich. Das Gateway validiert jedes JWT, bevor es eine Postgres-Verbindung mit der entsprechenden Rolle öffnet. Die Ansprüche (auth.uid(), auth.role(), auth.tenant()) werden über request.jwt.claims eingefügt – können nicht über eine SQL-Abfrage geändert werden.

Infos

Tabellen, die über Aurabase (Studio, Tabellen-API, Migrationen oder /raw) erstellt wurden, erhalten ENABLE und FORCE ROW LEVEL SECURITY standardmäßig automatisch (sofern in DDL nicht ausdrücklich deaktiviert). Überprüfen Sie immer RLS für Tabellen, die über eine direkte psql-Verbindung mit alter table ... enable row level security erstellt wurden, bevor Sie Richtlinien hinzufügen.

JWT → Ansprüche → Police → Zeile#

Jede Abfrage folgt demselben Pfad. Das Gateway dekodiert JWT, überprüft seine Signatur (ES256 standardmäßig mit dem vom Projekt abgeleiteten Geheimnis; RS256 mit einem JWKS nur, wenn ein RSA-Schlüssel konfiguriert ist), extrahiert die Ansprüche und öffnet eine Postgres-Verbindung mit SET LOCAL role + SET LOCAL request.jwt.claims. Alle Richtlinien, die auf auth.*() verweisen, verwenden diese Ansprüche.

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

Drei Postgres Rollen, klare Hierarchie#

RolleAnsprücheBeschreibung
anonNein user_idAnfragen mit dem anonymen Schlüssel und ohne signierten Benutzer JWT
authenticatedauth.uid() ist der BenutzerEin angemeldeter Benutzer mit einem gültigen JWT aus einer beliebigen Aurabase-Sitzung
service_roleUmgeht RLSBackend-Schlüssel, der jede Richtlinie übergibt. Nur Server.

Fünf wesentliche Muster#

Richtlinien werden an eine Tabelle + einen Vorgang (SELECT/INSERT/UPDATE/DELETE) + eine Rolle angehängt. Mehrere Richtlinien für dasselbe Paar werden in OR kombiniert. Verwenden Sie using, um vorhandene Zeilen zu filtern, und with check, um neue Werte zu validieren.

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

-- Lektüre: nur Autor
create policy "posts_own_read"
  on posts for select
  to aura_authenticated
  using (auth.uid() = author_id);
Tipp

Testen Sie Ihre Richtlinien mit pg_prove. Eine rls_posts.sql-Datei pro Tabelle, die bei jeder Migration in CI ausgeführt wird. Siehe die Anleitung RLS.

Mehr als anonym/authentifiziert#

Die Anwendungsrollen (Administrator, Editor, Betrachter, Abrechnung usw.) befinden sich im roles-Array des app_metadata des Benutzers, das nur der Server schreiben kann (die Admin-API PUT /admin/users/{id} mit einem service_role-Schlüssel oder der Access-Token-Hook). Jeder Benutzer kann N Rollen haben. Sie reisen im Token unter app_metadata.roles und auth.has_role('admin') liest sie in Ihren Richtlinien. user_metadata gewährt niemals eine Rolle: Benutzer können sie selbst bearbeiten. Verwechseln Sie sie nicht mit dem role-Anspruch des Tokens (anon oder authenticated: die Postgres-Stufe, gelesen von auth.role()) oder mit dem role-Feld des Benutzers (eine kostenlose Bezeichnung, die im Studio angezeigt wird, z. B. user oder editor): Keines davon gewährt eine Anwendungsrolle.

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

-- Die Abrechnung erkennt vertrauliche Spalten in der dedizierten Ansicht
create view posts_billing as
  select id, author_id, revenue_cents from posts
  where auth.has_role('billing');

Kompletter Trace, SIEM-Export#

Jedes Sicherheitsereignis wird in project_{uuid}_auth.auth_audit_log protokolliert: signin, signout, password_change, mfa_enroll, role_granted, service_role_access, failed_auth. 30-tägige Aufbewahrung bei Pro, 2 Jahre bei Enterprise.

Infos

Automatischer Export in Ihr SIEM (Splunk, Datadog, Elastic) über Webhook oder Kafka-Stream. Detaillierte Ereignisschemata finden Sie unter /docs/compliance.

Um weiter zu gehen#