Identity Platform と reCAPTCHA Enterprise API の統合のトラブルシューティング

このドキュメントでは、reCAPTCHA Enterprise API と Identity Platform のインテグレーション（reCAPTCHA bot 保護機能や reCAPTCHA SMS 防御機能など）を使用する際に発生する可能性のある問題のトラブルシューティングについて説明します。

統合のオンボーディングに関するトラブルシューティング

Identity Platform と reCAPTCHA Enterprise API の統合のオンボーディング時にミスがあると、ユーザーに問題が発生することがあります。一般的な理由は次のとおりです。

  • Identity Platform と reCAPTCHA Enterprise API の統合の設定で、手順を省略した可能性があります。たとえば、サービス アカウントの設定や、プロジェクトでの reCAPTCHA Enterprise API の有効化を怠った場合です。統合の要件をすべて完了していることを確認します。設定手順については、Identity Platform を reCAPTCHA Enterprise API と統合するをご覧ください。
  • reCAPTCHA で使用する独自の鍵を使用している場合、アップロードした対応する reCAPTCHA キーが無効になっているか、機能しなくなっている可能性があります。鍵が機能しており、Identity Platform からアクセスできることを確認します。
  • ユーザーが古いバージョンのアプリを使用している可能性があります。クライアント SDK を使用する更新バージョンのアプリを提供し、アプリを更新するようユーザーに依頼してください。アプリにクライアント SDK を設定するには、クライアント SDK を構成するをご覧ください。

ユーザーが reCAPTCHA Enterprise API でサポートされているフローで認証できない

reCAPTCHA bot 保護や reCAPTCHA SMS 防御など、reCAPTCHA Enterprise API でサポートされているフローで問題が発生している場合は、次のセクションで機能固有のガイダンスをご覧ください。

reCAPTCHA による bot 対策のトラブルシューティング

次のトピックでは、bot 保護の使用時に発生する可能性のある問題とその解決方法について説明します。

メール / パスワードまたは電話プロバイダに bot 保護を使用している場合、ユーザーが認証できない

reCAPTCHA Enterprise API との Identity Platform の統合が正しく設定されていると判断した場合、現在の構成に基づいて、ユーザーがメール / パスワードまたは電話プロバイダを介して認証アクションを実行できない可能性があります。たとえば、ユーザーは次の操作を行えない場合があります。

  • メールアドレスを使用してログイン、登録、パスワードのリセットを行う。
  • 電話番号でログインするための SMS コードをリクエストします。
  • SMS ベースの多要素認証に登録するか、SMS ベースの多要素認証でログインします。

これらの認証の問題を解決するには、次のことを試してください。

  • ユーザー リクエストが ERROR_CAPTCHA_CHECK_FAILED で失敗する場合は、managedRules に設定したしきい値を調整して、より許容度の高い構成を検討してください。設定したしきい値を下回るリクエストは、bot と見なされます。たとえば、しきい値を 0.6 に設定すると、reCAPTCHA は 0.5 以下のリクエストを失敗させます。したがって、スコアを高く設定するほど、ルールは厳しくなります。
  • 別のデバイス、ブラウザ、ネットワークを試すようにユーザーへ伝えます。
  • メール / パスワード認証フローの場合は、emailPasswordEnforcementState を AUDIT モードに戻し、ENFORCE モードを再度有効にする前に指標をモニタリングします。
  • 電話認証フローの場合は、トラブルシューティング中に managedRules スコアのしきい値を調整するか、電話プロバイダの bot 保護を無効にします。reCAPTCHA SMS 防御も有効になっていて、有効なままにする場合は、useSmsBotScore を false に設定し、phoneEnforcementState を ENFORCE に設定したままにします。すべての電話番号の reCAPTCHA 保護を無効にするには、phoneEnforcementState を OFF に、useSmsBotScore を false に、useSmsTollFraudProtection を false に設定します。

reCAPTCHA SMS 防御 のトラブルシューティング

次のトピックでは、reCAPTCHA SMS 防御の使用時に発生する可能性のある問題とその解決方法について説明します。

電話プロバイダに reCAPTCHA SMS 防御を使用している場合、ユーザーが認証できない

Identity Platform と reCAPTCHA Enterprise API の統合が正しく設定されていると判断した場合、現在の構成に基づいて、ユーザーが電話プロバイダを介して SMS ベースの認証アクションを実行できない可能性があります。たとえば、ユーザーが電話番号でログインするための SMS コードをリクエストできない、多要素認証に登録できない、多要素認証でログインできない、などの問題が発生する可能性があります。これは、設定した reCAPTCHA SMS 防御スコアが厳しすぎる場合に発生することがあります。

この問題を解決するには、tollFraudManagedRules に設定したしきい値を調整して、より許容できる構成を検討します。設定したしきい値を超えるスコアは、SMS 通信不正利用とみなされます。たとえば、しきい値を 0.3 に設定すると、reCAPTCHA は 0.4 以上のリクエストを失敗させます。そのため、スコアを低く設定するほど、ルールは厳しくなります。

スコアのしきい値を調整した後、プロジェクトから出力される reCAPTCHA 指標をモニタリングして、アプリが許容できるユーザー トラフィックを受信していることを確認します。

次のステップ