Checklist keamanan untuk menggunakan Firebase AI Logic

Saat Anda memanggil Gemini API langsung dari aplikasi seluler dan web, melindungi infrastruktur backend, kuota, dan perintah eksklusif Anda memerlukan pendekatan defense in depth berlapis. Tinjau checklist ini untuk menerapkan praktik terbaik keamanan yang direkomendasikan untuk Firebase AI Logic.

Verifikasi aplikasi, perangkat, dan pengguna

Memverifikasi bahwa permintaan masuk berasal dari instance aplikasi Anda yang sah dan tidak dimodifikasi, yang berjalan di perangkat asli, serta dari pengguna asli.

Terapkan Firebase App Check

Terapkan Firebase App Check untuk membantu melindungi Gemini API dari penyalahgunaan saat dipanggil langsung dari aplikasi Anda. Saat App Check diterapkan, fitur ini akan memverifikasi bahwa permintaan masuk berasal dari aplikasi asli Anda dan/atau perangkat yang tidak dimodifikasi.

App Check mendukung penyedia pengesahan untuk platform Apple (DeviceCheck, App Attest, atau reCAPTCHA Enterprise), Android (Play Integrity atau reCAPTCHA Enterprise), dan Web (reCAPTCHA Enterprise). Layanan ini juga mendukung semua penyedia ini untuk aplikasi Flutter dan Unity.

Pada 2 November 2026, Firebase otomatis menerapkan App Check untuk Firebase AI Logic di semua project guna membantu melindungi Gemini API dari penyalahgunaan. Untuk pengembangan lokal, Anda dapat menyiapkan App Check penyedia debug, lalu mendaftarkan aplikasi Anda ke penyedia pengesahan produksi sebelum merilisnya kepada pengguna akhir.

Mengaktifkan perlindungan replay dengan token penggunaan terbatas

Sebagai bagian dari penyiapan App Check, pertimbangkan untuk menerapkan perlindungan replay sehingga 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.

Menyiapkan pembatasan untuk kunci API Firebase Anda

Kunci API Firebase mengidentifikasi project dan aplikasi Firebase Anda saat membuat permintaan. Untuk mencegah penggunaan kunci API Anda secara tidak sah:

  • Tetapkan "Pembatasan aplikasi" di Google Cloud console untuk membatasi penggunaan kunci hanya pada permintaan dari ID paket tertentu aplikasi Anda (Apple), nama paket dan sidik jari SHA-1 (Android), atau perujuk HTTP (Web).

  • Tinjau daftar yang diizinkan "Pembatasan API" setiap kunci:

Perhatikan bahwa API terkait Firebase hanya menggunakan kunci API untuk mengidentifikasi project atau aplikasi Firebase, bukan untuk otorisasi guna memanggil API.

Membatasi permintaan hanya untuk pengguna yang diautentikasi

Pertimbangkan untuk menerapkan mode pengguna yang diautentikasi sehingga semua permintaan melalui Firebase AI Logic harus menyertakan kredensial yang valid dari Firebase Authentication. Jika permintaan berasal dari pengguna akhir yang tidak diautentikasi, permintaan akan ditolak dengan error 401: unauthenticated.

Perlindungan perintah dan penguatan permintaan

Cegah dekompilasi klien agar tidak mengekspos desain perintah Anda, dan kunci backend Anda agar pengguna berbahaya tidak dapat menjalankan perintah arbitrer.

Menggunakan template perintah server

Gunakan template perintah server untuk menyimpan perintah, petunjuk sistem, dan konfigurasi model dengan aman di cloud, bukan melakukan hard code dalam kode aplikasi klien yang dapat diekstrak menggunakan dekompilasi biner.

Aplikasi Anda hanya mereferensikan ID template dan meneruskan variabel input dinamis. Template perintah server juga memungkinkan Anda memperbarui perintah atau beralih model sesuai permintaan tanpa merilis versi baru aplikasi Anda.

Memvalidasi dan membersihkan variabel template yang disediakan klien

Template perintah server melindungi desain perintah Anda, tetapi template yang menerima variabel dinamis masih dapat rentan terhadap prompt injection. Karena template menggabungkan variabel input pengguna ke dalam perintah akhir, pastikan untuk melakukan hal berikut:

  • Validasi dan bersihkan semua input pengguna di klien sebelum meneruskan variabel ke template (seperti menerapkan batas karakter dan format yang diharapkan).
  • Sertakan petunjuk sistem yang jelas dalam template Anda yang menentukan batasan untuk cara input pengguna diproses.

Menerapkan mode khusus template

Pertimbangkan untuk menerapkan mode khusus template setelah semua fitur aplikasi Anda menggunakan template perintah server. Saat diterapkan, Firebase AI Logic akan memblokir semua permintaan langsung tanpa template ke Gemini API (403: unauthorized), sehingga mencegah pelaku kejahatan mengirimkan perintah arbitrer atau menyalahgunakan kuota Anda.

Pemantauan, batas, dan penagihan

Dapatkan visibilitas ke traffic masuk dan anomali keamanan, serta lindungi project Anda dari lonjakan penggunaan yang tidak terduga atau biaya yang tidak terkendali.

Menyiapkan pemantauan AI di Firebase console

Siapkan pemantauan AI di Firebase console untuk mendapatkan visibilitas ke metrik utama, seperti jumlah permintaan, latensi, penggunaan token, dan tingkat error (termasuk kegagalan autentikasi 401 dan pemblokiran khusus template 403). Anda juga dapat memeriksa trace satu per satu di Google Cloud console.

Menetapkan pembatasan kapasitas dan mengelola kuota

Lindungi project Anda dari lonjakan penggunaan yang tidak terduga dan serangan denial-of-wallet:

Menghindari tagihan tak terduga dengan pemberitahuan dan batas pengeluaran

Jika project Firebase Anda menggunakan paket harga Blaze bayar sesuai penggunaan:

Langkah berikutnya