モバイルアプリやウェブアプリから Gemini API を直接呼び出す場合、バックエンド インフラストラクチャ、割り当て、独自のプロンプトを保護するには、多層防御アプローチが必要です。このチェックリストを確認して、Firebase AI Logic の推奨されるセキュリティのベスト プラクティスを実装してください。
アプリ、デバイス、ユーザーの確認
受信リクエストが、正規のデバイスで実行されている正規の改ざんされていないアプリ インスタンスと、正規のユーザーから発信されていることを確認します。
適用 Firebase App Check
Firebase App Check を適用して、アプリから直接呼び出されたときに Gemini API が不正使用されないようにします。App Check が適用されると、受信リクエストが正規のアプリや改ざんされていないデバイスから発信されたものであることが確認されます。
App Check は、Apple プラットフォーム(DeviceCheck、App Attest、reCAPTCHA Enterprise)、Android(Play Integrity、reCAPTCHA Enterprise)、ウェブ(reCAPTCHA Enterprise)のアテステーション プロバイダをサポートしています。Flutter アプリと Unity アプリでも、これらのプロバイダをすべてサポートしています。
2026 年 11 月 2 日、Firebase は、Gemini API を不正使用から保護するため、すべてのプロジェクトで Firebase AI Logic に App Check を自動的に適用しました。ローカル開発では、App Check デバッグ プロバイダを設定し、エンドユーザーにリリースする前に、本番環境の証明書プロバイダにアプリを登録できます。
使用回数制限付きトークンでリプレイ保護を有効にする
App Check を設定する一環として、App Check トークンが 1 回限りになるように、リプレイ保護を適用することを検討してください。このオプションでは、ベースライン保護を超える保護強化機能が提供され、アプリとユースケースに適した保護レベルを設定できます。
Firebase API キーの制限を設定する
Firebase API キーは、リクエストを行う際に Firebase プロジェクトとアプリを識別します。API キーの不正使用を防ぐには:
Google Cloud コンソールでアプリケーションの制限を設定して、アプリの特定のバンドル ID(Apple)、パッケージ名と SHA-1 フィンガープリント(Android)、または HTTP リファラー(ウェブ)からのリクエストのみにキーの使用を制限します。
各キーの「API の制限」許可リストを確認します。
- Firebase AI Logic API(
firebasevertexai.googleapis.com)が許可リストに含まれていることを確認します。 - 許可リストに登録されている他の API が、アプリに必要な特定の Firebase サービスのみであることを確認します。制限付き Firebase キーに必要な API のリストをご覧ください。
- Firebase AI Logic API(
Firebase 関連の API は、Firebase プロジェクトまたはアプリの識別にのみ API キーを使用します。API の呼び出しの認証には使用しません。
認証済みユーザーのみにリクエストを制限する
認証済みユーザーモードを適用して、Firebase AI Logic 経由のすべてのリクエストに Firebase Authentication の有効な認証情報が含まれるようにすることを検討してください。認証されていないエンドユーザーからリクエストが送信された場合、リクエストは 401: unauthenticated エラーで拒否されます。
プロンプト保護とリクエストの強化
クライアントの逆コンパイルによってプロンプト設計が公開されないようにし、悪意のあるユーザーが任意のプロンプトを実行できないようにバックエンドをロックします。
サーバー プロンプト テンプレートを使用する
サーバー プロンプト テンプレートを使用して、プロンプト、システム指示、モデル構成をクラウドに安全に保存します。クライアント アプリのコードにハードコードすると、バイナリの逆コンパイルによって抽出される可能性があります。
アプリはテンプレート ID のみを参照し、動的入力変数を渡します。サーバー プロンプト テンプレートを使用すると、アプリの新しいバージョンをリリースすることなく、プロンプトを更新したり、モデルをオンデマンドで切り替えたりすることもできます。
クライアントから提供されたテンプレート変数を検証してサニタイズする
サーバー プロンプト テンプレートはプロンプト設計を保護しますが、動的変数を受け入れるテンプレートはプロンプト インジェクションの影響を受ける可能性があります。テンプレートはユーザー入力変数を最終的なプロンプトに連結するため、次のことを行う必要があります。
- 変数をテンプレートに渡す前に、クライアントですべてのユーザー入力を検証してサニタイズします(文字数制限や想定される形式の適用など)。
- ユーザー入力の処理方法のガードレールを定義する明確なシステム指示をテンプレートに含めます。
テンプレート専用モードの適用
すべてのアプリ機能でサーバー プロンプト テンプレートを使用するようになったら、テンプレートのみモードを適用することを検討してください。適用すると、Firebase AI Logic は Gemini API(403: unauthorized)への直接のテンプレート化されていないリクエストをすべてブロックし、悪意のある行為者が任意のプロンプトを送信したり、割り当てを不正使用したりするのを防ぎます。
モニタリング、上限、課金
受信トラフィックとセキュリティ異常を可視化し、予期しない使用量の急増、費用の急増からプロジェクトを保護します。
Firebase コンソールで AI モニタリングを設定する
Firebase コンソールで AI モニタリングを設定して、リクエスト数、レイテンシ、トークン使用量、エラー率(401 認証エラーや 403 テンプレートのみのブロックなど)などの主要な指標を可視化します。Google Cloud コンソールで個々のトレースを調べることもできます。
レート制限を設定して割り当てを管理する
予期しない使用量の急増とウォレット拒否攻撃からプロジェクトを保護します。
- ユーザーごとにレート制限を設定(デフォルトは 100 RPM)して、個々のクライアント インスタンスが過剰な割り当てを消費しないようにします。
- 各基盤 API の Google Cloud コンソールでプロジェクトの割り当てを確認して管理します。
アラートと単価の上限設定で想定外の請求を回避する
Firebase プロジェクトが従量課金制の Blaze のお支払いプランに登録されている場合:
次のステップ
- 一般的な Firebase セキュリティ チェックリストを確認します。
- Firebase AI Logic の一般的な本番環境チェックリストを確認する。
- Firebase AI Logic の料金と費用管理の詳細を確認する。