انتقل إلى المحتوى
شعار أوراباسي
aurabase

الأمان على مستوى الصف في الإنتاج

ثلاثة أنماط RLS تغطي 95% من حالات الاستخدام: الملكية، والمستأجرين المتعددين، والمؤسسة الهرمية. مع اختبارات pg_prove وتصحيح الأخطاء.

دليل عملي12 د قراءةالمستوى متقدمتمت المراجعة في 15‏/04‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

ما هو RLS#

يعد Row-Level Security إحدى ميزات 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, Prisma, Drizzle) لا تمر أبدًا عبر هذا الخطاف، لذلك تحصل على no 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() هو NULL للمفتاح العام ومفتاح service_role؛ تقوم بإرجاع معرف فقط لمستخدم قام بتسجيل الدخول. استخدم 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);
نصيحة

ادمج for all مع using + with check لتغطية التحديد/التحديث/الحذف في سياسة واحدة. يستخدم INSERT فقط with check.

متعدد المستأجرين - النطاق حسب المنظمة#

حالة الاستخدام: B2B SaaS حيث ينتمي كل مستخدم إلى مؤسسة، ويرى جميع بيانات مؤسسته. يحمل JWT app_metadata.tenant، والذي يقوم المساعد auth.tenant() بإرجاعه (NULL عند غياب UUID أو عدم وجوده، لذلك يتم رفض السياسة).

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 — تأكيد واحد لكل سياسة#

اختبر سياساتك - كمستخدم حقيقي، في CI

السياسات عبارة عن تعليمات برمجية، لذا اختبرها. يقوم aura db raw ... --as authenticated --user <uuid> بتشغيل SQL داخل PostgreSQL مع تعيين auth.uid() وauth.role() لهذا المستخدم (أضف --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"

قم بتشغيله في CI بعد aura db push. يقوم جهاز محاكاة RLS الخاص بـ Studio (قاعدة البيانات › جدول › RLS Simulator) بتشغيل نفس الفحص داخل معاملة 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 المفقودة: حتى مع وجود سياسة، يجب أن يحتوي الدور على grant select on posts to aura_authenticated
  • لم يتم إدخال المطالبات: من Postgres, select current_setting('request.jwt.claims', true) - يعني أنك في قاعدة بيانات مباشرة، وليس عبر البوابة

للذهاب أبعد من ذلك#