よくある質問

reCAPTCHA Enterprise を使用すべきですか？

reCAPTCHA Enterprise では、1 か月あたり最大 10,000 件の評価を無料で利用できるほか、追加機能も提供しています。 その他の機能 （リアルタイム分析など）は、ほとんどのデベロッパーにとって最適な出発点となります。 こちらから始めましょう。

サードパーティ ソリューションで reCAPTCHA を使用できますか？

はい。reCAPTCHA（Enterprise 以外のバージョン）と reCAPTCHA Enterprise の両方を使用できます。通常、サードパーティ ソリューションは公開鍵と、秘密鍵または API キーのいずれかを要求します。シークレット キーと API キーは、信頼できるサードパーティにのみ提供してください。

v2 または v3 から reCAPTCHA Enterprise に移行するにはどうすればよいですか？

移行プロセスが完了するまでに 5 ～ 10 分かかります。コードを変更する必要はありません。

reCAPTCHA v2 と v3 のどちらを使用すればよいですか？

reCAPTCHA v3 は、トラフィックに関する詳細なデータを取得したいサイト所有者向けです。詳細については、reCAPTCHA v3 デベロッパー ガイドをご覧ください。

v2 のセキュリティとユーザビリティはサポートされています。

reCAPTCHA v2 と v3 の違いについては、バージョンの比較をご覧ください。

reCAPTCHA は Cookie を使用しますか？

reCAPTCHA は、リスク分析を行うために実行された際に、必要な Cookie（_GRECAPTCHA）を設定します。他の Cookie が設定されている可能性がある www.google.com ドメインを使用することを回避する場合は、代わりに www.recaptcha.net を使用できます。

reCAPTCHA の使用には QPS または 1 日あたりの上限がありますか？

1 秒あたり 1,000 回以上、または 1 か月あたり 1,000,000 回以上の呼び出しを行う場合は、 reCAPTCHA Enterprise を使用するか、こちらのフォームに記入して例外の承認をお待ちください。サイトキーが 1, 000 QPS を超えると、一部のリクエストが処理されないことがあります。v3 サイトキーが月間割り当てを超えると、サイト検証が失敗し、その月の残りの期間は静的スコア 0.9 とエラー メッセージ「Over free quota.」が返されることがあります。v3 サイトが割り当てを超えた場合、ユーザーに表示されるインジケーターはありません。v2 サイトキーが月間割り当てを超えると、その月の残りの期間、reCAPTCHA ウィジェットに「このサイトは reCAPTCHA の割り当て回数を超えています」などのメッセージがユーザーに表示されることがあります。割り当てが適用される前に、サイト所有者にはメールで 3 回通知され、reCAPTCHA Enterprise への移行に少なくとも 90 日間の猶予が与えられます。サイトキーは、任意のドメインで 1 か月あたり 1,000,000 回を超える呼び出しが使用された場合、割り当て超過と見なされます。これには、このボリュームが同じドメインの複数のキーに分散されている場合も含まれます。

reCAPTCHA バッジを非表示にしたいのですが、どうすればよいですか？

ユーザーフローに reCAPTCHA のブランドを明示しているのであれば、バッジを非表示にできます。次のテキストを含めてください。

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

次に例を示します。

注: バッジを非表示にする場合は、

.grecaptcha-badge { visibility: hidden; }

reCAPTCHA で自動テストを実行したい場合に、必要な対策

reCAPTCHA v3 の場合は、テスト環境用に別のキーを作成します。reCAPTCHA v3 は実際のトラフィックを基にしているため、スコアが正確でない場合があります。

reCAPTCHA v2 の場合は、次のテストキーを使用します。常に CAPTCHA が表示されず、すべての確認リクエストが合格します。

  • サイトキー: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • 秘密鍵: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

reCAPTCHA ウィジェットに警告メッセージが表示され、本番環境のトラフィックに使用されないようになります。

サイトのデバッグ時に reCAPTCHA コードを使用しないようにするにはどうすればよいですか？

サイト上の他の JavaScript のデバッグ中に reCAPTCHA コードにステップインしないようにするには、ブラウザの無視リストに reCAPTCHA スクリプト /recaptcha__.+\.js$ を追加します。Chrome の手順については、スクリプトのカスタムリストを無視するをご覧ください。他のブラウザでも同様の機能を利用できます。

ウェブサイトのトラフィックに関する詳細を確認するにはどうすればよいですか？

reCAPTCHA は、管理コンソールで毎日の統計情報をレポートします。

reCAPTCHA はグローバルに使用できますか？

はい。www.google.com にアクセスできない場合は、コードで www.recaptcha.net を使用してください。

  • まず、<script src="https://www.google.com/recaptcha/api.js"></script> を <script src="https://www.recaptcha.net/recaptcha/api.js"></script> に置き換えます。
  • その後、サイト上で他のすべての「www.google.com/recaptcha/」を使用する場所に同じ方法を適用します。

reCAPTCHA のウィジェットかバッジをカスタマイズできますか？

はい。reCAPTCHA には、以下に示すようにライトテーマとダークテーマの 2 つのテーマがあります。テーマを選択するには、grecaptcha.render パラメータで data-theme 属性を設定します。

ライトモード

ダークモード:

reCAPTCHA v3 をカスタマイズするにはどうすればよいですか？

Invisible reCAPTCHA で使用できる JavaScript API は、v3 でも使用できます。JavaScript API を使用して v3 サイトキーで reCAPTCHA を明示的にレンダリングするだけで、バッジの再配置やテーマの変更などのオプションにアクセスできます。

このメソッドで reCAPTCHA v3 をレンダリングする場合は、size パラメータを 'invisible' に設定し、サイトキーの代わりに grecaptcha.execute を呼び出すときに grecaptcha.render から返されたクライアント ID を使用してください。

最近、reCAPTCHA ウィジェットに「Invalid site key」と表示されるようになりました。変更の内容

このエラーが表示される場合、reCAPTCHA サイトキーは無効になっています。有効にするには、新しいキーを登録し、そのページの手順に沿って操作してください。

キャッチされない SecurityError: オリジン「https://www.google.com」のフレームがオリジン「&ltyour domain&gt」のフレームにアクセスするのをブロックしました。必要な対策

これは通常、エンドユーザーがチェックボックスをクリックした後に、reCAPTCHA ウィジェットの HTML 要素がプログラムで削除された場合に発生します。reCAPTCHA ウィジェットをリセットするには、grecaptcha.reset() JavaScript 関数を使用することをおすすめします。

ウェブサイトで Content-Security-Policy（CSP）を使用しています。reCAPTCHA と連携するように構成するにはどうすればよいですか？

CSP3 で説明されているノンスベースのアプローチを使用することをおすすめします。reCAPTCHA の api.js スクリプトタグに nonce を含めてください。残りの処理は Google が行います。

注: reCAPTCHA は、それをサポートするブラウザで 'strict-dynamic' とも連携します。

または、次の値をディレクティブに追加してください。

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

「localhost はサポートされているドメインのリストに含まれていません」というエラーが表示されます。必要な対策

localhost ドメインはデフォルトではサポートされていません。開発用に引き続きサポートする場合は、サイトキーのサポート対象ドメインのリストに追加できます。reCAPTCHA Enterprise コンソールまたは reCAPTCHA コンソールに移動して、サポートされているドメインのリストを更新します。開発環境と本番環境には別々のキーを使用し、開発サイトキーでは localhost のみを許可することをおすすめします。

iOS 10 でのみ、ユーザーがチャレンジを完了するとページが一番下までスクロールする。

これは Apple 側のフォーカスに関するバグであり、Google は Apple に報告済みです。この問題は、iOS 10 の一部のサイトでのみ発生します。この問題が発生した場合は、reCAPTCHA ウィジェットをページの上部または下部に移動するか、reCAPTCHA v3 を使用してください。

ご使用のコンピュータまたはネットワークから自動リクエストが送信されている可能性がありますか？

reCAPTCHA ウィジェットからこのページにリダイレクトされた場合は、「申し訳ございませんが、お客様のパソコンまたはネットワークから自動化されたクエリが送信されている可能性があります。ユーザーを保護するため、このリクエストをすぐに処理することはできません。」

残念ながら、次のような理由で、優良なユーザーにもこの問題が発生する可能性があります。

  • 不正使用されている共有ネットワークを使用している可能性があります
  • インターネット サービス プロバイダが最近、不審な IP アドレスを割り当てた可能性がある
  • アクセスしようとしているサイトは現在、大規模な攻撃を受けている可能性があります

この問題を解決するには、異常なトラフィックに関するヘルプページをご覧いただくか、後で再度お試しください。

有効なアクション名は何ですか？

アクションには、英数字、スラッシュ、アンダースコアのみを使用できます。アクションはユーザー固有のものであってはなりません。