उत्पादन में पंक्ति-स्तरीय सुरक्षा
तीन RLS पैटर्न 95% उपयोग के मामलों को कवर करते हैं: स्वामित्व, बहु-किरायेदार, पदानुक्रमित संगठन। pg_prove और डिबग परीक्षणों के साथ।
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 के माध्यम से एक अद्वितीय उपयोगकर्ता की है।
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 अनुपस्थित होने पर या यूयूआईडी नहीं होने पर, इसलिए पॉलिसी अस्वीकार करती है)।
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() के साथ जोड़ते हैं।
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 जोड़ें), इसलिए उत्तर वही है जो आपका ऐप देखेगा:
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 में हैं, गेटवे के माध्यम से नहीं