Zum Inhalt springen
Aurabase-Logo
Aurabasis

Sicherheit auf Zeilenebene in der Produktion

Drei RLS-Muster decken 95 % der Anwendungsfälle ab: Eigentum, Mehrmandantenfähigkeit, hierarchische Organisation. Mit pg_prove und Debug-Tests.

Anleitung12 Min. gelesenEbene fortgeschrittenÜberarbeitet am 15.04.2026

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

Was ist RLS#

Sicherheit auf Zeilenebene ist eine native PostgreSQL-Funktion, die zurückgegebene (oder akzeptierte) Zeilen im Handumdrehen filtert, indem sie einen SQL-Ausdruck auswertet, der von der aktuellen Rolle und JWT-Ansprüchen abhängen kann. Aurabase fügt Benutzeransprüche über request.jwt.claims ein und macht Helfer auth.uid(), auth.role(), auth.tenant(), auth.has_role() verfügbar.

Drei Dinge, die Sie wissen sollten, bevor Sie eine Police schreiben
  • Rollennamen. Die kanonischen Datenbankrollen sind aura_anon, aura_authenticated und aura_service_role. Auf verwalteten Clustern werden ihnen auch die Gruppenaliase anon, authenticated und service_role zugeordnet (beachten Sie, dass BYPASSRLS ausschließlich auf aura_service_role beschränkt bleibt).
  • RLS ist standardmäßig für Tabellen aktiviert, die über Aurabase erstellt wurden. Jede Tabelle, die mit /raw, einer Migration, Studio oder der Tabellen-API erstellt wurde, empfängt automatisch ENABLE und FORCE ROW LEVEL SECURITY (es sei denn, DISABLE ROW LEVEL SECURITY wird explizit im selben DDL-Batch ausgeführt): Öffentliche/anon-Abfragen geben [] zurück, bis Sie eine Richtlinie hinzufügen. Tabellen, die über eine direkte PostgreSQL-Verbindung (psql, Prisma, Drizzle) erstellt wurden, passieren diesen Hook nie, daher erhalten sie kein RLS und stattdessen keinen Zugriff für die öffentlichen Schlüssel: aura_anon und aura_authenticated haben bis dahin keine Privilegien für sie du gewährst es. Um eine solche Tabelle für das SDK verfügbar zu machen, aktivieren Sie zuerst RLS, gewähren Sie dann eine Richtlinie und fügen Sie sie hinzu: ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Gewähren Sie niemals aura_anon oder aura_authenticated für eine Tabelle, deren RLS deaktiviert ist: Jeder Inhaber des öffentlichen Schlüssels oder jeder angemeldete Benutzer würde alle Zeilen lesen (und mit Schreibberechtigungen ändern).
  • Der öffentliche Schlüssel hat keinen Benutzer. auth.uid() ist NULL für den öffentlichen Schlüssel und für einen service_role-Schlüssel; Es gibt nur eine ID für einen angemeldeten Benutzer zurück. Verwenden Sie to aura_authenticated, um eine Richtlinie auf angemeldete Benutzer zu beschränken.

Eigentum – jeder Benutzer hat seine eigenen Leitungen#

Anwendungsfälle: Profile, Notizen, Beiträge, bei denen jede Zeile über user_id oder author_id einem eindeutigen Benutzer gehört.

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

create policy "posts_own_read" on posts
  for select to aura_authenticated
  using (auth.uid() = author_id);

create policy "posts_own_write" on posts
  for all to aura_authenticated
  using (auth.uid() = author_id)
  with check (auth.uid() = author_id);
Tipp

Kombinieren Sie for all mit using + with check, um SELECT/UPDATE/DELETE in einer Richtlinie abzudecken. Das INSERT verwendet nur with check.

Mandantenfähig – Umfang nach Organisation#

Anwendungsfall: B2B-SaaS, bei dem jeder Benutzer einer Organisation angehört und alle Daten seiner Organisation sieht. Der JWT trägt app_metadata.tenant, den der auth.tenant()-Helfer zurückgibt (NULL wenn keine UUID vorhanden ist oder nicht, was die Richtlinie ablehnt).

migrations/tenant_rls.sqlsql
create policy "orders_tenant_scope" on orders
  for all to aura_authenticated
  using (tenant_id = auth.tenant())
  with check (tenant_id = auth.tenant());

-- Unverzichtbarer Index für Leistung
create index idx_orders_tenant on orders(tenant_id);

Hierarchische Organisation – Berechtigungen nach Rolle#

Anwendungsfall: SaaS, bei dem die Rollen in einer Organisation (Administrator, Mitglied, Betrachter) unterschiedliche Berechtigungen haben. Wir kombinieren auth.tenant() mit auth.has_role().

migrations/org_rls.sqlsql
create policy "invoices_read" on invoices
  for select to aura_authenticated
  using (
    tenant_id = auth.tenant()
    and (auth.has_role('admin') or auth.has_role('billing'))
  );

create policy "invoices_write" on invoices
  for all to aura_authenticated
  using (tenant_id = auth.tenant() and auth.has_role('admin'))
  with check (tenant_id = auth.tenant());

pg_prove – eine Behauptung pro Richtlinie#

Testen Sie Ihre Richtlinien – als echter Benutzer, in CI

Richtlinien sind Code, also testen Sie sie. aura db raw ... --as authenticated --user <uuid> führt die SQL in PostgreSQL aus, wobei auth.uid() und auth.role() für diesen Benutzer festgelegt sind (fügen Sie --dry-run hinzu, um Schreibvorgänge rückgängig zu machen), sodass die Antwort genau das ist, was Ihre App sehen wird:

tests/rls.shbash
set -euo pipefail
ALICE=$(aura auth users create --email alice@example.com --password 'Passw0rd!long1' --json | jq -r .id)
BOB=$(aura auth users create --email bob@example.com --password 'Passw0rd!long1' --json | jq -r .id)

aura db raw "insert into posts(author_id, title) values ('$ALICE', 'hello')"
# Bob darf Alices Beitrag nicht sehen
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alice muss es sehen
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Ein Besucher sieht nichts
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

Führen Sie es in CI nach aura db push aus. Der RLS-Simulator von Studio (Datenbank › eine Tabelle › RLS-Simulator) führt die gleiche Prüfung innerhalb einer zurückgesetzten PostgreSQL-Transaktion durch und gibt dies neben dem Ergebnis an; pgTAP und pg_prove benötigen eine direkte PostgreSQL-Verbindung, die nicht bei jeder Bereitstellung veröffentlicht wird.

Wenn die Richtlinie nicht das tut, was Sie wollen#

  • Leeres Ergebnis? Ein anonymer oder angemeldeter Lesevorgang einer Tabelle mit RLS und keiner passenden SELECT-Richtlinie gibt [] mit einem meta.hint zurück, das die Rolle und die hinzuzufügende Richtlinie benennt. aura db raw "select * from posts" --as anon zeigt, was ein Besucher sieht.
  • RLS deaktiviert? aura db table list markiert Tabellen mit [RLS] und der Advisor warnt vor Tabellen mit deaktiviertem RLS und Tabellen mit RLS, aber ohne Richtlinie. Durch Deaktivieren von RLS (aura db table rls posts off) wird die Tabelle für jeden lesbar, der über den öffentlichen Schlüssel verfügt.
  • Aufrufe. Eine Ansicht liest mit den Berechtigungen des Lesers (security_invoker = true wird auf jede von Ihnen erstellte Ansicht angewendet), sodass die Richtlinien ihrer Tabellen gelten.
  • Richtlinien, die sich summieren: mehrere Richtlinien für dieselbe Tabelle + Operation + Rolle werden in ODER kombiniert. Bei Bedarf mit AND in einer einzelnen Richtlinie einschränken
  • Fehlende GRANT-Berechtigungen: Auch mit einer Richtlinie muss die Rolle grant select on posts to aura_authenticated haben
  • Ansprüche nicht injiziert: von Postgres, select current_setting('request.jwt.claims', true) – null bedeutet, dass Sie sich in der direkten Datenbank befinden, nicht über das Gateway

Um weiter zu gehen#