移行後に Fraud Defense の機能を使用する

このページでは、既存の reCAPTCHA インテグレーションを以前の SiteVerify メソッドから CreateAssessment メソッドに移行して、Fraud Defense 機能（多要素認証（MFA）やパスワード防御など）を使用する方法について説明します。CreateAssessment メソッドに移行するには、ウェブページをインストルメント化し、バックエンド呼び出しを移行します。

Fraud Defense の機能を確認する

CreateAssessment メソッドを使用するように移行すると、次のような Fraud Defense の追加機能を使用できるようになります。

  • アカウント保護: アカウントの乗っ取り（ATO）の試みなど、アカウントの不正使用や不正行為からユーザー アカウントを保護します。
  • トランザクション防御: カード決済攻撃や盗難された決済手段の使用などのオンライン詐欺から支払いトランザクションを保護します。
  • パスワード防御: ユーザーが提供したユーザー名とパスワードの組み合わせが、既知のデータ侵害やパスワード漏洩のデータベースに存在するかどうかを確認できます。
  • 多要素認証（MFA）: メールで確認コードを送信してユーザーの ID 確認を行います。

ウェブページをインストルメント化する

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

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

  2. ウェブページで https://www.google.com/recaptcha/api.js を https://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()

バックエンド呼び出しを移行する

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

  1. https://www.google.com/recaptcha/api/siteverify へのバックエンド呼び出しを、recaptchaenterprise.googleapis.com への同等の呼び出しに置き換えます。完全な URL と POST データ形式については、ウェブサイトの評価を作成するをご覧ください。

  2. Fraud Defense の認証を設定します。

    選択する認証方式は、Fraud Defense が設定されている環境によって異なります。次の表は、認証を設定するために、適切な認証方法とサポートされているインターフェースを選択する際に有用です。

    環境 インターフェース 認証方法
    Google Cloud
    • REST
    • クライアント ライブラリ
    		 関連付けられているサービス アカウントを使用します。
    オンプレミスまたは別のクラウド プロバイダ REST API キーまたは Workload Identity 連携を使用します。

    API キーを使用する場合は、API キーの制限を適用して API キーを保護することをおすすめします。
    クライアント ライブラリ

    以下を使用します。

次のステップ