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.
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.
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.
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#
| Rolle | Ansprüche | Beschreibung |
|---|---|---|
anon | Nein user_id | Anfragen mit dem anonymen Schlüssel und ohne signierten Benutzer JWT |
authenticated | auth.uid() ist der Benutzer | Ein angemeldeter Benutzer mit einem gültigen JWT aus einer beliebigen Aurabase-Sitzung |
service_role | Umgeht RLS | Backend-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.
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);
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.
-- 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.
Automatischer Export in Ihr SIEM (Splunk, Datadog, Elastic) über Webhook oder Kafka-Stream. Detaillierte Ereignisschemata finden Sie unter /docs/compliance.