Zabezpieczenia na poziomie wiersza w produkcji
Trzy wzorce RLS obejmujące 95% przypadków użycia: własność, wielu dzierżawców, organizacja hierarchiczna. Z testami pg_prove i debugowania.
Co to jest RLS#
Zabezpieczenia na poziomie wiersza to natywna funkcja PostgreSQL, która filtruje zwrócone (lub zaakceptowane) wiersze na bieżąco, oceniając wyrażenie SQL, które może zależeć od bieżącej roli i roszczeń JWT. Aurabase wprowadza oświadczenia użytkowników poprzez request.jwt.claims i udostępnia pomocników auth.uid(), auth.role(), auth.tenant(), auth.has_role().
- Nazwy ról. Kanoniczne role bazy danych to
aura_anon,aura_authenticatediaura_service_role. W zarządzanych klastrach aliasy grupanon,authenticatediservice_rolerównież są na nie mapowane (należy pamiętać, żeBYPASSRLSpozostaje wyłącznie naaura_service_role). - RLS jest domyślnie włączone dla tabel utworzonych za pomocą Aurabase. Dowolna tabela utworzona za pomocą
/raw, migracji, Studio lub interfejsu API tabeli automatycznie otrzymujeENABLEiFORCE ROW LEVEL SECURITY(chyba żeDISABLE ROW LEVEL SECURITYjest jawnie wykonywane w tej samej partii DDL): zapytania publiczne/anon zwracają[]do czasu dodania polityki. Tabele utworzone przez bezpośrednie połączenie PostgreSQL (psql, Prisma, Drizzle) nigdy nie przechodzą przez ten hak, więc otrzymują nie RLS i zamiast tego nie mają dostępu do kluczy publicznych:aura_anoniaura_authenticatednie mają do nich żadnych uprawnień, dopóki nie przyznaj to. Aby udostępnić taką tabelę zestawowi SDK, włącz najpierw RLS, a następnie przyznaj i dodaj politykę:ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Nigdy nie udzielajaura_anonlubaura_authenticatedw tabeli, której RLS jest wyłączone: każdy posiadacz klucza publicznego lub każdy zarejestrowany użytkownik przeczytałby (i, z uprawnieniami do zapisu, zmodyfikował) wszystkie jej wiersze. - Klucz publiczny nie ma użytkownika.
auth.uid()toNULLdla klucza publicznego i dla kluczaservice_role; zwraca identyfikator tylko dla zalogowanego użytkownika. Użyjto aura_authenticated, aby ograniczyć politykę do zalogowanych użytkowników.
Własność — każdy użytkownik ma własne linie#
Przypadki użycia: profile, notatki, posty, w których każda linia należy do unikalnego użytkownika za pośrednictwem user_id lub author_id.
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);
Połącz for all z using + with check, aby uwzględnić opcję WYBIERZ/AKTUALIZUJ/USUŃ w jednej polityce. INSERT używa tylko with check.
Wielu dzierżawców — zakres według organizacji#
Przykład użycia: B2B SaaS, w którym każdy użytkownik należy do organizacji i widzi wszystkie dane swojej organizacji. JWT przenosi app_metadata.tenant, który pomocnik auth.tenant() zwraca (NULL w przypadku braku identyfikatora UUID lub jego braku, więc zasada zaprzecza).
create policy "orders_tenant_scope" on orders
for all to aura_authenticated
using (tenant_id = auth.tenant())
with check (tenant_id = auth.tenant());
-- Niezbędny wskaźnik wydajności
create index idx_orders_tenant on orders(tenant_id);
Organizacja hierarchiczna — uprawnienia według roli#
Przykład użycia: SaaS, w którym role w organizacji (administrator, członek, przeglądający) mają różne uprawnienia. Łączymy auth.tenant() z 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 — jedna asercja na politykę#
Przetestuj swoje zasady — jako prawdziwy użytkownik w CI
Zasady są kodem, więc przetestuj je. aura db raw ... --as authenticated --user <uuid> uruchamia SQL wewnątrz PostgreSQL z ustawionymi auth.uid() i auth.role() dla tego użytkownika (dodaj --dry-run, aby cofnąć zapisywanie), więc odpowiedzią jest dokładnie to, co zobaczy Twoja aplikacja:
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 nie może widzieć postu Alice
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alicja musi to zobaczyć
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Gość nic nie widzi
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"
Uruchom go w CI po aura db push. Symulator RLS programu Studio (baza danych › tabela › symulator RLS) przeprowadza tę samą kontrolę w ramach wycofanej transakcji PostgreSQL i informuje o tym obok wyniku; pgTAP i pg_prove wymagają bezpośredniego połączenia PostgreSQL, które nie jest publikowane w każdym wdrożeniu.
Kiedy polityka nie robi tego, czego chcesz#
- Pusty wynik? Anonimowy lub zalogowany odczyt tabeli z RLS i bez pasującej zasady
SELECTzwraca[]zmeta.hint, który określa rolę i zasadę do dodania.aura db raw "select * from posts" --as anonpokazuje, co widzi odwiedzający. - RLS wyłączone?
aura db table listoznacza tabele za pomocą[RLS], a doradca ostrzega o tabelach z wyłączonym RLS i tabelach z RLS, ale bez zasad. Wyłączenie RLS (aura db table rls posts off) powoduje, że tabela będzie czytelna dla każdego, kto posiada klucz publiczny. - Wyświetleń. Widok odczytuje z uprawnieniami czytelnika (
security_invoker = truejest stosowany do każdego utworzonego widoku), więc obowiązują zasady jego tabel. - Polityki, które się sumują: wiele polityk w tej samej tabeli + operacja + rola łączą się w OR. Jeśli to konieczne, ogranicz za pomocą AND w jednej zasadzie
- Brak uprawnień GRANT: nawet w przypadku polityki rola musi mieć
grant select on posts to aura_authenticated - Oświadczenia nie zostały wprowadzone: z Postgres,
select current_setting('request.jwt.claims', true)— wartość null oznacza, że jesteś w bezpośrednim DB, a nie przez bramę