الأمن وRBAC
الأمان الأصلي على مستوى الصف Postgres، والأدوار المحددة مسبقًا، وRBAC متعدد المستأجرين، وسجلات التدقيق. القواعد الخاصة بك موجودة في قاعدة البيانات - قابلة للاختبار، وإصدار، ومن المستحيل التحايل عليها من جانب العميل.
يعيش الأمن في القاعدة#
يستخدم Aurabase الأمان الأصلي على مستوى الصف لـ PostgreSQL(RLS). هذا يعني أن قواعد الوصول الخاصة بك مكتوبة بلغة SQL، ومخزنة في قاعدة البيانات، ويتم تطبيقها على كل طلب - بما في ذلك تلك التي يتم إجراؤها بواسطة SDK، أو PostgREST، أو psql المباشر.
في مشروع MongoDB، لا يوجد RLS. يتم ضمان العزل من خلال حقل محجوز _owner_id: تتم تصفية أي قراءة لدور غير مميز على sub في JWT، وأي طوابع كتابة لهذا الحقل. ثلاث عواقب يجب الانتباه إليها قبل تصحيح أخطاء القائمة الفارغة: المستند الذي تم إنشاؤه باستخدام مفتاح service_role لا يحتوي على لا _owner_id وبالتالي يصبح غير مرئي لجميع المستخدمين المصادقين (استجابة [] في HTTP 200، بدون خطأ)؛ المتصل anon بدون JWT يتلقى 403 في مجموعة غير عامة؛ و_owner_id، محجوز، ولا يمكن للعميل تعديله أبدًا. يتم فتح المجموعة للقراءة للجميع عن طريق الاشتراك الصريح public_read.
التحايل على السياسة أمر مستحيل من جانب العميل. تتحقق البوابة من صحة كل JWT قبل فتح اتصال Postgres بالدور المناسب. يتم إدخال المطالبات (auth.uid(), auth.role(), auth.tenant()) عبر request.jwt.claims — لا يمكن تعديلها من استعلام SQL.
الجداول التي تم إنشاؤها من خلال Aurabase (Studio أو table API أو عمليات الترحيل أو /raw) تحصل على ENABLE وFORCE ROW LEVEL SECURITY تلقائيًا بشكل افتراضي (ما لم يتم تعطيلها بشكل صريح في DDL). تحقق دائمًا من RLS على الجداول التي تم إنشاؤها عبر اتصال psql مباشر مع alter table ... enable row level security قبل إضافة السياسات.
JWT → المطالبات → السياسة → السطر#
يتبع كل استعلام نفس المسار. تقوم البوابة بفك تشفير JWT والتحقق من توقيعها (ES256 مع السر المشتق من المشروع بشكل افتراضي؛ RS256 مع JWKS فقط عند تكوين مفتاح RSA)، واستخراج المطالبات، وفتح اتصال Postgres مع SET LOCAL role + SET LOCAL request.jwt.claims. تستخدم جميع السياسات التي تشير إلى 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() هو المستخدم | مستخدم قام بتسجيل الدخول باستخدام JWT صالح، من أي جلسة Aurabase |
service_role | يتجاوز RLS | مفتاح الواجهة الخلفية الذي يمرر كل سياسة. الخادم فقط. |
خمسة أنماط أساسية#
يتم إرفاق السياسات بجدول + عملية (SELECT/INSERT/UPDATE/DELETE) + دور. يتم دمج سياسات متعددة على نفس الزوج في 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 واحد لكل جدول، يتم تنفيذه في CI في كل عملية ترحيل. راجع دليل RLS.
ما وراء المجهول/المصادقة#
توجد أدوار التطبيق (المسؤول، والمحرر، والعارض، والفوترة، وما إلى ذلك) في مصفوفة roles الخاصة بالمستخدم app_metadata، والتي يمكن للخادم فقط كتابتها (واجهة برمجة التطبيقات الإدارية 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');
التتبع الكامل، تصدير SIEM#
يتم تسجيل الدخول لكل حدث أمني project_{uuid}_auth.auth_audit_log: تسجيل الدخول، تسجيل الخروج، تغيير كلمة المرور، mfa_enroll، role_granted،service_role_access، Failed_auth. الاحتفاظ لمدة 30 يومًا على الإصدار Pro، وسنتين على الإصدار Enterprise.
تصدير تلقائي إلى SIEM (Splunk، Datadog، Elastic) عبر webhook أو تدفق Kafka. راجع /docs/compliance للحصول على مخططات الأحداث التفصيلية.