ההנחיה הזו יכולה לעזור לעוזר הדיגיטלי מבוסס-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.
- כדי להריץ בדיקות יחידה של Firebase Security Rules ולהשתמש ב-Firebase Local Emulator Suite, צריך להתקין את Node.js ואת ה-CLI של Firebase. הוראות מלאות מפורטות במאמר התקנה, הגדרה ושילוב של Firebase Local Emulator Suite.
- מומלץ: אם עדיין לא עשיתם זאת, התקינו את Antigravity.
בהוראות הבאות מוסבר איך להפעיל את הסקילים האג'נטיים של Firebase ואת שרת ה-MCP ולהשתמש בהם כדי ליצור Security Rules. אם אתם מעדיפים להשתמש בסוכן תכנות אחר מבוסס-AI, אתם יכולים להעתיק את ההנחיה ל-Cloud Firestore או ל-Cloud Storage for Firebase מהמאגר של
firebase-toolsולהדביק אותה בסוכן התכנות מבוסס-AI שבחרתם. - הסקילים האג'נטיים ב-Firebase ושרת ה-MCP פועלים יחד כדי לגשת להנחיות שיוצרות ומאמתות את Firebase Security Rules, ועוזרים בבדיקה ובפריסה של Security Rules. התקנת שרת ה-MCP של Firebase לפני שמשתמשים בכלים האלה כדי ליצור 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, גם כשמשתמשים בהנחיה הזו. במקום זאת, השתמשו בעוזר אישי אחר מבוסס-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 ובדיקות
מגדירים ומפעילים את הכלים:
מפעילים את הסקילים האג'נטיים ב-Firebase:
Google Antigravity: כדי להתקין את הפלאגין של Firebase מ-Antigravity Marketplace, צריך לפעול לפי הוראות ההגדרה. אפשר גם להתקין את המיומנויות ברמת הפרויקט באמצעות הפקודה:
npx skills add firebase/agent-skills --agent=antigravityסוכני AI אחרים לתכנות: פועלים לפי ההוראות למיומנויות של סוכנים ולשרת MCP.
מפעילים את העוזר האישי מבוסס-AI (לדוגמה, מריצים את
agyבטרמינל של ה-CLI או פותחים את האפליקציה למחשב).מהתיקייה הראשית של הפרויקט, מבקשים מהסוכן ליצור 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
מוודאים שסוכן ה-AI לתכנות מבצע את הפעולות הבאות. אחרי שהכלים יפעלו, תקבלו סיכום שנוצר.
אימות תחביר: אחרי שנוצר Security Rules, סוכן ה-AI לתכנות מאמת באופן אוטומטי את התחביר באמצעות הפקודה
firebase_validate_security_rulesמשרת ה-MCP של Firebase.בדיקות יחידה: אחרי אימות התחביר, סוכן ה-AI לתכנות מנסה להריץ את בדיקות היחידה שנוצרו באמצעות Firebase Local Emulator Suite.
אם הבדיקות לא פועלות באופן אוטומטי, מפעילים את 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:rulesCloud Storage for Firebase
firebase deploy --only storage