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 menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mencegah penyalahgunaan Gemini API dengan Firebase App Check

Saat Anda memanggil API secara langsung dari aplikasi seluler atau web, API rentan terhadap penyalahgunaan oleh klien yang tidak sah. Jika Anda ingin memanggil Gemini API secara langsung dari aplikasi seluler atau web, Anda harus membantu melindunginya dari penyalahgunaan dengan menggunakan Firebase AI Logic dan menerapkan Firebase App Check. Saat Anda menerapkan App Check, hanya permintaan masuk yang diverifikasi berasal dari aplikasi Anda yang sebenarnya dan/atau perangkat yang tidak dimodifikasi yang akan diizinkan.

Langsung ke petunjuk penyiapan

Firebase AI Logic menyediakan gateway proxy yang memungkinkan Anda berintegrasi dengan Firebase App Check dan melindungi Gemini API saat dipanggil langsung oleh aplikasi seluler dan web Anda. Jika App Check diterapkan untuk Firebase AI Logic, tindakan ini akan membantu melindungi Gemini Developer API dan Agent Platform Gemini API (formerly Vertex AI).

App Check untuk Firebase AI Logic juga mendukung perlindungan replay, yang berarti token App Check hanya dapat digunakan satu kali.

Sangat penting agar App Check diterapkan sedini mungkin — terutama sebelum Anda melakukan commit aplikasi ke sistem kontrol kode sumber yang tersedia secara publik, membagikan aplikasi, atau membuat aplikasi Anda tersedia secara publik.

Mulai awal Juli 2026, selama alur kerja penyiapan di konsol Firebase, Firebase akan otomatis menerapkan App Check untuk Firebase AI Logic. Jika Anda telah menyiapkan Firebase AI Logic di project Firebase sebelum awal Juli 2026 (atau App Check tidak diterapkan karena alasan lain), maka Anda dapat menerapkan App Check sendiri. Untuk pengalaman memulai yang lebih mudah atau untuk pengembangan lokal, Anda dapat menerapkan App Check, lalu menyiapkan App Check penyedia debug.

Mulai 2 November 2026, penerapan Firebase App Check akan diwajibkan untuk menggunakan Firebase AI Logic. Pelajari lebih lanjut.

Ringkasan umum cara kerja App Check

Dengan App Check, perangkat yang menjalankan aplikasi Anda menggunakan penyedia pengesahan aplikasi atau perangkat yang memverifikasi salah satu atau kedua hal berikut:

Permintaan berasal dari aplikasi asli milik Anda
Permintaan berasal dari perangkat asli yang tidak dimodifikasi

Pengesahan ini dilampirkan pada setiap permintaan yang dibuat aplikasi Anda menggunakan SDK Firebase AI Logic. Jika App Check diterapkan, permintaan dari klien tanpa pengesahan yang valid akan ditolak, begitu juga permintaan yang berasal dari aplikasi atau platform yang belum Anda beri otorisasi.

Saat menyiapkan App Check, pertimbangkan untuk menambahkan perlindungan replay, yang membuat token App Check hanya dapat digunakan satu kali. Opsi ini menawarkan perlindungan yang ditingkatkan di luar perlindungan dasar dan memungkinkan Anda menetapkan tingkat perlindungan yang sesuai untuk aplikasi dan kasus penggunaan Anda.

Anda dapat menemukan informasi mendetail tentang App Check dalam dokumentasinya, termasuk deskripsi penyedia pengesahan serta kuota dan batas yang berlaku.

Siapkan App Check

Petunjuk berikut dioptimalkan untuk menyiapkan Firebase App Check penerapan untuk Firebase AI Logic.

Langkah 1: Terapkan App Check

Mulai awal Juli 2026, selama alur kerja penyiapan terpandu di konsol Firebase, Firebase akan otomatis menerapkan Firebase App Check untuk Firebase AI Logic guna membantu melindungi Gemini API.

Namun, jika Anda telah menyiapkan Firebase AI Logic di project Firebase sebelum awal Juli 2026 (atau App Check tidak diterapkan karena alasan lain), Anda dapat menerapkan App Check sendiri menggunakan petunjuk berikut.

Periksa apakah App Check sudah diterapkan untuk Firebase AI Logic.
1. Di konsol Firebase, buka tab Security > App Check > APIs.
2. Cari baris untuk Firebase AI Logic. Jika tertulis Unenforced, lanjutkan dengan petunjuk lainnya.
Klik baris untuk Firebase AI Logic, dan Anda akan melihat grafik metrik. Di bawah grafik tersebut, klik Siapkan.
Di layar pertama dialog (Perlindungan dasar), pilih Diterapkan, lalu klik Lanjutkan.
Di layar berikutnya (Perlindungan replay), pilih Dinonaktifkan, lalu klik Lanjutkan.

Catatan: Menyiapkan perlindungan replay memerlukan Anda untuk mengaktifkan token penggunaan terbatas di aplikasi. Setelah melakukannya, Anda dapat kembali ke konsol Firebase nanti dan menyiapkan opsi perlindungan replay.
Di layar terakhir, tinjau pertimbangan untuk menerapkan App Check guna memastikan bahwa Anda siap menerapkan App Check. Jika sudah siap, klik Lanjutkan.

Anda tidak perlu mendaftarkan aplikasi jika hanya ingin menerapkan App Check dan hanya menggunakan penyedia debug dengan Firebase AI Logic di aplikasi praproduksi. Namun, saat Anda siap merilis aplikasi kepada pengguna akhir, Anda harus mendaftarkan aplikasi sebagai bagian dari penyiapan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise).

Langkah 2: Siapkan penyedia debug untuk pengembangan lokal

Untuk pengembangan lokal, Anda dapat menyiapkan penyedia debug App Check dan tetap menerapkan App Check untuk Firebase AI Logic.

Swift

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda di simulator secara interaktif (misalnya, selama pengembangan lokal):

Di project Xcode, impor FirebaseAppCheck dan lakukan inisialisasi App Check dengan factory penyedia debug sebelum Anda mengonfigurasi 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()
      }
    }
  }
}

Dapatkan token debug Anda:
1. Luncurkan aplikasi di simulator atau di perangkat pengujian Anda.
2. Buka konsol Xcode dan cari token debug App Check. Contoh:
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Kotlin

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

Pada build debug, konfigurasi App Check untuk menggunakan factory penyedia debug:

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

Dapatkan token debug Anda:
1. Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
2. Cari token debug App Check di log Anda. Contoh:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Java

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

Pada build debug, konfigurasi App Check untuk menggunakan factory penyedia debug:

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

Dapatkan token debug Anda:
1. Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
2. Cari token debug App Check di log Anda. Contoh:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Web

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda dari localhost secara interaktif (misalnya, selama pengembangan lokal):

Dalam build debug, aktifkan mode debug dengan menetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke true sebelum Anda melakukan inisialisasi App Check. Contoh:
```
self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });
```

Buka aplikasi web Anda secara lokal, lalu buka alat developer browser. Di konsol debug, Anda akan melihat token debug:

AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Dart

iOS+

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda di simulator secara interaktif (misalnya, selama pengembangan lokal):

Aktifkan App Check dengan penyedia debug tepat setelah Anda menginisialisasi aplikasi 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());
}

Aktifkan logging debug dalam project Xcode Anda:
1. Buka Product > Scheme > Edit scheme.
2. Pilih Run dari menu kiri, lalu pilih tab Arguments.
3. Di bagian Arguments Passed on Launch, tambahkan -FIRDebugEnabled.
Dapatkan token debug Anda:
1. Buka ios/Runner.xcworkspace dengan Xcode dan jalankan aplikasi Anda di simulator atau di perangkat pengujian.
2. Buka konsol Xcode dan cari token debug App Check. Contoh:
```
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
```
3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Android

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

Aktifkan App Check dengan penyedia debug tepat setelah Anda menginisialisasi aplikasi 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());
}

Dapatkan token debug Anda:
1. Jalankan aplikasi Anda di emulator atau di perangkat pengujian Anda.
2. Cari token debug App Check di log Anda. Contoh:
```
D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
```
3. Salin token (misalnya, 123a4567-b89c-12d3-e456-789012345678).
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Web

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi Anda dari localhost secara interaktif (misalnya, selama pengembangan lokal):

Dalam file web/index.html, aktifkan mode debug dengan menetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke true:
```
<body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>
```
Jalankan aplikasi web Anda secara lokal, lalu buka alat developer browser. Di konsol debug, Anda akan melihat token debug:
```
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.
```
Token ini disimpan secara lokal di browser dan akan digunakan setiap kali Anda menggunakan aplikasi di browser yang sama pada mesin yang sama. Jika Anda ingin menggunakan token di browser lain atau di mesin lain, tetapkan self.FIREBASE_APPCHECK_DEBUG_TOKEN ke string token, bukan true.
Daftarkan token debug Anda dengan App Check:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk mendaftarkan token debug Anda.

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Unity

Berikut cara menggunakan penyedia debug saat menjalankan aplikasi di emulator secara interaktif (misalnya, selama pengembangan lokal):

Di konsol Firebase, buat token debug:
1. Di konsol Firebase, buka Security > App Check > tab Aplikasi.
2. Temukan aplikasi Anda, klik menu tambahan (), lalu pilih Kelola token debug.
3. Ikuti petunjuk di layar untuk membuat token debug baru.

Dalam kode inisialisasi aplikasi Anda, tambahkan kode berikut:

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
}

Untuk mengetahui detail tentang penyedia debug (termasuk cara mendapatkan token debug baru), lihat dokumen App Check resmi.

Langkah 3: Siapkan App Check untuk pengguna akhir dan produksi

Jika Anda siap merilis aplikasi kepada pengguna akhir, Anda harus mendaftarkan aplikasi dan menyiapkan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise).

Pilih penyedia pengesahan produksi, dan ikuti petunjuk penerapan di link berikut:
- Platform Apple: DeviceCheck atau App Attest atau reCAPTCHA Enterprise
- Android: Play Integrity atau reCAPTCHA Enterprise
- Web: reCAPTCHA Enterprise
- Flutter: Mendukung semua penyedia di atas, termasuk reCAPTCHA Enterprise
  Jika Anda menggunakan versi plugin yang lebih lama, lihat catatan tentang instansiasi khusus di bawah untuk Flutter dan App Check.
- Unity: Mendukung semua penyedia di atas (dukungan untuk reCAPTCHA Enterprise akan segera hadir)
Perhatikan bahwa jika tidak ada penyedia pengesahan ini yang memadai untuk kebutuhan Anda, Anda dapat menerapkan penyedia kustom yang menggunakan penyedia pengesahan pihak ketiga atau teknik pengesahan Anda sendiri.
(Direkomendasikan) Tingkatkan perlindungan dengan menambahkan perlindungan replay, yang berarti token App Check hanya dapat digunakan satu kali.

Instansiasi khusus diperlukan untuk Flutter jika menggunakan versi plugin yang lebih lama

Klik penyedia Gemini API untuk melihat konten dan kode khusus penyedia di halaman ini.

Instansiasi khusus ini hanya diperlukan jika aplikasi Anda menggunakan plugin Flutter firebase_ai v3.11.0 atau yang lebih rendah (BoM v4.12.0 atau yang lebih rendah). Jika aplikasi Anda menggunakan plugin versi yang lebih baru, instansiasi khusus ini tidak diperlukan.

Jika Anda menerapkan App Check, maka di aplikasi Flutter yang menggunakan plugin versi lama, Anda harus meneruskan App Check secara eksplisit selama pembuatan instance, seperti berikut:


// ...

// 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,
);

// ...

Meningkatkan perlindungan dengan menambahkan perlindungan dari serangan replay

Sebaiknya gunakan versi SDK terbaru, tetapi pastikan Anda menggunakan minimal salah satu versi berikut untuk menggunakan perlindungan replay:
Platform Apple 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+

Secara default, App Check menggunakan token sesi yang memiliki time to live (TTL) yang dapat dikonfigurasi antara 30 menit dan 7 hari. Token sesi ini di-cache oleh App Check SDK, dikirim bersama dengan permintaan dari aplikasi Anda, dan dapat digunakan kembali hingga TTL-nya berakhir. Penggunaan token sesi dianggap sebagai perlindungan dasar.

Namun, Anda dapat meningkatkan perlindungan di luar perlindungan dasar ini dengan menerapkan perlindungan replay, yang menggunakan token penggunaan terbatas. Jika perlindungan replay diterapkan, hal berikut akan terjadi:

App Check akan memblokir permintaan ke Firebase AI Logic yang menggunakan token sesi. Sebagai gantinya, App Check hanya akan mengizinkan permintaan ke Firebase AI Logic jika permintaan tersebut menggunakan token penggunaan terbatas yang baru dibuat.
Setelah token penggunaan terbatas diverifikasi, token tersebut akan digunakan sehingga hanya dapat digunakan satu kali, yang mencegah replay secara masif.
SDK App Check menghasilkan token penggunaan terbatas baru untuk setiap permintaan. Perhatikan bahwa proses ini dapat memengaruhi permintaan Anda dengan menambahkan beberapa latensi dan terkadang biaya (bergantung pada penyedia pengesahan Anda).

Menyiapkan dan menerapkan perlindungan replay

Klik penyedia Gemini API untuk melihat konten dan kode khusus penyedia di halaman ini.

Berikut cara menyiapkan dan menerapkan perlindungan replay:

Jika Anda belum melakukannya, siapkan App Check dengan mengikuti petunjuk sebelumnya di halaman ini.

Aktifkan penggunaan token penggunaan terbatas.

Di aplikasi Anda selama pembuatan instance, setel parameter useLimitedUseAppCheckTokens ke 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
);

// ...

Terapkan perlindungan replay.
1. Di codebase aplikasi, pastikan Anda telah mengaktifkan penggunaan token penggunaan terbatas (lihat langkah sebelumnya).
2. Di konsol Firebase, buka Security > App Check.
3. Luaskan tampilan metrik untuk Firebase AI Logic.
4. Pastikan Perlindungan dasar Diterapkan, lalu klik Lanjutkan.
5. Untuk perlindungan replay, pilih Tidak diterapkan (hanya pemantauan) atau Diterapkan.
  
  Pertimbangkan hal berikut untuk memutuskan kapan harus menerapkan perlindungan replay:
  - Memantau permintaan Anda direkomendasikan jika sejumlah besar pengguna Anda kemungkinan menggunakan aplikasi versi sebelumnya tanpa mengaktifkan penggunaan token penggunaan terbatas. Jika Anda menerapkan perlindungan replay secara langsung, permintaan dari pengguna tersebut akan diblokir.
  - Anda dapat memantau secara khusus metrik Tidak terverifikasi: Token yang digunakan ulang, yaitu jumlah permintaan yang memiliki token yang telah digunakan dalam permintaan sebelumnya. Pantau metrik ini di konsol Firebase (buka Security > App Check > tab API).
    
    Jika sebagian besar permintaan terbaru termasuk dalam kategori ini, Anda dapat menghindari gangguan pada pengguna dan mempertimbangkan untuk menunggu hingga lebih banyak pengguna mengupdate ke versi aplikasi Anda yang menggunakan token penggunaan terbatas sebelum menerapkan perlindungan replay.

Catatan: Perhatikan hal berikut jika Anda hanya mengaktifkan penggunaan token penggunaan terbatas, dan Anda tidak menerapkan perlindungan serangan replay:

Token penggunaan terbatas memiliki TTL hanya 5 menit, dan TTL tidak dapat disesuaikan (tidak seperti token sesi). Jika perlindungan serangan replay tidak diterapkan, token penggunaan terbatas mirip dengan token sesi karena dapat digunakan kembali hingga TTL-nya berakhir.
Meskipun token penggunaan terbatas berlaku selama 5 menit, SDK akan tetap membuat token baru untuk setiap permintaan. Selain itu, SDK tidak menyimpan token penggunaan terbatas dalam cache.
Jika perlindungan replay tidak diterapkan, App Check tidak akan memblokir permintaan ke Firebase AI Logic yang menggunakan token sesi yang valid.

Memahami cara Firebase AI Logic berintegrasi dengan App Check

Untuk menggunakan SDK Firebase AI Logic, Firebase AI Logic API (firebasevertexai.googleapis.com) harus diaktifkan di project Firebase Anda. Hal ini karena permintaan yang dibuat oleh SDK Firebase AI Logic dikirim terlebih dahulu ke server Firebase AI Logic, yang bertindak sebagai gateway proxy tempat verifikasi Firebase App Check dilakukan sebelum permintaan diizinkan untuk dilanjutkan ke backend penyedia "Gemini API" yang Anda pilih dan API untuk mengakses model Gemini dan Imagen.

FAQ dan pemecahan masalah

Temukan FAQ dan pemecahan masalah tambahan atau kode error terkait Firebase AI Logic.

Apakah saya perlu menerapkan App Check untuk semua versi aplikasi saya?

Ya, App Check harus diterapkan untuk semua versi aplikasi Anda yang menggunakan Firebase AI Logic.

App Check harus diterapkan sedini mungkin — terutama sebelum Anda melakukan commit aplikasi ke sistem kontrol kode sumber yang tersedia secara publik, membagikan aplikasi, atau membuat aplikasi tersedia secara publik.

Jika Anda menerapkan App Check di codebase aplikasi Anda secara langsung, semua versi aplikasi Anda dapat mengirim token App Check yang valid. Permintaan yang tidak mengirim token valid dianggap tidak terverifikasi dan akan diblokir saat App Check diterapkan.

Jika Anda telah merilis versi aplikasi kepada pengguna akhir yang tidak menerapkan App Check, lihat FAQ tentang cara menerapkan dan menerapkan App Check untuk aplikasi yang sudah dirilis.

Bagaimana cara menerapkan dan memberlakukan App Check untuk aplikasi yang sudah dirilis?

Untuk versi aplikasi yang tidak menerapkan App Check, permintaan ke Firebase AI Logic dari versi tersebut tidak memiliki token App Check yang valid dan dianggap tidak terverifikasi. Permintaan ini akan diblokir saat App Check diterapkan untuk Firebase AI Logic.

Petunjuk berikut membantu Anda memigrasikan aplikasi sehingga Anda dapat menerapkan App Check dengan cara yang menghindari gangguan layanan untuk aplikasi yang sudah dirilis dan tidak memiliki App Check.

Terapkan penyedia pengesahan produksi di aplikasi Anda sesegera mungkin.
- Platform Apple: DeviceCheck atau App Attest atau reCAPTCHA Enterprise
- Android: Play Integrity atau reCAPTCHA Enterprise
- Web: reCAPTCHA Enterprise
- Flutter: Mendukung semua penyedia di atas, termasuk reCAPTCHA Enterprise
- Unity: Mendukung semua penyedia di atas (dukungan untuk reCAPTCHA Enterprise akan segera hadir)
Catatan: Saat menerapkan App Check, pertimbangkan untuk mengaktifkan penggunaan token penggunaan terbatas agar Anda memiliki opsi untuk perlindungan yang lebih baik menggunakan perlindungan replay, yang berarti token App Check hanya dapat digunakan satu kali.
Pantau permintaan dari aplikasi Anda untuk membantu Anda memutuskan kapan aman untuk menerapkan App Check.

Misalnya, jika hampir semua permintaan terbaru berasal dari klien terverifikasi, sebaiknya terapkan App Check.
Terapkan App Check untuk Firebase AI Logic.

Peringatan: Jika Anda belum menerapkan App Check untuk Firebase AI Logic pada 2 November 2026, akan diterapkan secara otomatis. Pelajari lebih lanjut.
Untuk pengembangan lokal saat App Check diterapkan, Anda dapat menyiapkan penyedia debug App Check dan tetap menerapkan App Check untuk Firebase AI Logic.

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

Jika Anda menerima error 403 - PERMISSION_DENIED yang menyatakan To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, artinya permintaan Anda tidak memiliki token App Check yang valid dan Anda berupaya mengakses model yang sering disalahgunakan.

Beberapa model generatif telah diidentifikasi sebagai model yang umum disalahgunakan oleh pelaku kejahatan.

Karena Anda tidak menerapkan App Check untuk Firebase AI Logic, proyek Anda rentan terhadap penyalahgunaan model ini. Untuk membantu melindungi developer kami, Firebase memblokir akses ke model ini kecuali jika permintaan menyertakan token App Check yang valid (artinya App Check diterapkan untuk Firebase AI Logic).

Jika Anda ingin mengakses model yang menampilkan error, lakukan hal berikut:

Siapkan App Check untuk Firebase AI Logic. Untuk pengembangan lokal, pastikan Anda menyiapkan App Check penyedia debug.

Menerapkan App Check sangat penting untuk membantu melindungi model Gemini API dan Gemini dari penyalahgunaan, dan penerapannya diperlukan untuk mengatasi error ini.
Kirim ulang permintaan dari aplikasi Anda ke Firebase AI Logic.

Permintaan ini akan mengirimkan token App Check yang valid, dan Anda tidak akan lagi mendapatkan error 403 - PERMISSION_DENIED ini.
Sebelum merilis aplikasi kepada pengguna akhir, Anda perlu menyiapkan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise) agar pengguna akhir dapat mengakses fitur AI Anda saat App Check diterapkan.

Error 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`

Jika Anda menerima error 403 - PERMISSION_DENIED yang menyatakan 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, artinya project Firebase Anda telah diidentifikasi sebagai tidak aktif dan Anda tidak menerapkan App Check untuk Firebase AI Logic.

"Project tidak aktif" adalah project yang mengaktifkan Firebase AI Logic, tetapi tidak memiliki penggunaan Firebase AI Logic baru-baru ini.

Karena Anda tidak menerapkan App Check untuk Firebase AI Logic, project Anda rentan terhadap penyalahgunaan Gemini API. Untuk membantu melindungi project Anda, Firebase menonaktifkan penggunaan Firebase AI Logic hingga Anda menerapkan App Check untuk Firebase AI Logic.

Jika Anda sudah siap untuk mulai menggunakan Firebase AI Logic lagi, lakukan langkah-langkah berikut:

Siapkan App Check untuk Firebase AI Logic. Untuk pengembangan lokal, pastikan Anda menyiapkan App Check penyedia debug.

Menerapkan App Check sangat penting untuk membantu melindungi model Gemini API dan Gemini dari penyalahgunaan, dan penerapannya diperlukan untuk mengatasi error ini.
Kirim ulang permintaan dari aplikasi Anda ke Firebase AI Logic.

Permintaan ini akan mengirimkan token App Check yang valid, dan Anda tidak akan lagi mendapatkan error 403 - PERMISSION_DENIED ini.
Sebelum merilis aplikasi kepada pengguna akhir, Anda perlu menyiapkan penyedia pengesahan produksi (seperti App Attest, Play Integrity, atau reCAPTCHA Enterprise) agar pengguna akhir dapat mengakses fitur AI Anda saat App Check diterapkan.

Menerapkan App Check tanpa penyedia pengesahan produksi (khusus penyedia debug)

Anda dapat menerapkan App Check untuk Firebase AI Logic tanpa mendaftarkan aplikasi Anda ke penyedia pengesahan produksi. Sebagai gantinya, Anda dapat menyiapkan App Check penyedia debug. Penyiapan ini berguna untuk pengembangan lokal atau jika Anda baru mulai menggunakan atau mencoba Firebase AI Logic.

Di bagian awal halaman ini, Anda dapat menemukan petunjuk yang dioptimalkan untuk menyiapkan App Check untuk Firebase AI Logic, termasuk menerapkan App Check dan menyiapkan App Check penyedia debug.

Membatalkan penerapan App Check (sangat TIDAK direkomendasikan)

Peringatan: Tidak menerapkan App Check untuk Firebase AI Logic adalah SANGAT TIDAK direkomendasikan. Jika App Check tidak diterapkan untuk Firebase AI Logic, Gemini API rentan terhadap penyalahgunaan.

Namun, jika Anda memilih untuk tidak menerapkan App Check, Anda harus menerapkannya lagi — terutama sebelum Anda melakukan aplikasi ke sistem kontrol kode sumber yang tersedia secara publik, membagikan aplikasi, atau membuat aplikasi Anda tersedia secara publik.

Jika Anda membatalkan penerapan App Check karena baru mulai menggunakan atau mencoba Firebase AI Logic, sebaiknya siapkan penyedia debug untuk pengembangan lokal daripada membatalkan penerapan App Check.

Mulai 2 November 2026, penerapan Firebase App Check akan diwajibkan untuk menggunakan Firebase AI Logic, dan Anda tidak akan dapat membatalkan penerapannya. Pelajari lebih lanjut.

Periksa apakah App Check diterapkan untuk Firebase AI Logic.
1. Di konsol Firebase, buka tab Security > App Check > APIs.
2. Cari baris untuk Firebase AI Logic. Jika tertulis Enforced, lanjutkan dengan petunjuk lainnya.
Klik baris untuk Firebase AI Logic, dan Anda akan melihat grafik metrik. Di bawah grafik tersebut, klik Siapkan.
Di layar pertama dialog (Perlindungan dasar), pilih Tidak diterapkan (hanya pemantauan), lalu klik Lanjutkan.
Di layar berikutnya (Perlindungan replay), pilih Dinonaktifkan, lalu klik Lanjutkan.
Di layar terakhir, klik Lanjutkan untuk membatalkan penerapan App Check.

Jika App Check tidak diterapkan untuk Firebase AI Logic, Gemini API rentan terhadap penyalahgunaan.
Pastikan Anda menerapkan App Check lagi — terutama sebelum Anda melakukan commit aplikasi ke sistem kontrol kode sumber yang tersedia secara publik, membagikan aplikasi, atau membuat aplikasi tersedia secara publik.

Mencegah penyalahgunaan Gemini API dengan Firebase App Check Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan umum cara kerja App Check

Siapkan App Check

Langkah 1: Terapkan App Check

Langkah 2: Siapkan penyedia debug untuk pengembangan lokal

Swift

Kotlin

Java

Web

Dart

iOS+

Android

Web

Unity

Langkah 3: Siapkan App Check untuk pengguna akhir dan produksi

Meningkatkan perlindungan dengan menambahkan perlindungan dari serangan replay

Menyiapkan dan menerapkan perlindungan replay

Swift

Kotlin

Java

Web

Dart

Unity

Memahami cara Firebase AI Logic berintegrasi dengan App Check

FAQ dan pemecahan masalah

Apakah saya perlu menerapkan App Check untuk semua versi aplikasi saya?

Bagaimana cara menerapkan dan memberlakukan App Check untuk aplikasi yang sudah dirilis?

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

Error 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

Menerapkan App Check tanpa penyedia pengesahan produksi (khusus penyedia debug)

Membatalkan penerapan App Check (sangat TIDAK direkomendasikan)

Mencegah penyalahgunaan Gemini API dengan Firebase App Check

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

Error 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`