Przejdź do treści
Logo Aurabase
aurabaza

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.

Przewodnik krok po kroku12 min przeczytanePoziom zaawansowanyZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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

Trzy rzeczy, które warto wiedzieć przed napisaniem polisy
  • Nazwy ról. Kanoniczne role bazy danych to aura_anon, aura_authenticated i aura_service_role. W zarządzanych klastrach aliasy grup anon, authenticated i service_role również są na nie mapowane (należy pamiętać, że BYPASSRLS pozostaje wyłącznie na aura_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 otrzymuje ENABLE i FORCE ROW LEVEL SECURITY (chyba że DISABLE ROW LEVEL SECURITY jest 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_anon i aura_authenticated nie 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 udzielaj aura_anon lub aura_authenticated w 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() to NULL dla klucza publicznego i dla klucza service_role; zwraca identyfikator tylko dla zalogowanego użytkownika. Użyj to 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.

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);
Wskazówka

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

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

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

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 — 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:

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 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 SELECT zwraca [] z meta.hint, który określa rolę i zasadę do dodania. aura db raw "select * from posts" --as anon pokazuje, co widzi odwiedzający.
  • RLS wyłączone? aura db table list oznacza 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 = true jest 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ę

Aby pójść dalej#