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.
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.
- Rolnamen. De canonieke databaserollen zijn
aura_anon,aura_authenticatedenaura_service_role. Op beheerde clusters worden groepsaliassenanon,authenticatedenservice_roleook aan hen toegewezen (houd er rekening mee datBYPASSRLSalleen opaura_service_roleblijft). - 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 automatischENABLEenFORCE ROW LEVEL SECURITY(tenzijDISABLE ROW LEVEL SECURITYexpliciet 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_anonenaura_authenticatedhebben 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 nooitaura_anonofaura_authenticatedaan 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()isNULLvoor de openbare sleutel en voor eenservice_rolesleutel; het retourneert alleen een ID voor een ingelogde gebruiker. Gebruikto aura_authenticatedom 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.
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);
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).
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().
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:
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
SELECTbeleid retourneert[]met eenmeta.hintdie de rol en het toe te voegen beleid benoemt.aura db raw "select * from posts" --as anonlaat zien wat een bezoeker ziet. - RLS uitgeschakeld?
aura db table listmarkeert 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 = truewordt 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_authenticatedhebben - 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