AI プロンプト: Firebase セキュリティ ルールを作成する

注意: このページで説明する Gemini CLI 拡張機能とプロンプトはベータ版です。つまり、機能が下位互換性のない方法で変更されるか、サポートが制限される可能性があります。ベータ版リリースは、SLA または非推奨ポリシーの対象ではありません。

このプロンプトは、Gemini CLI などの AI アシスタントがアプリの Firebase Security Rules を生成して調整するのに役立ちます。このプロンプトを使用すると、ユーザー固有のアクセス権の付与、ロールベースの権限の実装、データの検証などの一般的なユースケースの Rules を作成できます。

このプロンプトは、次の Rules の生成に焦点を当てています。

• Cloud Firestore: アプリのロジックに基づいてコレクションとドキュメントを保護します。
• Cloud Storage for Firebase: 保存されたファイルのアクセス権を検証します。

このプロンプトを使用すると、強力なセキュリティ ポスチャーを簡単に設定できますが、本番環境にデプロイする前に、必ず Rules を十分にテストしてください。Rules のテストについて詳しくは、Firebase Security Rules の使用を開始する: ルールをテストするをご覧ください。

重要:

Firebase Security Rules は自動的に更新されません。このガイドで説明する Gemini CLI 拡張機能は、プロジェクトの現在の状態に基づいて Rules を作成するために 1 回実行されます。アプリやファイル システムを継続的にモニタリングすることはありません。新しい機能を開発しても、ルールファイルは自動的に更新されません。

Rules は、次の操作を行うたびに手動で更新する必要があります。

• 新しいデータベース コレクションまたはパスを追加する
• データの構造またはスキーマを変更する
• ファイル ストレージの構造を変更する

Rules を更新するには、プロンプトを再実行して Rules を再構築するか、手動で編集する必要があります。

Rules を更新せずに新しい機能を追加すると、次のものが作成される可能性があります。

• セキュリティのギャップ: 新しいデータが保護されず、一般公開されて読み取り/書き込み可能になる可能性があります。
• 機能の破損: アプリが新しいデータにアクセスできなくなり、失敗する可能性があります。

前提条件

• セキュリティ ルールのベスト プラクティスについて理解を深めます。
• Firebase Security Rules の単体テストを実行して Firebase Local Emulator Suite を使用するには、Node.js をインストールして Firebase CLI をインストールします。詳しい手順については、Local Emulator Suite のインストール、構成、統合をご覧ください。
• 推奨: Gemini CLI をまだインストールしていない場合は、インストールします。次の手順では、Gemini CLI 拡張機能をインストールして Rules を生成する方法について説明します。別の AI アシスタントを使用する場合は、リポジトリから選択した AI アシスタントにプロンプトをコピーして貼り付けることができます。
• この Gemini CLI 拡張機能は、Firebase MCP サーバーを使用して、生成された Firebase Security Rules を検証します。MCP サーバーは、Rules のテストとデプロイを容易にするためにも使用できます。拡張機能を使用して Firebase Security Rules を生成する前に、Firebase MCP サーバーをインストールします。

制限事項

Google はこのエクスペリエンスの改善に積極的に取り組んでおり、この制限事項のリストは変更される可能性があります。更新されていないか、定期的に確認してください。

• Gemini in Firebase は Firebase Security Rules を生成できません。Gemini CLI などの別の AI アシスタントを使用します。
• このプロンプトは、Cloud Firestore と Cloud Storage for Firebase の Firebase Security Rules を生成するように設計されています。Firebase Realtime Database の Rules を生成することはまだできません。
• Firebase Admin SDK を使用する場合など、サーバーやその他のバックエンド環境からデータベースやバケットにアクセスする際には、Firebase Security Rules は呼び出されません。Admin SDK を使用している場合は、バックエンド コードで承認とデータ検証を管理する必要があります。

プロンプトを使用する

重要:

アプリで生成 AI を使用する場合は、次の点に注意してください。

• 生成 AI は間違えることがあります。本番環境にデプロイする前に、必ず変更内容や出力を確認してください。
• 特に、アプリに大幅な変更を加える前には、コードのスナップショットを頻繁に commit してください。
• この AI アシストによるアプローチは、自己責任で使用してください。Google と Firebase は、AI によって生成された Rules のセキュリティの脆弱性について責任を負いません。生成された Rules を確認してテストしてから、本番環境にデプロイする必要があります。

1. Firebase Security Rules の試験運用版の Gemini CLI 拡張機能を使用して、ルールとテストを生成します。

   この拡張機能は、ソースコードを分析して、Cloud Firestore と Cloud Storage のデータ スキーマとアクセス パターンを特定します。最小権限の原則に基づいて Rules を作成し、反復的な「攻撃」シミュレーションを通じて脆弱性を検出するように設計されています。最終的な検証を支援するため、@firebase/rules-unit-testing を使用した単体テスト スイートの開始を提供します。これにより、Firebase Local Emulator Suite を使用してセキュリティ ロジックをローカルで検証できます。

   注: この拡張機能はプレビュー版です。フィードバックや投稿をお待ちしております。提案や改善点がある場合は、GitHub リポジトリで問題または pull リクエストを送信してください。

   拡張機能をインストールして使用するには:

   1. Gemini CLI 拡張機能をインストールします。

      gemini extensions install https://github.com/firebase/snippets-rules
      

   2. Gemini CLI を開きます。

      gemini
      

   注: ルールを生成する前に、Firebase MCP サーバーに接続していることを確認してください。

   1. プロジェクトのルートから拡張機能を実行して、Cloud Firestore のルールを生成します。

      /firebase-rules:firestore Generate rules using PROJECT ID PROJECT_ID
      

      または、Cloud Storage のルールを生成します。

      /firebase-rules:storage Generate rules using PROJECT ID PROJECT_ID and BUCKET NAME BUCKET_NAME
      

   拡張機能により、プロジェクトのルートに Cloud Firestore の場合は rules_test ディレクトリ、Cloud Storage の場合は storage_rules_test ディレクトリが作成されます。この新しいディレクトリには、生成された .rules ファイルと、単体テストを含む Node.js プロジェクトが含まれています。

   注: 別の AI アシスタントを使用する場合や、この拡張機能の背後にあるプロンプト全体を確認する場合は、リポジトリでプロンプトを表示できます。

2. ルールの検証とテストの結果を確認します。

   • 構文の検証 - ルールの生成後、Gemini CLI は Firebase MCP サーバーの firebase_validate_security_rules コマンドを使用して構文を自動的に検証します。
   • 単体テスト - 構文を検証した後、Gemini CLI は Firebase Local Emulator Suite を使用して生成された単体テストを実行しようとします。テストを実行するには、別のターミナルで Firebase Local Emulator Suite を実行する必要があります。

   テストが自動的に実行されない場合は、別のターミナルで Firebase Local Emulator Suite を開始し、次のいずれかのオプションを使用してテストを実行します。

   *   Instruct Gemini CLI to run tests:
       ```none
       Firebase Emulator Suite is running in a separate terminal. Please
       execute the tests.
       ```
   *   Run tests manually by following the instructions in the `README.md`
       file in the `rules_test` or `storage_rules_test` directory.
   

3. 生成された Rules の結果に満足したら、次の Firebase CLI コマンドを使用して Rules をデプロイします。

   Cloud Firestore

   firebase deploy --only firestore:rules

   Cloud Storage

   firebase deploy --only storage

参考情報

• セキュリティ体制をさらに強化するには、Gemini CLI 用のセキュリティ拡張機能を使用することもできます。これは、コード変更を分析してセキュリティ リスクと脆弱性を特定するオープンソースの拡張機能です。