सुरक्षा एवं आरबीएसी
पंक्ति-स्तरीय सुरक्षा मूल Postgres, पूर्वनिर्धारित भूमिकाएँ, बहु-किरायेदार आरबीएसी, ऑडिट लॉग। आपके नियम डेटाबेस में रहते हैं - परीक्षण योग्य, संस्करणबद्ध, क्लाइंट पक्ष पर उन्हें टालना असंभव है।
सुरक्षा आधार में रहती है#
Aurabase PostgreSQL के मूल पंक्ति-स्तरीय सुरक्षा (RLS) का उपयोग करता है। इसका मतलब यह है कि आपके एक्सेस नियम SQL में लिखे गए हैं, डेटाबेस में संग्रहीत हैं, प्रत्येक अनुरोध पर लागू होते हैं - जिनमें SDK, PostgREST, या प्रत्यक्ष psql द्वारा किए गए अनुरोध शामिल हैं।
MongoDB प्रोजेक्ट पर, कोई RLS नहीं है। अलगाव एक आरक्षित फ़ील्ड _owner_id द्वारा सुनिश्चित किया जाता है: गैर-विशेषाधिकार प्राप्त भूमिका के किसी भी पढ़ने को JWT के sub पर फ़िल्टर किया जाता है, और कोई भी लेखन इस फ़ील्ड पर मुहर लगाता है। खाली सूची को डीबग करने से पहले जागरूक होने के तीन परिणाम: service_role कुंजी के साथ बनाए गए दस्तावेज़ में नहीं है _owner_id और इसलिए सभी प्रमाणित उपयोगकर्ताओं के लिए अदृश्य हो जाता है (HTTP 200 में[] प्रतिक्रिया, त्रुटि के बिना); JWT के बिना anon कॉल करने वाले को गैर-सार्वजनिक संग्रह पर 403 प्राप्त होता है; और _owner_id, आरक्षित, क्लाइंट द्वारा कभी भी संशोधित नहीं किया जा सकता है। स्पष्ट ऑप्ट-इन public_read द्वारा सभी को पढ़ने के लिए एक संग्रह खोला जाता है।
ग्राहक पक्ष के लिए किसी पॉलिसी को दरकिनार करना असंभव है। उपयुक्त भूमिका के साथ Postgres कनेक्शन खोलने से पहले गेटवे प्रत्येक JWT को मान्य करता है। दावे (auth.uid(), auth.role(), auth.tenant()) request.jwt.claims के माध्यम से इंजेक्ट किए जाते हैं - SQL क्वेरी से संशोधित नहीं किए जा सकते।
Aurabase (स्टूडियो, टेबल एपीआई, माइग्रेशन, या /raw) के माध्यम से बनाई गई तालिकाएँ डिफ़ॉल्ट रूप से ENABLE और FORCE ROW LEVEL SECURITY स्वचालित रूप से प्राप्त होती हैं (जब तक कि DDL में स्पष्ट रूप से अक्षम न हो)। नीतियों को जोड़ने से पहले हमेशा alter table ... enable row level security के साथ सीधे psql कनेक्शन पर बनाई गई तालिकाओं पर RLS को सत्यापित करें।
JWT → दावे → नीति → लाइन#
प्रत्येक क्वेरी समान पथ का अनुसरण करती है. गेटवे JWT को डिकोड करता है, इसके हस्ताक्षर को सत्यापित करता है (डिफ़ॉल्ट रूप से प्रोजेक्ट-व्युत्पन्न रहस्य के साथ ES256; केवल RSA कुंजी कॉन्फ़िगर होने पर JWKS के साथ RS256), दावों को निकालता है, SET LOCAL role + SET LOCAL request.jwt.claims के साथ Postgres कनेक्शन खोलता है। auth.*() को संदर्भित करने वाली सभी नीतियां इन दावों का उपयोग करती हैं।
Client → Gateway verify JWT (ES256 via JWKS, project key)
↓ extract { sub, role, tenant, exp }
Postgres SET LOCAL role = authenticated
SET LOCAL request.jwt.claims = {...}
↓
SELECT ... FROM posts WHERE ...
↓ (RLS injecte la policy USING)
SELECT ... FROM posts WHERE author_id = auth.uid()
तीन Postgres भूमिकाएँ, स्पष्ट पदानुक्रम#
| भूमिका | दावा | विवरण |
|---|---|---|
anon | नहीं user_id | एनॉन कुंजी के साथ किए गए अनुरोध और कोई हस्ताक्षरित उपयोगकर्ता नहीं JWT |
authenticated | auth.uid() उपयोगकर्ता है | किसी भी Aurabase सत्र से वैध JWT के साथ साइन-इन किया गया उपयोगकर्ता |
service_role | बाईपास RLS | बैकएंड कुंजी जो हर पॉलिसी को पास करती है। केवल सर्वर. |
पांच आवश्यक पैटर्न#
नीतियाँ एक तालिका + एक ऑपरेशन (चयन/सम्मिलित/अद्यतन/हटाएं) + एक भूमिका से जुड़ी होती हैं। एक ही जोड़ी पर अनेक पॉलिसियाँ OR में संयुक्त हैं। मौजूदा पंक्तियों को फ़िल्टर करने के लिए using का उपयोग करें, नए मानों को सत्यापित करने के लिए with check का उपयोग करें।
alter table posts enable row level security;
-- पढ़ना: केवल लेखक
create policy "posts_own_read"
on posts for select
to aura_authenticated
using (auth.uid() = author_id);
pg_prove के साथ अपनी नीतियों का परीक्षण करें। प्रति तालिका एक rls_posts.sql फ़ाइल, प्रत्येक माइग्रेशन पर सीआई में निष्पादित। RLS गाइड देखें।
एनोन/प्रमाणित से परे#
एप्लिकेशन भूमिकाएं (व्यवस्थापक, संपादक, दर्शक, बिलिंग, आदि) उपयोगकर्ता के app_metadata के roles सरणी में रहती हैं, जिसे केवल सर्वर लिख सकता है (व्यवस्थापक एपीआई PUT /admin/users/{id} service_role कुंजी या एक्सेस-टोकन हुक के साथ)। प्रत्येक उपयोगकर्ता की N भूमिकाएँ हो सकती हैं। वे app_metadata.roles के अंतर्गत टोकन में यात्रा करते हैं, और auth.has_role('admin') उन्हें आपकी नीतियों में पढ़ता है। user_metadata कभी भी कोई भूमिका नहीं देता: उपयोगकर्ता इसे स्वयं संपादित कर सकते हैं। उन्हें टोकन के role दावे (anon या authenticated: Postgres टियर, auth.role() द्वारा पढ़ा गया) के साथ भ्रमित न करें और न ही उपयोगकर्ता के role फ़ील्ड (स्टूडियो में दिखाया गया एक मुफ़्त लेबल, जैसे user या editor__) के साथ भ्रमित न करें: इनमें से कोई भी एप्लिकेशन भूमिका नहीं देता है।
-- एडमिन सब कुछ देखता है
create policy "posts_admin_read"
on posts for select
to aura_authenticated
using (auth.has_role('admin'));
-- बिलिंग संवेदनशील कॉलमों को समर्पित दृश्य में देखता है
create view posts_billing as
select id, author_id, revenue_cents from posts
where auth.has_role('billing');
पूर्ण ट्रेस, सिएम निर्यात#
प्रत्येक सुरक्षा ईवेंट project_{uuid}_auth.auth_audit_log में लॉग इन होता है: साइनइन, साइनआउट, पासवर्ड_चेंज, एमएफए_एनरोल, रोल_ग्रांटेड, सर्विस_रोल_एक्सेस, असफल_ऑथ। प्रो पर 30 दिन का रिटेंशन, एंटरप्राइज पर 2 साल का रिटेंशन।
वेबहुक या काफ्का स्ट्रीम के माध्यम से आपके सिएम (स्प्लंक, डेटाडॉग, इलास्टिक) में स्वचालित निर्यात। विस्तृत ईवेंट स्कीमा के लिए /docs/compliance देखें।