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.
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.
- Rollennamen. Die kanonischen Datenbankrollen sind
aura_anon,aura_authenticatedundaura_service_role. Auf verwalteten Clustern werden ihnen auch die Gruppenaliaseanon,authenticatedundservice_rolezugeordnet (beachten Sie, dassBYPASSRLSausschließlich aufaura_service_rolebeschrä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 automatischENABLEundFORCE ROW LEVEL SECURITY(es sei denn,DISABLE ROW LEVEL SECURITYwird 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_anonundaura_authenticatedhaben 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 niemalsaura_anonoderaura_authenticatedfü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()istNULLfür den öffentlichen Schlüssel und für einenservice_role-Schlüssel; Es gibt nur eine ID für einen angemeldeten Benutzer zurück. Verwenden Sieto 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.
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);
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).
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().
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:
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 einemmeta.hintzurück, das die Rolle und die hinzuzufügende Richtlinie benennt.aura db raw "select * from posts" --as anonzeigt, was ein Besucher sieht. - RLS deaktiviert?
aura db table listmarkiert 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 = truewird 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_authenticatedhaben - 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