İçeriğe geç
Aurabase Logosu
aura tabanı

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

Nasıl yapılır kılavuzu12 dk. okuSeviye ileri düzey15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

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.

Bir politika yazmadan önce bilmeniz gereken üç şey
  • Rol adları. Kurallı veritabanı rolleri aura_anon, aura_authenticated ve aura_service_role şeklindedir. Yönetilen kümelerde, anon, authenticated ve service_role grup takma adları da bunlarla eşleşir (BYPASSRLS öğesinin kesinlikle yalnızca aura_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 olarak ENABLE ve FORCE ROW LEVEL SECURITY alır (DISABLE ROW LEVEL SECURITY aynı 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_anon ve aura_authenticated siz 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 asla aura_anon veya aura_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 ve service_role anahtarı için NULL'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çin to aura_authenticated kullanı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.

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);
İpucu

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

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

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

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

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, 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 SELECT politikası olmayan bir tablonun anonim veya oturum açılarak okunması, rolü ve eklenecek politikayı adlandıran meta.hint ile [] değerini döndürür. aura db raw "select * from posts" --as anon ziyaretç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_authenticated olması 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

Daha ileri gitmek için#