طلب الذكاء الاصطناعي: كتابة قواعد أمان Firebase

يمكن أن يساعد هذا الطلب مساعدك المستند إلى الذكاء الاصطناعي (مثل Google Antigravity) في إنشاء Firebase Security Rules لتطبيقك وتحسينه. يمكنك استخدام الطلب لصياغة Security Rules لحالات الاستخدام الشائعة، مثل منح إذن وصول خاص بالمستخدم وتنفيذ الأذونات المستندة إلى الأدوار والتحقّق من صحة البيانات.

يركّز هذا الطلب على إنشاء Security Rules لما يلي:

  • Cloud Firestore: يمكنك تأمين المجموعات والمستندات استنادًا إلى منطق تطبيقك.
  • Cloud Storage for Firebase: التحقّق من صحة أذونات الوصول إلى ملفاتك المخزَّنة

يمكن أن يساعدك استخدام هذا الطلب في البدء بوضع أمان قوي، ولكن يجب دائمًا اختبار Security Rules بدقة قبل نشره في بيئة الإنتاج. لمزيد من المعلومات حول اختبار Security Rules، يُرجى مراجعة مقالة بدء استخدام Firebase Security Rules: اختبار Security Rules.

المتطلبات الأساسية

  • ننصحك بالاطّلاع على أفضل ممارسات Firebase Security Rules.
  • لتشغيل اختبارات الوحدات لـ Firebase Security Rules واستخدام Firebase Local Emulator Suite، ثبِّت Node.js وواجهة سطر أوامر Firebase. للحصول على التعليمات الكاملة، يُرجى الرجوع إلى مقالة تثبيت Firebase Local Emulator Suite وضبطه ودمجه.
  • إجراء مقترَح: إذا لم يسبق لك ذلك، ثبِّت Antigravity. توضّح التعليمات التالية كيفية تفعيل واستخدام مهارات وكلاء Firebase وخادم MCP لإنشاء Security Rules. إذا كنت تفضّل استخدام وكيل ترميز آخر مستند إلى الذكاء الاصطناعي، يمكنك نسخ الطلب ولصقه في Cloud Firestore أو Cloud Storage for Firebase من مستودع firebase-tools إلى وكيل الترميز المستند إلى الذكاء الاصطناعي الذي اخترته.
  • تعمل مهارات وكيل Firebase وخادم MCP معًا للوصول إلى الطلبات التي تنشئ Firebase Security Rules وتتحقّق من صحتها، وتساعد في اختبار Security Rules ونشره. ثبِّت خادم Firebase MCP قبل استخدام هذه الأدوات لإنشاء Firebase Security Rules.

القيود

نحن نعمل جاهدين على تحسين هذه التجربة، لذا قد تتغيّر هذه القائمة من القيود. يُرجى التحقّق باستمرار للاطّلاع على آخر الأخبار.

  • تم تصميم الطلب لإنشاء Firebase Security Rules لـ Cloud Firestore وCloud Storage for Firebase. لا يمكنه بعد إنشاء Security Rules لـ "Firebase Realtime Database".

  • لا يتم استدعاء Firebase Security Rules عند الوصول إلى قاعدة البيانات أو الحزمة من خادم أو بيئة خلفية أخرى، مثل عند استخدام Firebase Admin SDK. إذا كنت تستخدم Admin SDK، فأنت مسؤول عن إدارة التفويض والتحقّق من صحة البيانات في الرمز البرمجي للجهة الخلفية.

  • ‫Gemini في Firebase ضمن وحدة تحكّم Firebase غير قادر على إنشاء Firebase Security Rules، حتى عند استخدام هذا الطلب. بدلاً من ذلك، يمكنك استخدام مساعد ذكاء اصطناعي بديل لديه إمكانية الوصول إلى قاعدة الرموز البرمجية، مثل Antigravity (الموضّح في هذه الصفحة).

استخدام الطلب

تتوفّر هذه الإمكانية عند استخدام خادم Firebase MCP ومهارات وكلاء Firebase مع مساعد متوافق مستند إلى الذكاء الاصطناعي (مثل Antigravity) لإنشاء Security Rules والاختبارات. تحلّل هذه الأدوات الرمز المصدر للمساعدة في تحديد مخططات البيانات وأنماط الوصول إلى Cloud Firestore وCloud Storage. تم تصميمها لصياغة Security Rules استنادًا إلى مبدأ الحدّ الأدنى من الأذونات المميّزة ومحاولة الكشف عن الثغرات الأمنية من خلال عمليات محاكاة "الهجمات" المتكررة. للمساعدة في عملية التحقّق النهائية، يوفّر الفريق حزمة اختبارية أولية للوحدات باستخدام @firebase/rules-unit-testing، ما يتيح لك التحقّق من منطق الأمان محليًا باستخدام Firebase Local Emulator Suite.

يتطلب استخدام هذه الأدوات ثلاث خطوات موضحة في هذا القسم:

  1. إنشاء Security Rules والاختبارات

  2. مراجعة نتائج التحقّق من الصحة والاختبار في Security Rules

  3. انشر Security Rules في مشروعك على Firebase.

الخطوة 1: إنشاء Security Rules والاختبارات

إعداد الأدوات وتشغيلها:

  1. فعِّل مهارات وكلاء Firebase:

    • Google Antigravity: يُرجى الرجوع إلى تعليمات الإعداد لتثبيت مكوّن Firebase الإضافي من "سوق Antigravity". يمكنك أيضًا تثبيت المهارات على مستوى المشروع من خلال تشغيل:

      npx skills add firebase/agent-skills --agent=antigravity
    • وكلاء الترميز الآخرون المستندون إلى الذكاء الاصطناعي: اتّبِع التعليمات الخاصة بمهارات الوكيل و خادم MCP.

  2. ابدأ تشغيل مساعد الذكاء الاصطناعي (على سبيل المثال، شغِّل agy في الوحدة الطرفية لواجهة سطر الأوامر، أو افتح تطبيق الكمبيوتر المكتبي).

  3. من جذر مشروعك، اطلب من الوكيل إنشاء Security Rules إما لـ Cloud Firestore أو Cloud Storage استنادًا إلى كيفية تفاعل وكيل الترميز بالذكاء الاصطناعي مع طلبات MCP:

    • بالنسبة إلى وكلاء الترميز الذين يستخدمون اللغة الطبيعية (مثل Antigravity)، يمكنك توجيه طلب إلى الوكيل باستخدام اللغة الطبيعية.

      • إنشاء Security Rules لـ "Cloud Firestore":

        Generate Firestore security rules for this project, then run the unit tests.
        

        في الدليل الرئيسي، ينشئ الوكيل ملف firestore.rules ودليل security_rules_test_firestore جديدًا يحتوي على مشروع Node.js مع اختبارات الوحدات لملف Security Rules الذي تم إنشاؤه.

      • إنشاء Security Rules لـ "Cloud Storage for Firebase":

        Generate Cloud Storage security rules for this project, then run the unit tests.
        

        في الدليل الرئيسي، ينشئ الوكيل ملف storage.rules ودليل security_rules_test_storage جديدًا يحتوي على مشروع Node.js مع اختبارات الوحدات لملف Security Rules الذي تم إنشاؤه.

    • بالنسبة إلى وكلاء الترميز الذين يتيحون استخدام الأوامر التي تبدأ بشرطة مائلة (مثل Claude Code)، يمكنك استخدام الأوامر التالية.

      • إنشاء Security Rules لـ "Cloud Firestore":

        /firestore:generate_security_rules
        
      • إنشاء Security Rules لـ "Cloud Storage for Firebase":

        /storage:generate_security_rules
        
    • بالنسبة إلى وكلاء الترميز الذين لا يتيحون دمج طلبات MCP، يمكنك نسخ نموذج الطلب الأوّلي من مستودع firebase-tools ولصقه في محادثة الوكيل.

الخطوة 2: مراجعة نتائج التحقّق والاختبار في "Security Rules"

  1. تأكَّد من أنّ وكيل الترميز بالذكاء الاصطناعي قد نفّذ ما يلي: من المفترض أن تحصل على ملخّص بعد تشغيل الأدوات.

    • التحقّق من صحة البنية: بعد إنشاء Security Rules، يتحقّق وكيل الترميز المستنِد إلى الذكاء الاصطناعي تلقائيًا من صحة البنية باستخدام الأمر firebase_validate_security_rules من خادم Firebase MCP.

    • اختبارات الوحدة: بعد التحقّق من صحة البنية، يحاول وكيل الترميز المستند إلى الذكاء الاصطناعي تشغيل اختبارات الوحدة التي تم إنشاؤها باستخدام Firebase Local Emulator Suite.

  2. إذا لم يتم إجراء الاختبارات تلقائيًا، ابدأ تشغيل Firebase Local Emulator Suite في نافذة منفصلة، ثم استخدِم أحد الخيارات التالية لإجراء الاختبارات:

    • الخيار 1: اطلب من مساعدك المستنِد إلى الذكاء الاصطناعي إجراء الاختبارات:

      Firebase Emulator Suite is running in a separate terminal. Please execute the tests.
      
    • الخيار 2: إجراء الاختبارات يدويًا باتّباع التعليمات الواردة في ملف README.md في دليل rules_test أو storage_rules_test

الخطوة 3: نشر Security Rules في مشروع Firebase

عندما تكون راضيًا عن نتيجة Security Rules الذي تم إنشاؤه، استخدِم أوامر واجهة سطر الأوامر (CLI) التالية في Firebase لنشر Security Rules في مشروع Firebase:

  • Cloud Firestore

    firebase deploy --only firestore:rules
  • Cloud Storage for Firebase

    firebase deploy --only storage