सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

उत्पादन में पंक्ति-स्तरीय सुरक्षा

तीन RLS पैटर्न 95% उपयोग के मामलों को कवर करते हैं: स्वामित्व, बहु-किरायेदार, पदानुक्रमित संगठन। pg_prove और डिबग परीक्षणों के साथ।

कैसे-करें गाइड12 मि॰ पढ़ेंस्तर विकसित15 अप्रैल 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

RLS क्या है#

पंक्ति-स्तरीय सुरक्षा एक मूल PostgreSQL सुविधा है जो SQL अभिव्यक्ति का मूल्यांकन करके तुरंत लौटाई गई (या स्वीकृत) पंक्तियों को फ़िल्टर करती है, जो वर्तमान भूमिका और JWT दावों पर निर्भर हो सकती है। Aurabase request.jwt.claims के माध्यम से उपयोगकर्ता के दावों को प्रस्तुत करता है और सहायकों auth.uid(), auth.role(), auth.tenant(), auth.has_role() को उजागर करता है।

नीति लिखने से पहले जानने योग्य तीन बातें
  • भूमिका नाम. विहित डेटाबेस भूमिकाएँ aura_anon, aura_authenticated और aura_service_role हैं। प्रबंधित समूहों पर, समूह उपनाम anon, authenticated, और service_role भी उन्हें मैप करते हैं (ध्यान दें कि BYPASSRLS अकेले aura_service_role पर सख्ती से रहता है)।
  • RLS Aurabase के माध्यम से बनाई गई तालिकाओं के लिए डिफ़ॉल्ट रूप से चालू है। /raw, एक माइग्रेशन, स्टूडियो, या टेबल एपीआई के साथ बनाई गई कोई भी तालिका स्वचालित रूप से ENABLE और FORCE ROW LEVEL SECURITY प्राप्त करती है (जब तक कि DISABLE ROW LEVEL SECURITY को उसी DDL बैच में स्पष्ट रूप से निष्पादित नहीं किया जाता है): जब तक आप कोई नीति नहीं जोड़ते तब तक सार्वजनिक/एनोन क्वेरी [] लौटाती हैं। सीधे PostgreSQL कनेक्शन (psql, प्रिज्मा, ड्रिज़ल) पर बनाई गई तालिकाएँ कभी भी उस हुक से नहीं गुजरती हैं, इसलिए उन्हें नहीं RLS मिलता है और, इसके बजाय, को सार्वजनिक कुंजियों तक कोई पहुंच नहीं मिलती है: aura_anon और aura_authenticated तब तक उन पर कोई विशेषाधिकार नहीं होता है। आप इसे प्रदान करें. ऐसी तालिका को SDK में प्रदर्शित करने के लिए, पहले RLS को सक्षम करें, फिर अनुदान दें और एक नीति जोड़ें: ALTER TABLE posts ENABLE ROW LEVEL SECURITY; GRANT SELECT, INSERT, UPDATE, DELETE ON posts TO aura_authenticated; CREATE POLICY ...। कभी भी उस टेबल पर aura_anon या aura_authenticated को अनुदान न दें, जिसका RLS बंद है: सार्वजनिक कुंजी का प्रत्येक धारक, या प्रत्येक साइन-अप उपयोगकर्ता, इसकी सभी पंक्तियों को पढ़ेगा (और, लेखन अनुदान के साथ, संशोधित करेगा)।
  • सार्वजनिक कुंजी का कोई उपयोगकर्ता नहीं है। auth.uid() सार्वजनिक कुंजी के लिए और service_role कुंजी के लिए NULL है; यह केवल साइन-इन किए हुए उपयोगकर्ता के लिए एक आईडी लौटाता है। किसी नीति को साइन-इन उपयोगकर्ताओं तक सीमित करने के लिए to aura_authenticated का उपयोग करें।

स्वामित्व - प्रत्येक उपयोगकर्ता की अपनी पंक्तियाँ#

मामलों का उपयोग करें: प्रोफ़ाइल, नोट्स, पोस्ट जहां प्रत्येक पंक्ति user_id या 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);
सुझाव

एक पॉलिसी में SELECT/UPDATE/DELETE को कवर करने के लिए for all को using + with check के साथ मिलाएं। INSERT केवल with check का उपयोग करता है।

बहु-किरायेदार - संगठन द्वारा दायरा#

उपयोग का मामला: B2B SaaS जहां प्रत्येक उपयोगकर्ता एक संगठन से संबंधित है, और अपने संगठन के सभी डेटा को देखता है। JWT में app_metadata.tenant होता है, जिसे auth.tenant() सहायक लौटाता है (NULL अनुपस्थित होने पर या यूयूआईडी नहीं होने पर, इसलिए पॉलिसी अस्वीकार करती है)।

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

-- प्रदर्शन के लिए अपरिहार्य सूचकांक
create index idx_orders_tenant on orders(tenant_id);

पदानुक्रमित संगठन - भूमिका के अनुसार अनुमतियाँ#

केस का उपयोग करें: SaaS जहां किसी संगठन (व्यवस्थापक, सदस्य, दर्शक) में भूमिकाओं के लिए अलग-अलग अनुमतियाँ होती हैं। हम auth.tenant() को 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 - प्रति नीति एक दावा#

अपनी नीतियों का परीक्षण करें - एक वास्तविक उपयोगकर्ता के रूप में, सीआई में

नीतियां कोड हैं, इसलिए उनका परीक्षण करें। aura db raw ... --as authenticated --user <uuid> उस उपयोगकर्ता के लिए auth.uid() और auth.role() सेट के साथ PostgreSQL के अंदर SQL चलाता है (रोल राइट बैक में --dry-run जोड़ें), इसलिए उत्तर वही है जो आपका ऐप देखेगा:

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')"
# बॉब को ऐलिस की पोस्ट नहीं देखनी चाहिए
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$BOB" --json | jq -r '.[0].n')" = "0"
# ऐलिस को इसे अवश्य देखना चाहिए
test "$(aura db raw "select count(*) as n from posts" --as authenticated --user "$ALICE" --json | jq -r '.[0].n')" = "1"
# एक आगंतुक को कुछ नहीं दिखता
test "$(aura db raw "select count(*) as n from posts" --as anon --json | jq -r '.[0].n')" = "0"

इसे aura db push के बाद CI में चलाएँ। स्टूडियो का RLS सिम्युलेटर (डेटाबेस › एक तालिका › RLS सिम्युलेटर) रोल-बैक PostgreSQL लेनदेन के अंदर एक ही चेक चलाता है और परिणाम के आगे ऐसा कहता है; pgTAP और pg_prove को सीधे PostgreSQL कनेक्शन की आवश्यकता होती है, जिसे प्रत्येक परिनियोजन प्रकाशित नहीं करता है।

जब नीति वह नहीं करती जो आप चाहते हैं#

  • खाली परिणाम? RLS के साथ तालिका का एक अनाम या साइन-इन रीड और कोई मेल नहीं खाने वाली SELECT नीति meta.hint के साथ [] लौटाती है जो भूमिका और जोड़ने की नीति का नाम देती है। aura db raw "select * from posts" --as anon दिखाता है कि एक आगंतुक क्या देखता है।
  • RLS अक्षम? aura db table list [RLS] वाली तालिकाओं को चिह्नित करता है, और सलाहकार RLS अक्षम तालिकाओं और RLS वाली तालिकाओं के बारे में चेतावनी देता है लेकिन कोई नीति नहीं है। RLS को बंद करने से (aura db table rls posts off) तालिका सार्वजनिक कुंजी रखने वाले किसी भी व्यक्ति द्वारा पढ़ने योग्य हो जाती है।
  • दृश्य। एक दृश्य पाठक के विशेषाधिकारों के साथ पढ़ा जाता है (security_invoker = true आपके द्वारा बनाए गए प्रत्येक दृश्य पर लागू होता है), इसलिए इसकी तालिकाओं की नीतियां लागू होती हैं।
  • नीतियां जो को जोड़ती हैं: एक ही टेबल पर कई नीतियां + संचालन + भूमिका OR में संयोजित होती हैं। यदि आवश्यक हो तो एक ही पॉलिसी में AND के साथ प्रतिबंधित करें
  • अनुपलब्ध अनुदान अनुमतियाँ: एक नीति के साथ भी, भूमिका में grant select on posts to aura_authenticated होना चाहिए
  • दावे इंजेक्ट नहीं किए गए: Postgres से, select current_setting('request.jwt.claims', true) - शून्य का मतलब है कि आप सीधे DB में हैं, गेटवे के माध्यम से नहीं

आगे जाने के लिए#