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