よくある質問

reCAPTCHA Enterprise を使用する必要がありますか？

reCAPTCHA Enterprise では、追加の評価を無料で毎月 100 万回受けられます。リアルタイム解析などのその他の機能は、多くのデベロッパーにとって最適な利用開始方法です。 無料で開始

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 v2 と v3 を同じページで実行できますか？

これを行うには、v3 サイトキーをドキュメントとして読み込み、grecaptcha.render を使用して v2 を明示的にレンダリングします。

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

reCAPTCHA は Cookie を使用しますか？

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

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

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

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 は、管理コンソールで日次の統計情報をレポートします。

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

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

  • まず、<script src="https://www.google.com/recaptcha/api.js" async defer></script> を <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></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」のフレームが送信元「&ltdomain」&gt のフレームにアクセスできないようブロックしました。必要な対策

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

ウェブサイトでコンテンツ セキュリティ ポリシー（CSP）を使用しています。reCAPTCHA を動作させるにはどうすればよいですか？

CSP3 に記載されているノンスベースのアプローチを使用することをおすすめします。ノンスは reCAPTCHA api.js スクリプトタグに含めてください。残りの処理は 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/）

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

デフォルトでは、localhost ドメインはサポートされていません。今後もサポートされたい場合は、サイトキーでサポートされているドメインのリストにドメインを追加してください。必要に応じて reCAPTCHA Enterprise コンソールまたは reCAPTCHA コンソールに移動して、サポートされているドメインのリストを更新します。開発用と本番用には別の鍵を使用し、開発用サイトキーにはローカルホストのみを許可することをおすすめします。

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

これは、Google が報告した Apple 側の重点的なバグです。影響を受けるユーザーは、iOS 10 および一部のサイトに限られます。影響を受けている場合は、ページ上の reCAPTCHA ウィジェットを上下に移動するか、reCAPTCHA v3 を使用します。

パソコンやネットワークから、自動クエリが送信されることがありますか？

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

残念ながら、次のような理由で、良質なユーザーにこの現象が生じることがあります。

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

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

有効なアクション名

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