このドキュメントでは、環境で reCAPTCHA を使用するときにデベロッパーが遭遇する可能性のある一般的な reCAPTCHA 統合の問題を一覧表示します。
サイトキーが無効です
Invalid site key エラーが表示された場合は、reCAPTCHA サイトキーが無効になっています。新しいキーを作成して、ウェブページにインストールします。
鍵の移行の失敗
サイトキーは、次のいずれかのシナリオで移行に失敗する可能性があります。
作成できるプロジェクトの数を超えています。
この問題を解決するには、既存のプロジェクトを再利用するか、プロジェクト作成割り当ての増加をリクエストするか、自動移行が完了するまでお待ちください。
ワークスペースの組織で、新しい Google Cloudプロジェクトの作成が制限されています。
Google 管理コンソールで Google Cloud サービスを有効にするには、管理者にお問い合わせください。詳しくは、ユーザーに対して Google Cloud を有効または無効にするをご覧ください。
SecurityError: 送信元「https://www.google.com」のフレームが、送信元「<your domain>」のフレームにアクセスするのをブロックしました
これは通常、エンドユーザーがチェックボックスをクリックした後に、reCAPTCHA ウィジェットの HTML 要素がプログラムで削除された場合に発生します。reCAPTCHA ウィジェットをリセットするには、grecaptcha.enterprise.reset() JavaScript 関数を使用することをおすすめします。
localhost がサポートされているドメインのリストに含まれていない
localhost ドメインはデフォルトではサポートされていません。開発用に引き続きサポートする場合は、サイトキーのサポート対象ドメインのリストに追加できます。Google Cloud コンソールに移動して、サポートされているドメインのリストを更新します。開発環境と本番環境で別々のキーを使用し、開発サイトのキーでは localhost のみを許可することをおすすめします。
reCAPTCHA は評価の作成時に BROWSER_ERROR を返しました
BROWSER_ERROR トークンは、reCAPTCHA スクリプトが execute オペレーションを実行できない場合に発生します。ほとんどの場合、これはクライアント サイトのネットワーク障害やタイムアウトが原因です。JavaScript を使用して execute() を再試行する必要があります。