قواعد الأمان لعمليات خطوط الإنتاج

الهدف الأساسي من إتاحة قواعد طلبات البحث في Pipeline هو توفير إمكانات الفلترة نفسها المتوفّرة في محرك القواعد الحالي. على الرغم من أنّ طلبات البحث في Pipeline توفّر مجموعة كبيرة من الميزات، إلا أنّ محرك القواعد يقتصر على التعرّف على الفلاتر البسيطة لضمان إمكانية تنفيذ طلب البحث وأمانه.

تعبيرات الفلاتر المتوافقة

لكي يتم تقييد طلب بحث بقواعدك، يجب أن يستخدم عوامل تشغيل مقارنة عادية مع ثوابت. تتعرّف "قواعد المحرّك" على أنواع الفلاتر التالية:

• المساواة وعدم المساواة: eq، neq
• المقارنات: gt وgte وlt وlte
• العضوية: in، arrayContains

وإليك بعض الأمثلة:

• where(eq("foo", 2))
• where(lt("foo", 2))
• documents("/user/1", "/user/2").where(...)

ملاحظة: لا يتم التعرّف على العبارات المعقّدة، مثل العمليات الحسابية ضمن فلتر (على سبيل المثال، where(eq("foo" * 2, 10))) أو دوال السلسلة مثل strContains، عند تقييد طلبات البحث.

سمات الطلب

يمكنك مواصلة استخدام العنصر request للتحقّق من صحة المصادقة وسياق طلب البحث، مع العلم أنّ بعض الخصائص المتاحة في طلبات البحث العادية غير متوافقة مع عمليات النقل.

السمات المتوافقة

يواصل المحرّك الجديد إتاحة السمات التالية:

• request.auth: للوصول إلى بيانات الرمز المميز ومعرّف المستخدم الفريد.
• request.method: تحدّد العملية (على سبيل المثال، get أو list).
• ‫request.path: مسار المورد الذي يتم الوصول إليه
• ‫request.time: الطابع الزمني للطلب من جهة الخادم.

الخصائص غير المتوافقة

لا تتوافق سمات request.query، مثل limit وoffset وorderBy، مع عمليات التحقّق من قواعد Pipelines بسبب صعوبة تحديد هذه القيم في طلبات البحث المتعددة المراحل.

التعامل مع مراحل خط سير العمل والأذونات

هناك مراحل مختلفة في مسار المعالجة يتم ربطها بعمليات دقيقة محدّدة في قواعد الأمان:

• أذونات allow list: يتم تفعيلها من خلال مراحل collection() وcollectionGroup() وdatabase().
• أذونات allow get: يتم تفعيلها من خلال مرحلة documents()، التي يتم التعامل معها بشكل مشابه لعملية get مجمّعة.
• مراحل تعديل الحقول: لا تعمل القواعد إلا على البيانات المخزّنة وليس على القيم المشتقة. إذا كان مسار المعالجة يتضمّن مراحل تعدّل الحقول (مثل AddFields وReplaceWith وSelect)، يتوقّف محرّك القواعد عن تطبيق قيود الفلتر بعد مواجهة تلك المرحلة.
• مرحلة القيم الحرفية: لا تقرأ مرحلة literals() من قاعدة البيانات، ولكن قد تتكبّد تكاليف. لمنع إساءة الاستخدام، يجب إقرانها بمرحلة أخرى (مثل collection()) يمكن التحقّق منها باستخدام القواعد.