移行後の reCAPTCHA Enterprise 機能の使用

このページでは、Enterprise 以外のバージョンの reCAPTCHA からの移行後に、多要素認証(MFA)やパスワード漏洩の検出などの reCAPTCHA Enterprise 機能を使用できるように、既存の reCAPTCHA 統合を変更する方法について説明します。既存の reCAPTCHA 統合を変更すると、ウェブページがインストルメント化され、バックエンド呼び出しが移行されます。

始める前に

reCAPTCHA Enterprise に移行します

ウェブページの統合

reCAPTCHA Enterprise のスクリプトと呼び出しを使用してウェブページをインストルメント化する手順は次のとおりです。

  1. 次のスクリプトがウェブページに含まれていることを確認します。https://www.google.com/recaptcha/api.js
  2. ウェブページで、https://www.google.com/recaptcha/api.jshttps://www.google.com/recaptcha/enterprise.js に置き換えます。

  3. プログラムで API を呼び出す場合は、次のように呼び出しを置き換えます。

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

(省略可)reCAPTCHA Enterprise の読み込みパフォーマンスを向上させるには、次のようにします。

  1. enterprise.js が非同期で読み込まれていることを確認します。詳細については、reCAPTCHA の非同期読み込みをご覧ください。

  2. 次のリソース ヒントを enterprise.js を読み込むページの <head> タグに追加します。

    • <link rel="preconnect" href="https://www.google.com">
    • <link rel="preconnect" href="https://www.gstatic.com" crossorigin>

バックエンド呼び出しの移行

reCAPTCHA Enterprise の機能を使用するには、バックエンド呼び出しを新しいエンドポイントに移行して認証を設定する必要があります。

  1. https://www.google.com/recaptcha/api/siteverify へのバックエンド呼び出しを https://recaptchaenterprise.googleapis.com に置き換えます。

  2. 評価の作成に使用するエンドポイントと認証方法を選択します。

    エンドポイント 認証方法
    v1beta1 API キー

    これは、バックエンド呼び出しを最も迅速に移行する方法です。

    v1 サービス アカウント おすすめの方法ですが、認証には Cloud SDK またはクライアント ライブラリを使用する必要があるため、バックエンド呼び出しの移行に時間がかかることがあります。
  3. 選択したエンドポイントに応じて API キーを作成するか、サービス アカウントを作成して構成します。

次のステップ