よくある質問

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 サイトキーが月間割り当てを超えると、`site_verify` は静的スコア 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.

次に例を示します。

注: バッジを非表示にする場合は、次のコードを使用してください。

.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 ウィジェットに「無効なサイトキー」と表示されるようになりました。変更の内容

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

「キャッチされない SecurityError: オリジン「https://www.google.com」のフレームがオリジン「<お客様のドメイン>」のフレームにアクセスするのをブロックしました」というエラーが表示されます。どうすればよいですか?

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

ウェブサイトでコンテンツ セキュリティ ポリシー(CSP)を使用しています。reCAPTCHA と連携するように構成するにはどうすればよいですか?

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

注: 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 アドレスが割り当てられた
  • アクセスしようとしているサイトは、現在、激しい攻撃を受けている可能性があります

これらの問題のトラブルシューティングについては、不審なトラフィックに関するヘルプページをご覧になるか、しばらくしてからもう一度お試しください。

有効なアクション名

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