reCAPTCHA Classic から移行する

このドキュメントでは、アクティブなサイトキーを使用して reCAPTCHA Classic から reCAPTCHA に移行する方法を説明します。移行プロセスが完了するまでに 5～10 分かかります。コードを変更する必要はありません。

reCAPTCHA 管理コンソールにアクセスしている場合、reCAPTCHA Classic を使用しています。reCAPTCHA Classic は、機能が制限され、毎月の使用量が厳密に制限されています。 機能の比較の詳細については、reCAPTCHA バージョン間の機能の比較をご覧ください。

移行後、reCAPTCHA のユーザーになり、1 月あたり 10,000 リクエストを超えると料金が発生します。詳細については、reCAPTCHA の料金をご覧ください。

注: reCAPTCHA v2 Android キーは移行できません。

注: 移行プロセスでは、多要素認証（MFA）やパスワード漏洩の検出などの reCAPTCHA の追加機能にアクセスできません。これらの追加機能を使用するには、移行後の reCAPTCHA 機能の使用をご覧ください。

注: 宛先の Google Cloud プロジェクトのアクセス制御が原因で、移行後に reCAPTCHA 管理コンソールの鍵にアクセスできない場合があります。その場合は、代わりに Google Cloud コンソールを使用する必要があります。

始める前に

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

   reCAPTCHA への移行では、プロジェクトで課金がリンクされ、有効になっている必要があります。課金は、クレジット カードまたは既存の Google Cloud プロジェクトの課金 ID を使用して有効にできます。課金についてサポートが必要な場合は、Cloud Billing サポートまでお問い合わせください。

3. Google Cloud コンソール の外部で gcloud CLI を実行する場合は、gcloud CLI をインストールして初期化します。手順については、次をご覧ください:

   Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

   gcloud init

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

reCAPTCHA Enterprise API の有効化

Console

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

   [reCAPTCHA Enterprise API] に移動

2. ページの上部にあるプロジェクト セレクタにプロジェクト名が表示されていることを確認します。

   プロジェクトの名前が表示されない場合は、プロジェクト セレクタをクリックしてプロジェクトを選択します。

3. [有効にする] をクリックします。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. gcloud セッションで Google Cloud プロジェクトを設定するには、gcloud config set project コマンドを実行します。PROJECT_ID は、実際の Google Cloud プロジェクト ID に置き換えます。

          gcloud config set project PROJECT_ID
          

3. reCAPTCHA Enterprise API を有効にするには、gcloud services enable コマンドを実行します。

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. reCAPTCHA Enterprise API が有効になっていることを確認するには、gcloud services list コマンドを実行します。

            gcloud services list --enabled
          

   reCAPTCHA Enterprise API が、有効な API のリストに含まれていることを確認します。

reCAPTCHA に移行する

reCAPTCHA Classic から reCAPTCHA に移行するには、reCAPTCHA 管理コンソールでアクティブなサイトキーを選択し、サイトキーを移行します。 1 つまたは複数のアクティブなサイトキーを移行できます。ただし、一度に移行できるサイトキーは 1 つのみです。

移行プロセスを実行するには、次の要件を満たす reCAPTCHA ユーザー アカウントを保有していることが必要です。

• reCAPTCHA 管理コンソールに、移行するサイトキーのオーナーとしてユーザー アカウントが表示されます。
• ユーザー アカウントには、reCAPTCHA Enterprise API が有効な Google Cloud プロジェクトで次のいずれかの IAM ロールが付与されています。
  • プロジェクト オーナー（roles/owner）
  • プロジェクト編集者（roles/editor）
  • reCAPTCHA 管理者（roles/recaptchaenterprise.admin）
  ユーザー アカウントにこれらのロールが付与されていない場合は、管理者にロールを付与してもらうか、アクセス権の付与、変更、取り消しの手順に沿って操作します。

1. Google Cloud コンソール、Cloud Shell、Google Cloud CLI、または reCAPTCHA Enterprise API を使用して、サイトキーを移行します。

   サイトキーを移行しても、キーや API エンドポイントには影響しません。Enterprise ライセンスにキーが追加されます。

   Google Cloud コンソール

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

      [reCAPTCHA] に移動

   2. ページの上部にあるリソース セレクタにリソース名が表示されていることを確認します。 プロジェクトの名前が表示されない場合は、リソース セレクタをクリックしてプロジェクトを選択します。

   3. [Classic keys] セクションで、移行するキーを特定し、[Upgrade key] をクリックします。

      

   4. 選択したキーの移行を完了するには、[確認] をクリックします。

   Cloud Shell

   1. Google Cloud コンソールで、Cloud Shell に移動します。

      Cloud Shell に移動

   2. プロンプトが表示されたら、[承認] をクリックします。

   3. reCAPTCHA をウェブページに統合するために使用したアクティブなサイトキーを選択してコピーします。

      1. reCAPTCHA 管理コンソールに移動し、[] をクリックします。

      2. サイトキーを選択します。移行でサポートされている reCAPTCHA サイトキー: reCAPTCHA v2 Checkbox、reCAPTCHA v2 Invisible、および reCAPTCHA v3。

      3. サイトキーをコピーするには、[サイトキーをコピー] をクリックします。

   4. サイトキーを移行します。

      次の例に示すように、gcloud recaptcha keys migrate コマンドを使用します。

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      次の値を指定します。

      • SITE_KEY: reCAPTCHA 管理コンソールからコピーしたアクティブなサイトキー。
      • PROJECT-ID: reCAPTCHA Enterprise API が有効になっている Google Cloud プロジェクトの ID。

   gcloud CLI

   1. 認証を構成するには、次の gcloud コマンドを実行します。

      gcloud auth login
      

      選択したサイトキーを所有し、プロジェクト所有者、プロジェクト編集者、または reCAPTCHA Enterprise 管理者のいずれかのロールをもつ reCAPTCHA ユーザー アカウントでログインします。

   2. reCAPTCHA をウェブページに統合するために使用したアクティブなサイトキーを選択してコピーします。

      1. reCAPTCHA 管理コンソールに移動し、[] をクリックします。

      2. サイトキーを選択します。移行でサポートされている reCAPTCHA サイトキー: reCAPTCHA v2 Checkbox、reCAPTCHA v2 Invisible、および reCAPTCHA v3。

      3. サイトキーをコピーするには、[サイトキーをコピー] をクリックします。

   3. サイトキーを移行します。

      次の例に示すように、gcloud recaptcha keys migrate コマンドを使用します。

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      次の値を指定します。

      • SITE_KEY: reCAPTCHA 管理コンソールからコピーしたアクティブなサイトキー。
      • PROJECT-ID: reCAPTCHA Enterprise API が有効になっている Google Cloud プロジェクトの ID。

   REST API

   1. reCAPTCHA をウェブページに統合するために使用したアクティブなサイトキーを選択してコピーします。

      1. reCAPTCHA 管理コンソールに移動し、[] をクリックします。

      2. サイトキーを選択します。移行でサポートされている reCAPTCHA サイトキー: reCAPTCHA v2 Checkbox、reCAPTCHA v2 Invisible、および reCAPTCHA v3。

      3. サイトキーをコピーするには、[サイトキーをコピー] をクリックします。

   2. サイトキーを移行します。

      リクエストのデータを使用する前に、次のように置き換えます。

      • PROJECT_ID: reCAPTCHA API が有効になっている Google Cloud プロジェクトの ID。
      • SITE_KEY: reCAPTCHA 管理コンソールからコピーしたアクティブなサイトキー。

      HTTP メソッドと URL:

      POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate

      リクエストを送信するには、次のいずれかのオプションを選択します。

      curl

      注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

      次のコマンドを実行します。

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/json; charset=utf-8" \
           -d "" \
           "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate"

      PowerShell

      注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザー アカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

      次のコマンドを実行します。

      $cred = gcloud auth print-access-token
      $headers = @{ "Authorization" = "Bearer $cred" }
      
      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand Content

      次のような JSON レスポンスが返されます。

      {
        "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
        "displayName": "My site key",
        "webSettings": {
          "allowAllDomains": false,
          "allowedDomains": [
            recaptcha.net
          ],
          "allowAmpTraffic": false,
          "integrationType": "SCORE",
          "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
        }
      }
      

2. サイトキーが移行されたことを確認する手順は次のとおりです。

   Google Cloud コンソール

   [reCAPTCHA] ページに移動し、[reCAPTCHA のキー] セクションで移行されたサイトキーを探します。

   [reCAPTCHA] に移動

   Cloud Shell

   gcloud recaptcha keys list コマンドを実行し、キーのリストで移行したサイトキーを探します。

   gcloud CLI

   gcloud recaptcha keys list コマンドを実行し、キーのリストで移行したサイトキーを探します。

reCAPTCHA に移行した後も、siteverify メソッドを使用してユーザーの reCAPTCHA レスポンス トークンを評価できます。

注: reCAPTCHA 管理コンソールや Google Cloud コンソールの reCAPTCHA ページからサイトキーを削除しないでください。サイトキーを削除すると、両方のコンソールから削除され、reCAPTCHA が提供する保護が解除されます。

reCAPTCHA ユーザー アカウントから、reCAPTCHA Enterprise 管理者（roles/recaptchaenterprise.admin）の IAM ロールを取り消すことができます。管理者にアクセス権の取り消しを依頼するか、アクセス権の付与、変更、取り消しの手順に沿って操作します。

次のステップ

• 移行後に reCAPTCHA の機能を使用する。