بدء استخدام قواعد أمان Firebase

توفّر Firebase Security Rules حماية قوية وقابلة للتخصيص بالكامل لبياناتك في Cloud Firestore وRealtime Database وCloud Storage. يمكنك بدء استخدام Rules بسهولة باتّباع الخطوات الواردة في هذا الدليل، ما يؤدّي إلى تأمين بياناتك وحماية تطبيقك من المستخدمين الضارّين.

فهم اللغة Firebase Security Rules

قبل البدء في كتابة القواعد، من المفيد تخصيص بعض الوقت لمراجعة لغة Firebase Security Rules المحدّدة لمنتجات Firebase التي تستخدمها. تستفيد Cloud Storage من مجموعة فائقة للغة التعبير الشائعة (CEL) التي تعتمد على match وallow التي تُحدِّد شرطًا للوصول إلى مسار محدّد.

ابدأ بتعلُّم البنية الأساسية للغة Firebase Security Rules.

إعداد Authentication

أضِف Firebase Authentication إلى تطبيقك إذا لم يسبق لك ذلك. تتيح Firebase Authentication العديد من طرق المصادقة الشائعة وتتيح الدمج مع Firebase Security Rules لتوفير إمكانات شاملة للتحقّق.

يمكنك إعداد معلومات مصادقة مخصّصة إضافية لتطبيقك.

مزيد من المعلومات حول Firebase Security Rules وFirebase Authentication

تحديد هياكل البيانات والقواعد

قد تؤثر طريقة تنظيم بياناتك في طريقة تنظيم قواعدك وتطبيقها. أثناء تحديد هياكل البيانات، ضع في اعتبارك الآثار التي قد تحدثها على بنية Rules.

على سبيل المثال، في Cloud Storage، قد تحتاج إلى تضمين حقل يشير إلى دور معيّن لكل مستخدم. بعد ذلك، يمكن لقواعدك قراءة هذا الحقل واستخدامه لمنح إذن الوصول المستنِد إلى الدور. يمكنك أيضًا إنشاء قاعدة بيانات Cloud Firestore وتخزين معايير الوصول في مستندات Cloud Firestore ، ثم الوصول إلى هذه المستندات من Cloud Storage Security Rules.

عند تحديد بنية البيانات والقواعد، يجب مراعاة طريقة تسلسل القواعد أو عدم تسلسلها، وذلك استنادًا إلى منتجك. باستخدام Realtime Database، تعمل القواعد من الأعلى إلى الأسفل، مع إلغاء القواعد الأقل عمقًا للقواعد الأكثر عمقًا. إذا كان أحد القواعد يمنح أذونات قراءة أو كتابة في مسار معيّن، سيمنح أيضًا إذن الوصول إلى جميع العقد الفرعية ضمنه. في المقابل، مع Cloud Firestore و Cloud Storage، لا تنطبق القواعد إلا على مستويات محدّدة من التسلسل الهرمي للبيانات، ويمكنك كتابة قواعد صريحة للتحكّم في الوصول إلى المستويات المختلفة.

الوصول إلى قواعدك

للاطّلاع على Rules الحالية، استخدِم واجهة سطر أوامر Firebase أو وحدة تحكّم Firebase. احرص على تعديل قواعدك باستخدام الطريقة نفسها باستمرار لتجنّب استبدال التحديثات عن طريق الخطأ. إذا لم تكن متأكّدًا مما إذا كانت القواعد المحدّدة محليًا تعكس آخر التعديلات، تعرض وحدة التحكّم في Firebase دائمًا أحدث إصدار تم نشره من Firebase Security Rules.

للوصول إلى قواعدك من وحدة تحكّم Firebase، اختَر مشروعك، ثمّ انقر على مساحة التخزين في لوحة التنقّل اليمنى. انقر على Rules بعد الانتقال إلى قاعدة البيانات أو حزمة التخزين الصحيحة.

للوصول إلى قواعدك من Firebase CLI، انتقِل إلىملف rules المُشار إليه في ملف firebase.json.

كتابة القواعد الأساسية

أثناء تطوير تطبيقك وفهم Rules، حاوِل تنفيذ Rules لمعالجة بعض حالات الاستخدام الأساسية، بما في ذلك ما يلي:

  • مالك المحتوى فقط: تقييد إمكانية وصول المستخدم إلى المحتوى
  • إمكانية الوصول المختلطة: يمكنك حصر إمكانية الكتابة من قِبل المستخدم، ولكن السماح بإمكانية القراءة للجميع.
  • الوصول المستنِد إلى السمات: يمكنك تقييد الوصول إلى مجموعة أو نوع من المستخدمين.

اختبار القواعد

إذا كنت بصدد إعداد Firebase Security Rules في وحدة تحكّم Firebase، يمكنك استخدام مساحة لعب قواعد Firebase للتحقّق بسرعة من السلوك. ومع ذلك، ننصحك بإجراء اختبار أكثر دقة باستخدام Local Emulator Suite قبل نشر التغييرات في قناة الإصدار العلني.

نشر القواعد

استخدِم وحدة تحكّم Firebase أو واجهة سطر أوامر Firebase لنشر قواعدك في قناة الإصدار العلني. اتّبِع الخطوات الموضّحة في مقالة إدارة Firebase Security Rules ونشره.