רשימת משימות אבטחה לשימוש ב-Firebase AI Logic

כשאתם קוראים ל-Gemini API ישירות מהאפליקציות לנייד ולאינטרנט, כדי להגן על תשתית הקצה העורפי, המכסה וההנחיות הקנייניות שלכם, אתם צריכים גישה רב-שכבתית להגנה מעמיקה. כדאי לעיין ברשימת המשימות הזו כדי ליישם את השיטות המומלצות לאבטחה ב-Firebase AI Logic.

אימות של אפליקציה, מכשיר ומשתמש

לוודא שהבקשות הנכנסות מגיעות ממופעים לגיטימיים של האפליקציה שפועלים במכשירים אותנטיים, וגם ממשתמשים אותנטיים.

אכיפה Firebase App Check

אוכפים את Firebase App Check כדי להגן על Gemini API מפני ניצול לרעה כשקוראים לו ישירות מהאפליקציה. כשאוכפים את App Check, הוא מאמת שהבקשות הנכנסות מגיעות מהאפליקציה המקורית ו/או ממכשיר שלא בוצעו בו שינויים.

‫App Check תומך בספקי אימות לפלטפורמות של אפל (DeviceCheck,‏ App Attest או reCAPTCHA Enterprise), של Android (‏Play Integrity או reCAPTCHA Enterprise) ושל האינטרנט (reCAPTCHA Enterprise). הוא תומך בכל הספקים האלה גם לאפליקציות Flutter ו-Unity.

ב-2 בנובמבר 2026, מערכת Firebase אכפה באופן אוטומטי את App Check עבור Firebase AI Logic בכל הפרויקטים כדי להגן על Gemini API מפני ניצול לרעה. לפיתוח מקומי, אתם יכולים להגדיר את App Check ספק האימות לצורכי ניפוי באגים, ואז לרשום את האפליקציה אצל ספק אימות בסביבת הייצור לפני ההשקה למשתמשי הקצה.

הפעלת הגנה מפני התקפות Replay באמצעות טוקנים לשימוש מוגבל

כחלק מההגדרה של App Check, כדאי לאכוף הגנה מפני מתקפות Replay כדי שאסימוני App Check יהיו לשימוש חד-פעמי בלבד. האפשרות הזו מציעה הגנה משופרת מעבר להגנה הבסיסית, ומאפשרת לכם להגדיר רמת הגנה שמתאימה לאפליקציה ולתרחישי השימוש שלכם.

הגדרת הגבלות על מפתחות ה-API של Firebase

מפתחות Firebase API מזהים את הפרויקט והאפליקציה שלכם ב-Firebase כשאתם שולחים בקשות. כדי למנוע שימוש לא מורשה במפתחות ה-API:

  • מגדירים את Application restrictions במסוף Google Cloud כדי להגביל את השימוש במפתח רק לבקשות ממזהה החבילה הספציפי של האפליקציה (Apple), משם החבילה ומטביעת האצבע מסוג SHA-1‏ (Android) או מהמפנה ב-HTTP (אינטרנט).

  • בודקים את רשימת ההיתרים API restrictions של כל מפתח:

שימו לב שממשקי API שקשורים ל-Firebase משתמשים במפתחות API רק כדי לזהות את הפרויקט או האפליקציה ב-Firebase, ולא כדי לאשר קריאה ל-API.

הגבלת הבקשות למשתמשים מאומתים בלבד

כדאי לשקול לאכוף מצב משתמשים מאומתים כדי שכל הבקשות דרך Firebase AI Logic יכללו פרטי כניסה תקינים מ-Firebase Authentication. אם הבקשה מגיעה ממשתמש קצה לא מאומת, היא נדחית ומוצגת השגיאה 401: unauthenticated.

הגנה על הנחיות והקשחת בקשות

כדי למנוע חשיפה של עיצובי ההנחיות שלכם, אל תאפשרו הידור לאחור של הלקוח, ונעלו את הקצה העורפי כדי שמשתמשים זדוניים לא יוכלו להריץ הנחיות שרירותיות.

שימוש בתבניות לפרומפטים בשרת

השתמשו ב תבניות לפרומפטים בשרת כדי לשמור את הפרומפטים, ההוראות למערכת והגדרות המודל בצורה מאובטחת ב ענן, במקום להטמיע אותם בקוד של אפליקציית הלקוח, שבו אפשר לחלץ אותם באמצעות הידור לאחור של קובץ בינארי.

האפליקציה מפנה רק למזהה תבנית ומעבירה משתני קלט דינמיים. תבניות לפרומפטים בצד השרת גם מאפשרות לעדכן פרומפטים או להחליף מודלים לפי דרישה בלי להוציא גרסה חדשה של האפליקציה.

אימות וניקוי של משתני תבנית שסופקו על ידי הלקוח

תבניות לפרומפטים בצד השרת מגינות על עיצוב הפרומפטים, אבל תבניות שמקבלות משתנים דינמיים עדיין יכולות להיות חשופות להחדרת פרומפטים. התבניות משרשרות את משתני הקלט של המשתמשים להנחיה הסופית, לכן חשוב:

  • חשוב לאמת ולנקות את כל הקלט של המשתמשים בצד הלקוח לפני שמעבירים משתנים לתבנית (למשל, לאכוף מגבלות תווים ופורמטים צפויים).
  • הוסיפו לתבניות הוראות מערכת ברורות שמגדירות את גבולות הגזרה לעיבוד הקלט של המשתמשים.

אכיפת מצב "תבניות בלבד"

אחרי שכל התכונות באפליקציה משתמשות בתבניות לפרומפטים בצד השרת, כדאי לאכוף מצב של תבניות בלבד. כשהמדיניות נאכפת, Firebase AI Logic חוסם את כל הבקשות הישירות ל-Gemini API (403: unauthorized) שלא מבוססות על תבניות, כדי למנוע מגורמים זדוניים לשלוח הנחיות שרירותיות או לנצל לרעה את המכסה.

מעקב, מגבלות וחיובים

לקבל תובנות לגבי התנועה הנכנסת ואנומליות באבטחה, ולהגן על הפרויקט מפני עלייה חדה ובלתי צפויה בשימוש או עלויות בלתי נשלטות.

הגדרת מעקב אחרי שימוש בתכונות AI במסוף Firebase

הגדירו את המעקב אחרי שימוש בתכונות AI במסוף Firebase כדי לקבל גישה למדדים חשובים, כמו מספר הבקשות, זמן האחזור, השימוש בטוקנים ושיעורי השגיאות (כולל כשלים באימות של 401 וחסימות של תבניות בלבד ב-403). אפשר גם לבדוק מעקבים ספציפיים במסוף Google Cloud.

הגדרת הגבלת קצב של יצירת בקשות וניהול מכסות

כדי להגן על הפרויקט מפני עלייה חדה ובלתי צפויה בשימוש ומתקפות DoW:

התראות ותקרות הוצאה שימנעו הפתעות בחשבון

אם הפרויקט ב-Firebase נמצא בתוכנית התמחור Blaze בתשלום לפי שימוש:

השלבים הבאים