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.8 Flash, are available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models will shut down in October 2026 (and new projects cannot start using them). To avoid service disruptions, update to a newer model (like gemini-3.8-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 ולהגדיר אפשרויות של הגנה מפני שידור חוזר.
במסך האחרון, בודקים את ההמלצות לאכיפת 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. פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.

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

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. מוודאים שהגנה בסיסית מופעלת, ואז לוחצים על המשך.
5. כדי להפעיל הגנה מפני הפעלה חוזרת, בוחרים באפשרות לא נאכף (מעקב בלבד) או באפשרות נאכף.
  
  כדי להחליט מתי לאכוף את ההגנה מפני הפעלה חוזרת, כדאי להביא בחשבון את הנקודות הבאות:
  - מומלץ לעקוב אחרי הבקשות אם סביר להניח שמספר משמעותי של משתמשים משתמשים בגרסאות קודמות של האפליקציה בלי שטוקנים לשימוש מוגבל מופעלים. אם תאכפו את ההגנה מפני שידור חוזר באופן מיידי, בקשות מהמשתמשים האלה ייחסמו.
  - אפשר לעקוב באופן ספציפי אחרי המדד לא מאומת: נעשה שימוש חוזר בטוקן, שמייצג את מספר הבקשות שכוללות טוקן שכבר נעשה בו שימוש בבקשה קודמת. אפשר לעקוב אחרי המדד הזה במסוף Firebase (נכנסים אל אבטחה > App Check > הכרטיסייה ממשקי API).
    
    אם חלק משמעותי מהבקשות האחרונות שייך לקטגוריה הזו, כדאי להמתין עד שיותר משתמשים ישדרגו לגרסה של האפליקציה שמשתמשת בטוקנים לשימוש מוגבל, כדי להימנע מהפרעה למשתמשים.

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

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

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

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

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

שאלות נפוצות ופתרון בעיות או קודי שגיאה שקשורים ל-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, חשוב מאוד לאכוף אותה שוב, במיוחד לפני שמבצעים commit של האפליקציה למערכת בקרת קוד מקור שזמינה לכולם, משתפים את האפליקציה או הופכים אותה לזמינה לכולם.

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