管理コンソールと Google Cloud コンソールの用語を調整する

このドキュメントでは、reCAPTCHA キーのバージョン(v2 または v3)を特定し、以前の reCAPTCHA 管理コンソールの用語をGoogle Cloud コンソールにマッピングして、コンテンツ マネジメント システム(CMS)プラットフォームとサードパーティ プラグイン(WordPress や Shopify の統合など)に必要なサイトキーと秘密鍵を取得する方法について説明します。

以前の用語を Google Cloud コンソールにマッピングする

reCAPTCHA 管理コンソールでのみキーを管理している場合は、reCAPTCHA Classic を使用しています。 Google Cloud コンソールの Google Cloud Fraud Defense ページで鍵を管理している場合は、Fraud Defense を使用しています。どちらのコンソールも、v2 と v3 のウェブサイト キーをサポートしています。

多くの CMS プラットフォームとプラグインは、v2 Checkbox、v2 Invisible、v3 などの以前のバージョン番号を使用して reCAPTCHA キーを参照します。Google Cloud コンソールでは、バージョン番号ではなくプラットフォーム ベースの記述子が使用されます。

次の表に、以前の CMS と管理コンソールの用語とGoogle Cloud コンソールの用語のマッピングを示します。

CMS または管理コンソールの用語 Google Cloud コンソール(プラットフォームの詳細) キーを編集([タイプ] フィールド) 検証メカニズムと CMS の互換性
スコアベース(v3) Website • score Website • Score スコアに基づくスムーズな検証。reCAPTCHA v3 を必要とする CMS プラグインに使用します。
チャレンジ(v2) Website • checkbox Website • Checkbox challenge ユーザーが [私はロボットではありません] チェックボックスをオンにする必要があります。reCAPTCHA v2 チェックボックスを必要とする CMS プラグインに使用します。
非表示(v2) Website • invisible Website • Invisible integration バックグラウンドでリスクを分析し、チャレンジを表示することがあります。reCAPTCHA v2 Invisible を必要とする CMS プラグインに使用します。
なし Website • policy-based challenge Website • Policy-based challenge 構成されたスコアのしきい値に基づいてチャレンジをトリガーします。カスタム CreateAssessment 統合が必要です。
なし iOS iOS app iOS モバイルキー(チャレンジなし)。
なし Android Android app チャレンジなしの Android モバイルキー。

Google Cloud コンソールで鍵バージョンを表示する

Google Cloud コンソールで鍵のバージョンを表示する手順は次のとおりです。

  1. Google Cloud コンソールで、[Fraud Defense] ページに移動します。

    [Fraud Defense] に移動

  2. [キー] タブを選択します。

  3. 鍵がカードビューに表示されている場合は、テーブルビューに切り替えます。

  4. キーの [プラットフォームの詳細] 列を確認します。たとえば、Website • score は v3 に対応し、Website • checkbox は v2 Checkbox に対応します。

  5. 省略可。[カード] ビューで、キーカードの [キーの詳細] をクリックし、[キーを編集] を選択します。[タイプ] フィールドには、v3 の Website • Score や v2 Checkbox の Website • Checkbox challenge などの鍵構成が表示されます。

サイトキーと秘密鍵を確認する

サードパーティのプラグインと CMS プラットフォームでは、reCAPTCHA の統合にサイトキーと秘密鍵が必要になることがよくあります。

  • サイトキー: Google Cloud コンソールでは、キー ID がサイトキーに対応します。
  • 秘密鍵: Google Cloud 認証では通常、API キーまたは Identity and Access Management ロールが使用されるため、 Google Cloud コンソールにはデフォルトで秘密鍵が表示されません。ただし、以前の秘密鍵を必要とするプラグインの場合は、以前の秘密鍵を取得できます。一部のサードパーティ ライブラリやドキュメントでは、以前の秘密鍵を秘密鍵と呼んでいる場合があります。

Google Cloud コンソールで秘密鍵を取得する

サイトキーと秘密鍵を取得する手順は次のとおりです。

  1. Google Cloud コンソールで、[Fraud Defense] ページに移動します。

    [Fraud Defense] に移動

  2. [キー] タブを選択します。

  3. [reCAPTCHA キー] セクションで、シークレット キーが必要なキーに移動します。

    • [カード] ビューを使用している場合は、キーカードの [キーの詳細] をクリックします。鍵 ID はページの上部に表示されます。
    • [テーブル] ビューを使用している場合、鍵 ID がテーブルに表示されます。鍵をクリックして、詳細ページに移動します。
  4. ページの上部に表示されている鍵 ID をコピーします。この値はサイトキーです。

  5. [統合] タブに移動します。

  6. 鍵のステータスに応じて、次のいずれかを行います。

    • 鍵が以前の使用方法で構成されている場合は、[以前の鍵を使用] をクリックします。
    • 鍵が以前のサービスと統合されていない場合は、[サードパーティのサービスやプラグインと統合する] をクリックします。
  7. 秘密鍵を含むダイアログが表示されます。この値を安全にコピーします。このシークレットは機密データとして扱ってください。

    または、[キーの詳細] ページで [キーを編集] をクリックし、[秘密鍵] フィールドの横にある [表示] をクリックします。

WordPress、Shopify、その他の CMS プラットフォームと統合する

ウェブサイト作成ツール、e コマース プラットフォーム、CMS プラグインを使用している場合、プラットフォームまたはプラグインは reCAPTCHA スクリプトを読み込み、ユーザー トークンを自動的に検証します。reCAPTCHA クライアント ライブラリをインストールしたり、カスタム バックエンド コードを記述したりする必要はありません。

CMS またはサードパーティのプラグインで reCAPTCHA を構成する手順は次のとおりです。

  1. CMS またはプラグインに必要な reCAPTCHA のバージョンを確認する: CMS またはプラグインで reCAPTCHA 統合設定を開き、サポートされているキータイプ(通常は reCAPTCHA v3 または reCAPTCHA v2 チェックボックス)を確認します。
  2. 一致するキーを選択または作成する:

    • すでに鍵がある場合は、鍵のバージョンを表示して、プラグインで選択したバージョン(v3 の場合は Website • score、v2 Checkbox の場合は Website • checkbox)と一致していることを確認します。
    • 新しいキーが必要な場合は、必要なバージョンに一致するウェブサイト用のキーを作成し、キーのドメインリストにウェブサイトのドメイン(例: example.com)を追加します。
  3. サイトキーと以前の秘密鍵をコピーする: Google Cloud コンソールで秘密鍵を取得するの手順に沿って、キー ID(サイトキー)と秘密鍵を取得します。

  4. CMS またはプラグインの設定にキーを入力します。

    • [Key ID] を [Site key] フィールドに貼り付けます。
    • Secret keyを Secret key(または 秘密鍵)フィールドに貼り付け、設定を保存します。

評価を使用してカスタム ウェブサイトを統合する

CreateAssessment メソッドは、詳細なリスク分析と理由コードを提供し、高度な Fraud Defense 機能へのアクセスを可能にします。CreateAssessment メソッドは、reCAPTCHA クライアント ライブラリまたは REST API を使用して呼び出すことができます。

詳細については、ウェブサイトの評価を作成するをご覧ください。

以前の SiteVerify メソッド

新規およびカスタムの統合には CreateAssessment メソッドをおすすめしますが、一部の既存のシステムやサードパーティのプラグインは、引き続き以前の SiteVerify メソッドに依存しています。このメソッドには、reCAPTCHA キーに関連付けられた秘密鍵が必要です。

以前の SiteVerify API を必要とするシステムと統合する必要がある場合は、以前の SiteVerify でユーザー レスポンス トークンを検証するをご覧ください。

次のステップ