הנחיה ל-AI: כתיבת כללי אבטחה של Firebase

ההנחיה הזו יכולה לעזור לעוזר הדיגיטלי מבוסס-AI (כמו 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 עבור 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, גם כשמשתמשים בהנחיה הזו. במקום זאת, השתמשו בעוזר אישי אחר מבוסס-AI שיש לו גישה לבסיס הקוד, כמו Antigravity (שמתואר בדף הזה).

שימוש בפרומפט

היכולת הזו זמינה כשמשתמשים בשרת Firebase MCP ובסקילים אג'נטיים ב-Firebase עם עוזר אישי תואם מבוסס-AI (כמו 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 Marketplace, צריך לפעול לפי הוראות ההגדרה. אפשר גם להתקין את המיומנויות ברמת הפרויקט באמצעות הפקודה:

      npx skills add firebase/agent-skills --agent=antigravity
    • סוכני AI אחרים לתכנות: פועלים לפי ההוראות למיומנויות של סוכנים ולשרת MCP.

  2. מפעילים את העוזר האישי מבוסס-AI (לדוגמה, מריצים את agy בטרמינל של ה-CLI או פותחים את האפליקציה למחשב).

  3. מהתיקייה הראשית של הפרויקט, מבקשים מהסוכן ליצור Security Rules ל-Cloud Firestore או ל-Cloud Storage, בהתאם לאופן שבו סוכן התכנות מבוסס ה-AI יוצר אינטראקציה עם הנחיות 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 עם בדיקות יחידה (unit testing) ל-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 עם בדיקות יחידה (unit testing) ל-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 ולהדביק אותה בצ'אט של הסוכן.

      • יצירת Security Rules עבור Cloud Firestore: מעתיקים את ההנחיה מ-Cloud Firestore.
      • יצירת Security Rules עבור Cloud Storage for Firebase: מעתיקים את ההנחיה מ-Cloud Storage for Firebase.

שלב 2: בודקים את תוצאות האימות והבדיקה של Security Rules

  1. מוודאים שסוכן ה-AI לתכנות מבצע את הפעולות הבאות. אחרי שהכלים יפעלו, תקבלו סיכום שנוצר.

    • אימות תחביר: אחרי שנוצר Security Rules, סוכן ה-AI לתכנות מאמת באופן אוטומטי את התחביר באמצעות הפקודה firebase_validate_security_rules משרת ה-MCP של Firebase.

    • בדיקות יחידה: אחרי אימות התחביר, סוכן ה-AI לתכנות מנסה להריץ את בדיקות היחידה שנוצרו באמצעות Firebase Local Emulator Suite.

  2. אם הבדיקות לא פועלות באופן אוטומטי, מפעילים את Firebase Local Emulator Suite בטרמינל נפרד, ואז משתמשים באחת מהאפשרויות הבאות כדי להריץ את הבדיקות:

    • אפשרות 1: מנחים את העוזר האישי מבוסס-AI להריץ בדיקות:

      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