Naar de inhoud springen
Aurabase-logo
aurabasis

Beveiliging op rijniveau in de productie

Drie RLS-patronen die 95% van de gebruiksscenario's dekken: eigendom, multi-tenant, hiërarchische organisatie. Met pg_prove en debug-tests.

Handleiding12 min lezenNiveau gevorderdHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Wat is RLS#

Row-Level Security is een native PostgreSQL-functie die geretourneerde (of geaccepteerde) rijen direct filtert door een SQL-expressie te evalueren die mogelijk afhankelijk is van de huidige rol en JWT-claims. Aurabase injecteert gebruikersclaims via request.jwt.claims en stelt helpers auth.uid(), auth.role(), auth.tenant(), auth.has_role() bloot.

Drie dingen die u moet weten voordat u een beleid schrijft
  • Rolnamen. De canonieke databaserollen zijn aura_anon, aura_authenticated en aura_service_role. Op beheerde clusters worden groepsaliassen anon, authenticated en service_role ook aan hen toegewezen (houd er rekening mee dat BYPASSRLS alleen op aura_service_role blijft).
  • RLS is standaard ingeschakeld voor tabellen die zijn gemaakt via Aurabase. Elke tabel die is gemaakt met /raw, een migratie-, Studio- of de tabel-API ontvangt automatisch ENABLE en FORCE ROW LEVEL SECURITY (tenzij DISABLE ROW LEVEL SECURITY expliciet wordt uitgevoerd in dezelfde DDL-batch): publieke/anon-query's retourneren [] totdat u een beleid toevoegt. Tabellen die zijn gemaakt via een directe PostgreSQL-verbinding (psql, Prisma, Drizzle) passeren nooit die hook, dus krijgen ze nee RLS en in plaats daarvan geen toegang voor de openbare sleutels: aura_anon en aura_authenticated hebben er geen rechten op totdat u gun het. Om een ​​dergelijke tabel beschikbaar te maken voor de SDK, schakelt u eerst RLS in en verleent u vervolgens een beleid en voegt u dit toe: ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... Verleen nooit aura_anon of aura_authenticated aan een tafel waarvan RLS is uitgeschakeld: elke houder van de publieke sleutel, of elke aangemelde gebruiker, zou alle rijen lezen (en, met schrijfrechten, wijzigen).
  • De publieke sleutel heeft geen gebruiker. auth.uid() is NULL voor de openbare sleutel en voor een service_role sleutel; het retourneert alleen een ID voor een ingelogde gebruiker. Gebruik to aura_authenticated om een ​​beleid te beperken tot ingelogde gebruikers.

Eigendom — elke gebruiker zijn eigen lijnen#

Gebruiksscenario's: profielen, notities, berichten waarbij elke regel toebehoort aan een unieke gebruiker via user_id of 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);
Tip

Combineer for all met using + with check om SELECT/UPDATE/DELETE in één beleid af te dekken. De INSERT gebruikt alleen with check.

Multi-tenant — bereik per organisatie#

Gebruiksvoorbeeld: B2B SaaS waarbij elke gebruiker tot een organisatie behoort en alle gegevens van zijn organisatie ziet. De JWT draagt ​​app_metadata.tenant, die de auth.tenant() helper retourneert (NULL indien afwezig of geen UUID, dus het beleid ontkent).

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

-- Onmisbare index voor prestaties
create index idx_orders_tenant on orders(tenant_id);

Hiërarchische organisatie — machtigingen per rol#

Gebruiksvoorbeeld: SaaS waarbij de rollen in een organisatie (beheerder, lid, kijker) verschillende machtigingen hebben. We combineren auth.tenant() met 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 — één bewering per beleid#

Test uw beleid — als echte gebruiker, in CI

Beleid is code, dus test het. aura db raw ... --as authenticated --user <uuid> voert de SQL uit binnen PostgreSQL met auth.uid() en auth.role() ingesteld voor die gebruiker (voeg --dry-run toe om schrijfbewerkingen terug te draaien), dus het antwoord is precies wat uw app zal zien:

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 mag de post van Alice niet zien
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alice moet het zien
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Een bezoeker ziet niets
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

Voer het uit in CI na aura db push. De RLS simulator van Studio (Database › een tabel › RLS simulator) voert dezelfde controle uit in een teruggedraaide PostgreSQL transactie en vermeldt dit naast het resultaat; pgTAP en pg_prove hebben een directe PostgreSQL-verbinding nodig, die niet bij elke implementatie wordt gepubliceerd.

Als het beleid niet doet wat jij wilt#

  • Leeg resultaat? Een anonieme of ingelogde lezing van een tabel met RLS en geen overeenkomend SELECT beleid retourneert [] met een meta.hint die de rol en het toe te voegen beleid benoemt. aura db raw "select * from posts" --as anon laat zien wat een bezoeker ziet.
  • RLS uitgeschakeld? aura db table list markeert tabellen met [RLS], en de Adviseur waarschuwt voor tabellen met RLS uitgeschakeld en tabellen met RLS maar geen beleid. Als u RLS uitschakelt (aura db table rls posts off), wordt de tabel leesbaar voor iedereen die over de openbare sleutel beschikt.
  • Weergaven. Een weergave leest met de rechten van de lezer (security_invoker = true wordt toegepast op elke weergave die u maakt), dus het beleid van de bijbehorende tabellen is van toepassing.
  • Beleid dat optelt: meerdere beleidsregels in dezelfde tabel + bewerking + rol worden gecombineerd in OR. Beperk indien nodig met AND in één beleid
  • Ontbrekende GRANT-machtigingen: zelfs met beleid moet de rol grant select on posts to aura_authenticated hebben
  • Claims niet geïnjecteerd: van Postgres, select current_setting('request.jwt.claims', true) — null betekent dat u zich in directe DB bevindt, niet via de gateway

Om verder te gaan#