reCAPTCHA Enterprise プロバイダを使用するために Firebase コンソールでアプリを登録する際に、アプリの reCAPTCHA キーを指定する必要があります。App Check はスコアベースの reCAPTCHA キーを使用するため、ユーザーには表示されません。つまり、reCAPTCHA Enterprise プロバイダがユーザーに問題の解決を求めることはありません。
このページでは、ウェブ、Android、Apple の各プラットフォームで使用するスコアベースのキーを作成する方法について説明します。詳細な手順については、ウェブアプリとモバイルアプリの reCAPTCHA Enterprise ドキュメントをご覧ください。
Flutter の場合は、プロジェクトのターゲット プラットフォームの手順に沿って操作します。
始める前に
ウェブ、Android、Apple の各プラットフォームのアプリでスコアベースの reCAPTCHA キーを作成する前に、これらの要件と推奨事項をご確認ください。
必要な IAM 権限
reCAPTCHA Enterprise 管理者(roles/recaptchaenterprise.admin)の IAM ロールがあることを確認します。
一般的な推奨事項
Firebase プロジェクト用に作成できる reCAPTCHA キーの数に上限はありません。Firebase プロジェクトの一般的な設定で reCAPTCHA キーを作成する際の一般的な推奨事項は次のとおりです。
登録した Firebase アプリごとに 1 つのキーを作成します。例:
同じ Firebase プロジェクトを共有する iOS アプリ、Android アプリ、ウェブアプリがある場合、プロジェクトには 3 つのキーが必要です。
同じプラットフォームの複数のアプリが同じ Firebase プロジェクトを共有している場合、プロジェクトには各アプリのキーが必要です。
開発アプリ、ステージング アプリ、本番環境アプリ用に個別の鍵を作成します(これらのバリアントはそれぞれ、すでに個別の Firebase プロジェクトを使用しているはずです)。そうしないと、非本番環境からのデータが reCAPTCHA Enterprise リスク分析に悪影響を及ぼすリスクがあります。
ウェブ
スコアベース キーを作成するには、Google Cloud コンソール、gcloud CLI、または REST API を使用します。
ウェブサイトの場合、reCAPTCHA キーは、指定したドメインとサブドメインに固有のものです。複数のドメインからウェブサイトを提供する場合は、複数のドメインを指定できます。あるドメイン(たとえば examplepetstore.com)を指定すると、そのサブドメイン(たとえば subdomain.examplepetstore.com)を指定する必要はありません。
Google Cloud コンソール
Google Cloud コンソールで、[Fraud Defense] ページ(reCAPTCHA キーを設定するページ)に移動します。
正しいプロジェクトが選択されていることを確認します(画面上部のプロジェクト選択ツールを参照)。
[鍵を作成] をクリックします。
[表示名] フィールドに、キーの表示名を入力します。
[アプリケーションの種類] で [ウェブ] を選択します。
ドメインとサブドメインのキーを保護するには、[ドメインの所有権の証明を無効にする] トグルがオフになっていることを確認します。
[ドメインリスト] セクションで、次の操作を行います。
[ドメインを追加] をクリックします。
[ドメイン] フィールドにドメインの名前を入力します。
(省略可)ドメインを追加するには、[ドメインを追加] をクリックし、別のドメイン名を入力します。
App Check は、250 を超えるドメインで配信されるウェブアプリをサポートしていません。
本番環境で使用される(または使用される予定の)reCAPTCHA キーにドメインとして
localhostを追加しないでください。
(省略可)本番環境以外のアプリのテストキーを作成していて、評価の作成時にキーが返すスコアを指定する場合は、次の操作を行います。
[次のステップ(省略可)] をクリックして、[その他の設定] ステップに進みます。
[チャレンジを使用する] の切り替えはオンにしないでください。
[この鍵はテスト目的でのみ作成しますか?] の切り替えボタンをオンにして、[スコアを設定] スライダーを使用して 0 ~ 1.0 のスコアを指定します。
[鍵を作成] をクリックします。
新しく作成された鍵は、Google Cloud コンソールの reCAPTCHA 鍵ページに表示されます。
gcloud CLI
gcloud CLI を使用してスコアベースのキーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。
REST
REST API を使用してスコアベース キーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。
Android
スコアベース キーを作成するには、Google Cloud コンソール、gcloud CLI、または REST API を使用します。
Google Cloud コンソール
Google Cloud コンソールで、[Fraud Defense] ページ(reCAPTCHA キーを設定するページ)に移動します。
正しいプロジェクトが選択されていることを確認します(画面上部のプロジェクト選択ツールを参照)。
[鍵を作成] をクリックします。
[表示名] フィールドに、キーの表示名を入力します。
[アプリケーションの種類] で [Android] を選択します。
Android アプリのキーを保護するには、[パッケージ名の確認を無効にする] の切り替えボタンがオフになっていることを確認します。
[Android パッケージ] リスト セクションで、次の操作を行います。
[Android パッケージを追加] をクリックします。
[Android パッケージ] フィールドに、Android アプリのパッケージ名(例:
com.example.my_app)を入力します。Firebase プロジェクトで Firebase Android アプリを作成したときに指定したパッケージ名と同じものを入力してください。パッケージ名の値では大文字と小文字が区別されます。
App Check の場合、各パッケージ名は 1 つの reCAPTCHA キーにのみ対応できます。
Google Play Store に加えて他のアプリストアで利用できるアプリのキーを作成する場合は、[Google Play ストアの外部で配布されるアプリケーションをサポートする] の切り替えをオンにします。
(省略可)本番環境以外のアプリのテストキーを作成していて、評価の作成時にキーが返すスコアを指定する場合は、次の操作を行います。
[次のステップ(省略可)] をクリックして、[その他の設定] ステップに進みます。
[チャレンジを使用する] の切り替えはオンにしないでください。
[この鍵はテスト目的でのみ作成しますか?] の切り替えボタンをオンにして、[スコアを設定] スライダーを使用して 0 ~ 1.0 のスコアを指定します。
[鍵を作成] をクリックします。
新しく作成された鍵は、Google Cloud コンソールの reCAPTCHA 鍵ページに表示されます。
gcloud CLI
gcloud CLI を使用してスコアベースのキーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。
REST
REST API を使用してスコアベース キーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。
Apple プラットフォーム
スコアベース キーを作成するには、Google Cloud コンソール、gcloud CLI、または REST API を使用します。
Google Cloud コンソール
Google Cloud コンソールで、[Fraud Defense] ページ(reCAPTCHA キーを設定するページ)に移動します。
正しいプロジェクトが選択されていることを確認します(画面上部のプロジェクト選択ツールを参照)。
[鍵を作成] をクリックします。
[表示名] フィールドに、キーの表示名を入力します。
[アプリケーションの種類] で [iOS] を選択します。
Apple プラットフォーム アプリのキーを保護するには、[バンドル ID の確認を無効にする] トグルがオフになっていることを確認します。
[iOS バンドル ID リスト] リスト セクションで、次の操作を行います。
[iOS バンドル ID を追加] をクリックします。
[バンドル ID] フィールドに、アプリのバンドル ID(
com.example.my_appなど)を入力します。Firebase プロジェクトで Firebase Apple アプリを作成したときに指定したバンドル ID と同じバンドル ID を入力してください。バンドル ID の値では大文字と小文字が区別されます。
App Check の場合、各バンドル ID は 1 つの reCAPTCHA キーにのみ対応します。
(省略可)別のバンドル ID を追加するには、[iOS バンドル ID を追加] をクリックして、別のバンドル ID を入力します。
Apple Developer の設定を指定します。
reCAPTCHA Enterprise がトラフィックに対してより正確なリスクスコアを提供できるため、このデータを提供することを強くおすすめします。
次の情報を入力します。
秘密鍵(.p8): これは、Apple Developer Center の [Certificates, Identifiers & Profiles] で生成されます。
キー ID: Apple デベロッパー キー ID(10 文字の文字列)。
チーム ID: アプリの構築に使用されるプロビジョニング プロファイルを所有している Apple チーム ID(10 文字の文字列)。
(省略可)本番環境以外のアプリのテストキーを作成していて、評価の作成時にキーが返すスコアを指定する場合は、次の操作を行います。
[次のステップ(省略可)] をクリックして、[その他の設定] ステップに進みます。
[チャレンジを使用する] の切り替えはオンにしないでください。
[この鍵はテスト目的でのみ作成しますか?] の切り替えボタンをオンにして、[スコアを設定] スライダーを使用して 0 ~ 1.0 のスコアを指定します。
[鍵を作成] をクリックします。
新しく作成された鍵は、Google Cloud コンソールの reCAPTCHA 鍵ページに表示されます。
gcloud CLI
gcloud CLI を使用してスコアベースのキーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。
REST
REST API を使用してスコアベース キーを作成するには、reCAPTCHA Enterprise ドキュメントの手順に沿って操作します。