Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

The latest Gemini models, like Gemini 3.7 Flash, are available to use with Firebase AI Logic! Learn more.
All Imagen models will shut down as early as August 17, 2026. Learn about migrating your apps to use Nano Banana.
Gemini 2.5 models will shut down in October 2026. To avoid service disruptions, update to a newer model (like gemini-3.7-flash or gemini-3.1-flash-image). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

איך מונעים שימוש לרעה ב-Gemini API באמצעות Firebase App Check

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

הוראות להגדרה

Firebase AI Logic מספק שער פרוקסי שמאפשר לכם לשלב עם Firebase App Check ולהגן על Gemini API כשמתבצעת קריאה ישירה אליו מהאפליקציות לנייד ולאינטרנט. כשמפעילים את App Check עבור Firebase AI Logic, הוא עוזר להגן על Gemini Developer API ועל Agent Platform Gemini API (formerly Vertex AI).

‫App Check for Firebase AI Logic תומך גם בהגנה מפני הפעלה חוזרת, כלומר אפשר להשתמש בטוקן App Check רק פעם אחת.

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

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

החל מ-2 בנובמבר 2026, Firebase App Check האכיפה תהיה חובה כדי להשתמש ב-Firebase AI Logic. מידע נוסף

סיכום כללי של אופן הפעולה של App Check

באמצעות App Check, מכשירים שמריצים את האפליקציה שלכם משתמשים בספק אימות אפליקציה או מכשיר כדי לאמת את אחד מהדברים הבאים או את שניהם:

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

האישור הזה מצורף לכל בקשה שהאפליקציה שולחת באמצעות SDK‏ Firebase AI Logic. כשמפעילים את App Check, בקשות מלקוחות ללא אישור תקף יידחו, וכך גם בקשות שמקורן באפליקציה או בפלטפורמה שלא אישרתם.

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

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

הגדר את App Check

ההוראות הבאות מותאמות להגדרה של Firebase App Checkאכיפה עבור Firebase AI Logic.

שלב 1: הפעלת App Check

החל מתחילת יולי 2026, במהלך תהליך ההגדרה המודרך בFirebaseמסוף, Firebase תאכוף באופן אוטומטי את Firebase App Check עבור Firebase AI Logic כדי לעזור להגן על Gemini API.

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

בודקים אם App Check כבר נאכף עבור Firebase AI Logic.
1. במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה APIs (ממשקי API).
2. מאתרים את השורה של Firebase AI Logic. אם מופיע Unenforced, ממשיכים לשאר ההוראות.
לוחצים על השורה של Firebase AI Logic ורואים את הגרפים של המדדים. מתחת לתרשימים, לוחצים על הגדרה.
במסך הראשון של תיבת הדו-שיח (הגנה בסיסית), בוחרים באפשרות החלה ולוחצים על המשך.
במסך הבא (Replay protection), בוחרים באפשרות Disabled (מושבת) ואז לוחצים על Continue (המשך).

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

לא צריך לרשום את האפליקציות אם רוצים רק לאכוף את App Check ורק להשתמש בספק ניפוי הבאגים עם Firebase AI Logic באפליקציה לפני ההשקה. עם זאת, כשמוכנים להשיק את האפליקציה למשתמשי קצה, צריך לרשום את האפליקציות כחלק מההגדרה של ספק אימות בייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise).

שלב 2: הגדרת ספק ניפוי הבאגים לפיתוח מקומי

בפיתוח מקומי, אפשר להגדיר את App Check ספק אימות לצורכי ניפוי באגים ועדיין להשאיר את App Check נאכף עבור Firebase AI Logic.

Swift

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

בפרויקט Xcode, מייבאים את FirebaseAppCheck ומפעילים את App Check באמצעות יצירת ספק אימות לצורכי ניפוי באגים לפני שמגדירים את Firebase.

import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

קבלת טוקן לניפוי באגים:
1. מפעילים את האפליקציה בסימולטור או במכשיר הבדיקה.
2. פותחים את מסוף Xcode ומחפשים את אסימון הניפוי באגים App Check. לדוגמה:
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

פרטים על ספק הניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי העזרה הרשמיים של App Check.

Kotlin

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

בגרסת build לניפוי באגים, מגדירים את App Check כך שישתמש ב-factory של ספק אימות לצורכי ניפוי באגים:

Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)MainActivity.kt

קבלת טוקן לניפוי באגים:
1. מריצים את האפליקציה באמולטור או במכשיר הבדיקה.
2. מחפשים את אסימון הניפוי באגים App Check ביומנים. לדוגמה:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

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

Java

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

בגרסת build לניפוי באגים, מגדירים את App Check כך שישתמש ב-factory של ספק אימות לצורכי ניפוי באגים:

FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());MainActivity.java

קבלת טוקן לניפוי באגים:
1. מריצים את האפליקציה באמולטור או במכשיר הבדיקה.
2. מחפשים את אסימון הניפוי באגים App Check ביומנים. לדוגמה:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

Web

כך משתמשים בספק אימות לצורכי ניפוי באגים בזמן הפעלת האפליקציה מ-localhost באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):

בגרסת build לניפוי באגים, מפעילים את מצב ניפוי הבאגים על ידי הגדרת self.FIREBASE_APPCHECK_DEBUG_TOKEN ל-true לפני שמפעילים את App Check. לדוגמה:
```
self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });
```
נכנסים לאפליקציית האינטרנט באופן מקומי ופותחים את הכלים למפתחים בדפדפן. במסוף הניפוי באגים יוצג אסימון ניפוי באגים:
```
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.
```
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

פרטים על ספק הניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי העזרה הרשמיים של App Check.

Dart

‫iOS+‎

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

מפעילים את App Check באמצעות ספק אימות לצורכי ניפוי באגים מיד אחרי שמבצעים אתחול של אפליקציית Firebase:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set appleProvider to `AppleProvider.debug`
    appleProvider: AppleProvider.debug,
  );
  runApp(App());
}

מפעילים רישום ביומן של ניפוי באגים בפרויקט Xcode:
1. פותחים את Product (מוצר) > Scheme (סכימה) > Edit scheme (עריכת הסכימה).
2. בתפריט הימני, לוחצים על Run (הפעלה) ואז על הכרטיסייה Arguments (ארגומנטים).
3. בקטע Arguments Passed on Launch (ארגומנטים שהערך שלהם נקבע בהפעלה), מוסיפים את הערך -FIRDebugEnabled.
קבלת טוקן לניפוי באגים:
1. פותחים את ios/Runner.xcworkspace באמצעות Xcode ומריצים את האפליקציה בסימולטור או במכשיר הבדיקה.
2. פותחים את מסוף Xcode ומחפשים את אסימון הניפוי באגים App Check. לדוגמה:
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

Android

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

מפעילים את App Check באמצעות ספק אימות לצורכי ניפוי באגים מיד אחרי שמבצעים אתחול של אפליקציית Firebase:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

קבלת טוקן לניפוי באגים:
1. מריצים את האפליקציה באמולטור או במכשיר הבדיקה.
2. מחפשים את אסימון הניפוי באגים App Check ביומנים. לדוגמה:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. מעתיקים את הטוקן (לדוגמה, 123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

אינטרנט

בקובץ web/index.html, מפעילים את מצב ניפוי הבאגים על ידי הגדרת self.FIREBASE_APPCHECK_DEBUG_TOKEN ל-true:
```
<body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>
```
מריצים את אפליקציית האינטרנט באופן מקומי ופותחים את הכלים למפתחים בדפדפן. במסוף ניפוי הבאגים יופיע אסימון ניפוי באגים:
```
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.
```
הטוקן הזה מאוחסן באופן מקומי בדפדפן שלכם, וישמש אתכם בכל פעם שתשתמשו באפליקציה באותו דפדפן באותו מחשב. אם רוצים להשתמש באסימון בדפדפן אחר או במכונה אחרת, צריך להגדיר את self.FIREBASE_APPCHECK_DEBUG_TOKEN למחרוזת האסימון במקום ל-true.
רושמים את אסימון ניפוי הבאגים ב-App Check:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

פרטים על ספק הניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי העזרה הרשמיים של App Check.

Unity

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

במסוף Firebase, יוצרים אסימון לניפוי באגים:
1. במסוף Firebase, עוברים אל Security > App Check > הכרטיסייה Apps.
2. מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
3. פועלים לפי ההוראות במסך כדי ליצור אסימון חדש לניפוי באגים.

מוסיפים את הקוד הבא לקוד האתחול של האפליקציה:

using Firebase.AppCheck;

void InitializeFirebase() {
  // Configure the Debug Provider factory with your debug token.
  DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");

  // Set App Check to use the debug provider factory
  FirebaseAppCheck.SetAppCheckProviderFactory(
    DebugAppCheckProviderFactory.Instance);

  // Proceed to initialize Firebase as normal
}

פרטים על ספק הניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי העזרה הרשמיים של App Check.

שלב 3: הגדרת App Check למשתמשי קצה ולסביבת ייצור

כשמוכנים לפרסם את האפליקציה למשתמשי הקצה, צריך לרשום את האפליקציות ולהגדיר ספק אימות בסביבת הייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise).

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

נדרשת יצירת מופע מיוחד ב-Flutter אם משתמשים בגרסאות ישנות יותר של הפלאגין

לוחצים על הספק Gemini API כדי לראות בדף הזה תוכן וקוד שספציפיים לספק.

ההפעלה המיוחדת הזו נדרשת רק אם האפליקציה שלכם משתמשת בפלאגין Flutter firebase_ai בגרסה 3.11.0 ומטה (BoM בגרסה 4.12.0 ומטה). אם האפליקציה שלכם משתמשת בגרסה חדשה יותר של הפלאגין, אין צורך ביצירת המופע המיוחד הזה.

אם אתם אוכפים את App Check, באפליקציות Flutter שמשתמשות בגרסאות ישנות יותר של התוסף, אתם צריכים להעביר את App Check באופן מפורש במהלך יצירת המופע, באופן הבא:


// ...

// During instantiation, enable usage of limited-use tokens
final ai = await FirebaseAI.googleAI(
  // For Flutter plugin v3.11.0 or lower (BoM v4.12.0 or lower), pass in App Check explicitly.
  appCheck: FirebaseAppCheck.instance,
  useLimitedUseAppCheckTokens: true,
);

// ...

שיפור ההגנה על ידי הוספת הגנה מפני הפעלת תקיפה חוזרת

מומלץ להשתמש בגרסאות ה-SDK העדכניות ביותר, אבל חשוב לוודא שאתם משתמשים לפחות באחת מהגרסאות הבאות כדי להשתמש בהגנה מפני שידור חוזר:
Apple platforms v12.2.0+ | Android BoM v34.14.0+ (App Check v19.1.0+) | Web v12.14.0+ | Flutter v4.15.0+ (App Check v4.10.0+) | Unity v13.12.0+

כברירת מחדל, App Check משתמש באסימוני סשן עם אורך חיים (TTL) שניתן להגדרה בין 30 דקות לבין 7 ימים. אסימוני הסשן האלה נשמרים במטמון על ידי App Check SDK, נשלחים עם בקשות מהאפליקציה שלכם, ואפשר לעשות בהם שימוש חוזר עד שתוקף ה-TTL שלהם יפוג. שימוש בטוקנים של סשן נחשב להגנה בסיסית.

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

‫App Check יחסום בקשות אל Firebase AI Logic שמשתמשות בטוקנים של סשנים. במקום זאת, App Check יאפשר בקשה ל-Firebase AI Logic רק אם נעשה בה שימוש באסימון חדש לשימוש מוגבל.
אחרי שהטוקן לשימוש מוגבל מאומת, המערכת משתמשת בו כך שאפשר להשתמש בו רק פעם אחת, כדי למנוע מתקפות מסוג Replay.
‫App Check SDK יוצר טוקן חדש לשימוש מוגבל עבור כל בקשה. חשוב לזכור שהתהליך הזה יכול להשפיע על הבקשות שלכם, כי הוא מוסיף להן זמן אחזור, ולפעמים גם עלות (תלוי בספק האישורים).

הגדרה של הגנה מפני הפעלה חוזרת ואכיפה שלה

לוחצים על הספק Gemini API כדי לראות בדף הזה תוכן וקוד שספציפיים לספק.

כך מגדירים ומפעילים הגנה מפני הפעלה חוזרת:

אם עדיין לא עשיתם את זה, צריך להגדיר את App Check לפי ההוראות שמופיעות בחלק הקודם של הדף הזה.

הפעלת השימוש בטוקנים לשימוש מוגבל.

באפליקציה, במהלך יצירת המופע, מגדירים את הפרמטר useLimitedUseAppCheckTokens לערך true:

Swift


// ...

// During instantiation, enable usage of limited-use tokens.
let ai = FirebaseAI.firebaseAI(
  backend: .googleAI(),
  useLimitedUseAppCheckTokens: true
)

// ...

Kotlin


// ...

// During instantiation, enable usage of limited-use tokens.
val ai = Firebase.ai(
  backend = GenerativeBackend.googleAI(),
  useLimitedUseAppCheckTokens = true
)

// ...

Java


// ...

// During instantiation, enable usage of limited-use tokens.
FirebaseAI ai = FirebaseAI.getInstance(
  /* backend: */ GenerativeBackend.googleAI(),
  /* useLimitedUseAppCheckTokens: */ true
);

// ...

Web


// ...

// During instantiation, enable usage of limited-use tokens.
const ai = getAI(firebaseApp, {
  backend: new GoogleAIBackend(),
  useLimitedUseAppCheckTokens: true
});

// ...

Dart


// ...

// During instantiation, enable usage of limited-use tokens
final ai = await FirebaseAI.googleAI(
  useLimitedUseAppCheckTokens: true,
);

// ...

Unity

// ...

// During instantiation, enable usage of limited-use tokens
var ai = FirebaseAI.GetInstance(
  useLimitedUseAppCheckTokens: true
);

// ...

אכיפת הגנה מפני שידור חוזר.
1. בבסיס הקוד של האפליקציה, מוודאים שהפעלתם את השימוש בטוקנים לשימוש מוגבל (ראו את השלב הקודם).
2. במסוף Firebase, עוברים אל Security (אבטחה) >‏ App Check (בדיקת אפליקציות).
3. מרחיבים את תצוגת המדדים של Firebase AI Logic.
4. מוודאים שהאפשרות Baseline protection (הגנה בסיסית) מוגדרת כEnforced (אכיפה), ואז לוחצים על Continue (המשך).
5. בקטע 'הגנה מפני הפעלה חוזרת', בוחרים באפשרות לא נאכף (מעקב בלבד) או באפשרות נאכף.
  
  כדי להחליט מתי לאכוף את ההגנה מפני הפעלה חוזרת, כדאי להביא בחשבון את הנקודות הבאות:
  - מומלץ לעקוב אחרי הבקשות אם סביר להניח שמספר משמעותי של משתמשים משתמשים בגרסאות קודמות של האפליקציה שלכם בלי שטוקנים לשימוש מוגבל מופעלים. אם תפעילו את ההגנה מפני שידור חוזר באופן מיידי, הבקשות מהמשתמשים האלה ייחסמו.
  - אפשר לעקוב באופן ספציפי אחרי המדד Unverified: Reused token, שמייצג את מספר הבקשות שכוללות אסימון שכבר נעשה בו שימוש בבקשה קודמת. אפשר לעקוב אחרי המדד הזה במסוף Firebase (נכנסים אל אבטחה > App Check > הכרטיסייה ממשקי API).
    
    אם חלק משמעותי מהבקשות האחרונות שייך לקטגוריה הזו, תוכלו להימנע משיבוש הפעילות של המשתמשים ולחכות עם הפעלת ההגנה מפני התקפות חוזרות עד שיותר משתמשים יעברו לגרסה של האפליקציה שלכם שמשתמשת בטוקנים לשימוש מוגבל.

הערה: אם רק הפעלתם שימוש באסימונים לשימוש מוגבל, ולא הפעלתם הגנה מפני הפעלה חוזרת, חשוב שתדעו את הדברים הבאים:

ה-TTL של טוקנים לשימוש מוגבל הוא 5 דקות בלבד, ואי אפשר לשנות אותו (בניגוד לטוקנים של סשנים). כשלא נאכפת הגנה מפני שימוש חוזר, אסימונים לשימוש מוגבל דומים לאסימונים של סשן בכך שאפשר לעשות בהם שימוש חוזר עד שתוקף ה-TTL שלהם פג.
גם אם טוקנים לשימוש מוגבל תקפים למשך 5 דקות, ערכת ה-SDK עדיין תיצור טוקן חדש לכל בקשה. בנוסף, ערכות ה-SDK לא שומרות במטמון טוקנים לשימוש מוגבל.
כשההגנה מפני שידור חוזר לא נאכפת, App Check לא חוסם בקשות אל Firebase AI Logic שמשתמשות בטוקנים תקפים של סשן.

איך Firebase AI Logic משתלב עם App Check

כדי להשתמש ב-SDKs‏ Firebase AI Logic צריך להפעיל את Firebase AI Logic API‏ (firebasevertexai.googleapis.com) בפרויקט Firebase. הסיבה לכך היא שבקשות שנשלחות על ידי ערכות ה-SDK של Firebase AI Logic נשלחות קודם לשרת Firebase AI Logic, שמשמש כשער פרוקסי שבו מתבצעת אימות Firebase App Check לפני שהבקשה מקבלת אישור להמשיך אל הקצה העורפי של ספק Gemini API שבחרתם ואל ממשקי ה-API לגישה למודלים של Gemini ושל Imagen.

שאלות נפוצות ופתרון בעיות

אפשר למצוא שאלות נפוצות ופתרון בעיות או קודי שגיאה נוספים שקשורים ל-Firebase AI Logic.

האם צריך לאכוף את App Check בכל הגרסאות של האפליקציה?

כן, צריך לאכוף את App Check בכל הגרסאות של האפליקציה שמשתמשות ב-Firebase AI Logic.

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

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

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

איך מיישמים ומאכפים את App Check באפליקציה שכבר הושקה?

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

ההוראות הבאות יעזרו לכם להעביר את האפליקציה כך שתוכלו לאכוף את App Check באופן שימנע שיבושים בשירותים של אפליקציה שכבר פורסמה ואין לה App Check.

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

לדוגמה, אם כמעט כל הבקשות האחרונות מגיעות מלקוחות מאומתים, כדאי לאכוף את App Check.
אכיפה של App Check עבור Firebase AI Logic.

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

שגיאה 403: `PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

אם קיבלתם שגיאה 403 - PERMISSION_DENIED עם הכיתוב To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, המשמעות היא שבבקשה שלכם אין טוקן App Check תקין, ואתם מנסים לגשת למודל שנעשה בו שימוש לרעה בדרך כלל.

זוהו מודלים גנרטיביים מסוימים שגורמים זדוניים נוהגים לנצל לרעה.

מכיוון שלא הפעלת את App Check עבור Firebase AI Logic, הפרויקט שלך חשוף לניצול לרעה של המודלים האלה. כדי להגן על המפתחים שלנו, Firebase חוסם את הגישה למודלים האלה אלא אם הבקשה כוללת טוקן App Check תקין (כלומר, App Check נאכף עבור Firebase AI Logic).

כדי לגשת למודל שהחזיר את השגיאה, צריך לבצע את הפעולות הבאות:

הגדרה של App Check עבור Firebase AI Logic לפיתוח מקומי, חשוב להגדיר את App Check ספק ניפוי הבאגים.

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

הבקשה הזו תשלח עם טוקן App Check תקין, ולא תקבלו יותר את השגיאה 403 - PERMISSION_DENIED.
לפני שמשחררים את האפליקציה למשתמשי הקצה, צריך להגדיר ספק אימות ייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise) כדי שמשתמשי הקצה יוכלו לגשת לתכונת ה-AI כשתהליך App Check ייאכף.

שגיאה 403: `PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

אם מופיעה השגיאה 403 - PERMISSION_DENIED עם הכיתוב Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, סימן שהפרויקט שלכם ב-Firebase זוהה כלא פעיל ולא הופעל בו App Check עבור Firebase AI Logic.

'פרויקטים לא פעילים' הם פרויקטים שבהם Firebase AI Logic מופעל, אבל לא נעשה בהם שימוש לאחרונה ב-Firebase AI Logic.

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

כשרוצים לחזור להשתמש ב-Firebase AI Logic, צריך לבצע את הפעולות הבאות:

הגדרה של App Check עבור Firebase AI Logic לפיתוח מקומי, חשוב להגדיר את App Check ספק ניפוי הבאגים.

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

הבקשה הזו תשלח עם טוקן App Check תקין, ולא תקבלו יותר את השגיאה 403 - PERMISSION_DENIED.
לפני שמשחררים את האפליקציה למשתמשי הקצה, צריך להגדיר ספק אימות ייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise) כדי שמשתמשי הקצה יוכלו לגשת לתכונת ה-AI כשתהליך App Check ייאכף.

אכיפה של App Check ללא ספק אימות בייצור (ספק לניפוי באגים בלבד)

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

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

ביטול האכיפה App Check (לא מומלץ)

אזהרה: השבתת האכיפה של App Check עבור Firebase AI Logic לא מומלצת בשום אופן. אם App Check לא נאכף עבור Firebase AI Logic, ‏ Gemini API חשוף לניצול לרעה.

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

אם אתם מבטלים את האכיפה של App Check כי אתם רק מתחילים להשתמש ב-Firebase AI Logic או מנסים אותה, מומלץ מאוד להגדיר את ספק ניפוי הבאגים לפיתוח מקומי במקום לבטל את האכיפה של App Check.

החל מ-2 בנובמבר 2026, Firebase App Check תהיה חובה להשתמש באכיפה כדי להשתמש ב-Firebase AI Logic, ולא תהיה אפשרות לבטל את האכיפה. מידע נוסף

בודקים אם App Check נאכף עבור Firebase AI Logic.
1. במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה APIs (ממשקי API).
2. מאתרים את השורה של Firebase AI Logic. אם מופיע Enforced, ממשיכים לשאר ההוראות.
לוחצים על השורה של Firebase AI Logic ורואים את הגרפים של המדדים. מתחת לתרשימים, לוחצים על הגדרה.
במסך הראשון של תיבת הדו-שיח (Baseline protection), בוחרים באפשרות Unenforced (monitoring only) ולוחצים על Continue.
במסך הבא (Replay protection), בוחרים באפשרות Disabled (מושבת) ואז לוחצים על Continue (המשך).
במסך האחרון, לוחצים על המשך כדי לבטל את האכיפה של App Check.

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

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

סיכום כללי של אופן הפעולה של App Check

הגדר את App Check

שלב 1: הפעלת App Check

שלב 2: הגדרת ספק ניפוי הבאגים לפיתוח מקומי

Swift

Kotlin

Java

Web

Dart

‫iOS+‎

Android

אינטרנט

Unity

שלב 3: הגדרת App Check למשתמשי קצה ולסביבת ייצור

שיפור ההגנה על ידי הוספת הגנה מפני הפעלת תקיפה חוזרת

הגדרה של הגנה מפני הפעלה חוזרת ואכיפה שלה

Swift

Kotlin

Java

Web

Dart

Unity

איך Firebase AI Logic משתלב עם App Check

שאלות נפוצות ופתרון בעיות

האם צריך לאכוף את App Check בכל הגרסאות של האפליקציה?

איך מיישמים ומאכפים את App Check באפליקציה שכבר הושקה?

שגיאה 403: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

שגיאה 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

אכיפה של App Check ללא ספק אימות בייצור (ספק לניפוי באגים בלבד)

ביטול האכיפה App Check (לא מומלץ)

איך מונעים שימוש לרעה ב-Gemini API באמצעות Firebase App Check

שגיאה 403: `PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`

שגיאה 403: `PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check`