Üretimde Satır Düzeyinde Güvenlik
Kullanım senaryolarının %95'ini kapsayan üç RLS modeli: sahiplik, çok kiracılı, hiyerarşik organizasyon. pg_prove ve hata ayıklama testleri ile.
RLS nedir?#
Satır Düzeyinde Güvenlik, geçerli role ve JWT taleplerine bağlı olabilecek bir SQL ifadesini değerlendirerek döndürülen (veya kabul edilen) satırları anında filtreleyen yerel bir PostgreSQL özelliğidir. Aurabase, request.jwt.claims aracılığıyla kullanıcı taleplerini enjekte eder ve auth.uid(), auth.role(), auth.tenant(), auth.has_role() yardımcılarını açığa çıkarır.
- Rol adları. Kurallı veritabanı rolleri
aura_anon,aura_authenticatedveaura_service_roleşeklindedir. Yönetilen kümelerde,anon,authenticatedveservice_rolegrup takma adları da bunlarla eşleşir (BYPASSRLSöğesinin kesinlikle yalnızcaaura_service_roleüzerinde kaldığını unutmayın). - RLS, Aurabase aracılığıyla oluşturulan tablolar için varsayılan olarak açıktır.
/raw, geçiş, Studio veya tablo API'si ile oluşturulan herhangi bir tablo otomatik olarakENABLEveFORCE ROW LEVEL SECURITYalır (DISABLE ROW LEVEL SECURITYaynı DDL toplu işleminde açıkça yürütülmediği sürece): genel/anon sorguları, siz bir politika ekleyene kadar[]değerini döndürür. Doğrudan PostgreSQL bağlantısı (psql, Prisma, Drizzle) üzerinden oluşturulan tablolar hiçbir zaman bu kancadan geçmez, dolayısıyla hayır RLS alırlar ve bunun yerine ortak anahtarlara erişim yoktur:aura_anonveaura_authenticatedsiz izin verene kadar onlar üzerinde hiçbir ayrıcalığa sahip değildir. Böyle bir tabloyu SDK'ya göstermek için önce RLS'yi etkinleştirin, ardından bir politika verin ve ekleyin:ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY .... RLS kapalı olan bir tabloda aslaaura_anonveyaaura_authenticated'ye izin vermeyin: genel anahtarın her sahibi veya kayıtlı her kullanıcı, tüm satırlarını okur (ve yazma izinleriyle değiştirir). - Genel anahtarın kullanıcısı yok.
auth.uid(), genel anahtar veservice_roleanahtarı içinNULL'dir; yalnızca oturum açmış bir kullanıcı için bir kimlik döndürür. Bir politikayı oturum açmış kullanıcılarla sınırlamak içinto aura_authenticatedkullanın.
Sahiplik — her kullanıcı kendi hattına sahiptir#
Kullanım durumları: her satırın user_id veya author_id aracılığıyla benzersiz bir kullanıcıya ait olduğu profiller, notlar, gönderiler.
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);
Tek bir ilkede SEÇ/GÜNCELLEME/SİL işlemlerini gerçekleştirmek için for all'yi using + with check ile birleştirin. INSERT yalnızca with check kullanır.
Çok kiracılı — kuruluşa göre kapsam#
Kullanım örneği: Her kullanıcının bir kuruluşa ait olduğu ve kuruluşunun tüm verilerini gördüğü B2B SaaS. JWT app_metadata.tenant öğesini taşır ve auth.tenant() yardımcısının döndürdüğü ( UUID olmadığında veya olmadığında NULL politika reddedilir).
create policy "orders_tenant_scope" on orders
for all to aura_authenticated
using (tenant_id = auth.tenant())
with check (tenant_id = auth.tenant());
-- Performans için vazgeçilmez indeks
create index idx_orders_tenant on orders(tenant_id);
Hiyerarşik kuruluş — role göre izinler#
Kullanım örneği: Bir kuruluştaki rollerin (yönetici, üye, görüntüleyici) farklı izinlere sahip olduğu SaaS. auth.tenant() ile auth.has_role()'yi birleştiriyoruz.
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 — politika başına bir iddia#
Politikalarınızı gerçek bir kullanıcı olarak CI'da test edin
Politikalar koddur, bu yüzden onları test edin. aura db raw ... --as authenticated --user <uuid>, SQL'i PostgreSQL içinde, o kullanıcı için ayarlanmış auth.uid() ve auth.role() ile çalıştırır (yazmaları geri almak için --dry-run ekleyin), yani cevap tam olarak uygulamanızın göreceği şeydir:
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, Alice'in gönderisini görmemeli
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# Alice bunu görmeli
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# Bir ziyaretçi hiçbir şey görmez
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"
aura db push sonrasında CI'de çalıştırın. Studio'nun RLS simülatörü (Veritabanı › bir tablo › RLS simülatörü), aynı kontrolü geri alınan bir PostgreSQL işlemi içinde çalıştırır ve sonucun yanında bunu belirtir; pgTAP ve pg_prove, her dağıtımın yayınlamadığı doğrudan bir PostgreSQL bağlantısına ihtiyaç duyar.
Politika istediğinizi yapmadığında#
- Boş sonuç mu? RLS içeren ve eşleşen
SELECTpolitikası olmayan bir tablonun anonim veya oturum açılarak okunması, rolü ve eklenecek politikayı adlandıranmeta.hintile[]değerini döndürür.aura db raw "select * from posts" --as anonziyaretçinin gördüklerini gösterir. - RLS devre dışı mı?
aura db table list, tabloları[RLS]ile işaretler ve Danışmanı, RLS devre dışı bırakılmış tablolar ve RLS içeren ancak ilkesi olmayan tablolar hakkında uyarır. RLS öğesinin kapatılması (aura db table rls posts off), tablonun ortak anahtarı tutan herkes tarafından okunabilmesini sağlar. - Görüntülemeler. Bir görünüm, okuyucunun ayrıcalıklarıyla okur (
security_invoker = true, oluşturduğunuz her görünüme uygulanır), dolayısıyla tablolarının ilkeleri uygulanır. - Toplama yapan politikalar: aynı tablodaki birden fazla politika + işlem + rol VEYA'da birleştirilir. Gerekirse tek bir politikada AND ile kısıtlayın
- Eksik GRANT izinleri: politika olsa bile rolün
grant select on posts to aura_authenticatedolması gerekir - Talepler eklenmedi: Postgres'den,
select current_setting('request.jwt.claims', true)— null, ağ geçidi aracılığıyla değil, doğrudan veritabanında olduğunuz anlamına gelir