ドキュメントCommerce管理者システムガイド

Google reCAPTCHA V3およびV2

Last update: Tue May 12 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 初心者
  • 中級
  • 管理者

Google reCAPTCHAを使用すると、コンピューター（または「ボット」）ではなく、人間がWeb サイトと対話できるようになります。 標準のAdobe CommerceおよびMagento Open Source CAPTCHAとは異なり、Google reCAPTCHAは、様々な表示オプションとメソッドを備えた強化されたセキュリティを提供します。 その他のweb サイトトラフィック情報は、Google reCAPTCHA アカウントのダッシュボードで確認できます。

Google reCAPTCHAは、管理者とストアフロント用に個別に設定されます。

  • 管理者の場合は、​ ログイン ​ ページでGoogle reCAPTCHAを使用できます。また、ユーザーがパスワードのリセットをリクエストした場合にも使用できます。 標準のCommerce CAPTCHAも有効になっている場合、Google reCAPTCHAは問題なく同時に使用できます。

  • ストアフロントの場合、Google reCAPTCHAを使用してお客様アカウント ​にログインし、お問い合わせ ページからメッセージを送信し、その他の多数のストアフロントの場所で使用できます。

    Google reCAPTCHA - customer login {width="700" modal="regular"}

Google reCAPTCHAは、いくつかの方法で実装できます。

  • reCAPTCHA v3 Invisible — アルゴリズムを使用してユーザーのインタラクションを評価し、スコアに基づいてユーザーが人間である可能性を判断します。

  • reCAPTCHA v2 Invisible — ユーザーの操作なしでバックグラウンド検証を実行します。 ユーザーと顧客は自動的に検証されますが、課題を完了するために特定の画像を選択する必要がある場合があります。

  • reCAPTCHA v2 （「I am not a robot」） — 「I'm not a robot」 チェックボックスでリクエストを検証します。

IMPORTANT
Google reCAPTCHAを設定する前に、PHP.ini ファイルに次の設定が含まれていることを確認してください：allow_url_fopen = 1。 これには開発者のサポートが必要になる場合があります。 インストールガイドの「必要なPHP設定」を参照してください。

手順1:Google reCAPTCHA キーの生成

Google reCAPTCHAを有効にするには、一対のAPI キーが必要です。 これらのキーは、reCAPTCHA サイトから無料で入手できます。 キーを生成する前に、使用するreCAPTCHAのタイプを把握しておく必要があります。

  1. Google reCAPTCHA Admin Consoleを開き、アカウントにログインします。

  2. Label​の場合、内部参照のキーを識別する名前を入力します。

    Adobe CommerceまたはMagento Open Sourceのインストールで使用されるreCAPTCHA タイプごとに1つのキーのセットが必要です。 例：Commerce Invisible

  3. reCAPTCHA type​に対して、使用するメソッドを選択します。

    • reCAPTCHA v3 Invisible
    • reCAPTCHA v2 Invisible
    • reCAPTCHA v2 （"I am not a robot"）

  4. Domain​に、ストアのドメインを入力します。 例：mystore.com

    異なるドメインを持つ複数のストアがある場合は、各ドメインを別々の行に入力します。

    • ストアドメインとサブドメインを追加します。
    • テスト用に必要に応じて、localhost、その他のローカル VM ドメイン、ステージング ドメインを追加できます。

  5. クラウドプロジェクトの選択

  6. Accept the reCAPTCHA Terms of Service​のチェックボックスをオンにします。

  7. （オプション） Googleで問題や疑わしいトラフィックが検出された場合に通知を送信するには、「Send alerts to owners」チェックボックスをオンにします。

  8. Submit​をクリックして登録を完了し、キーを受け取ります。

    note important
    IMPORTANT
    すべてのキーがreCAPTCHAのすべてのタイプに適用されるわけではなく、誤って適用すると、予期しない動作が発生する可能性があります。 例えば、reCAPTCHA v2 「I'm not a robot」用に生成されたGoogle reCAPTCHA キーは​_reCAPTCHA v2 Invisible_​では機能せず、reCAPTCHAが有効になっている機能がブロックされる可能性があります。

手順2：管理者用Google reCAPTCHAの設定

[PaaSのみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeで管理されるPaaS インフラストラクチャ）とオンプレミス プロジェクトにのみ適用されます。"}

  1. Admin アカウントにログインします。

  2. 管理者サイドバーで、Stores > Settings>Configuration​に移動します。

  3. 右上隅で、Store View​をDefault Configに設定します。

  4. 左側のパネルで、Security​を展開し、Google reCAPTCHA Admin Panel​をクリックします。

    note note
    NOTE
    設定する各フィールドの​Use system value チェックボックスをオフにします。

  5. reCAPTCHA v2 (“I am not a robot”)​を使用するには、reCAPTCHA v2 (“I am not a robot”)​セクションを展開し、次の操作を行います。

    • Google API Website Key​に、Google reCAPTCHA アカウントを登録したときに、このreCAPTCHA タイプ用に作成されたweb サイト キーを入力します。

    • Google API Secret Key​に、Google reCAPTCHA アカウントに関連付けられている秘密鍵を入力します。

    • Size​の場合、表示するGoogle reCAPTCHA ボックスのサイズを選択します。 オプション：Normal (default) / Compact

    • Theme​で、Google reCAPTCHA ボックスのスタイル設定に使用するテーマを選択します。 オプション：Light Theme (default) / Dark Theme

    • Language Code​の場合、2文字のコードを入力して、Google reCAPTCHA テキストとメッセージに使用する言語を指定します。

    reCAPTCHA v2 - "I am not a robot" {width="600" modal="regular"}

  6. reCAPTCHA v2 Invisible​を使用するには、reCAPTCHA v2 Invisible​セクションを展開し、次の操作を行います。

    • Google API Website Key​に、Google reCAPTCHA アカウントを登録したときに、このreCAPTCHA タイプ用に作成されたweb サイト キーを入力します。

    • Google API Secret Key​に、Google reCAPTCHA アカウントに関連付けられている秘密鍵を入力します。

    • Invisible Badge Position​で、各ページで使用するバッジの位置を選択します。 オプション：Inline / Bottom Right / Bottom Left

    • Theme​で、Google reCAPTCHA ボックスのスタイル設定に使用するテーマを選択します。 オプション：Light Theme (default) / Dark Theme

    • Language Code​の場合、Google reCAPTCHA テキストとメッセージに使用される言語を指定する2文字のコードを入力します。

    reCAPTCHA v2 Invisible {width="600" modal="regular"}

  7. reCAPTCHA v3 Invisible​を使用するには、reCAPTCHA v3 Invisible​セクションを展開し、次の操作を行います。

    • Google API Website Key​に、Google reCAPTCHA アカウントを登録したときに、このreCAPTCHA タイプ用に作成されたweb サイト キーを入力します。

    • Google API Secret Key​に、Google reCAPTCHA アカウントに関連付けられている秘密鍵を入力します。

    • ユーザーとのやり取りが潜在的なリスクとしてフラグ付けされるタイミングを特定するには、Minimum Score Threshold​を入力します。ここでは、1.0は典型的なユーザーとのやり取りであり、0.0はボットである可能性が高いです。 既定：0.5

    • Invisible Badge Position​で、各ページで使用する位置を選択します。 オプション：Inline / Bottom Right / Bottom Left

    • Theme​で、Google reCAPTCHA ボックスのスタイル設定に使用するテーマを選択します。 オプション：Light Theme (default) / Dark Theme

    • Language Code​の場合、Google reCAPTCHA テキストとメッセージに使用される言語を指定する2文字のコードを入力します。

    reCAPTCHA v3 Invisible {width="600" modal="regular"}

  8. reCAPTCHA Validation Failure Messages​を展開し、検証が失敗した場合や完了できなかった場合に管理者に表示されるメッセージを入力します。

    reCAPTCHA失敗メッセージ ​ {width="600" modal="regular"}

  9. Admin Panel セクションを展開し、必要に応じて次の設定を行います。

    • 管理者サインインページに使用するreCAPTCHA タイプに​ Enable for Login ​を設定します。

    • パスワードのリセット要求に使用するreCAPTCHA タイプに​ Enable for Forgot Password ​を設定します。

    reCAPTCHA管理オプション ​ {width="600" modal="regular"}

手順3：ストアフロント用にGoogle reCAPTCHAを設定する

  1. Security​の下の左側のパネルで、Google reCAPTCHA Storefront​を選択します。

  2. ストアフロントで使用する各reCAPTCHA タイプのセクションを完了します。

    各reCAPTCHA タイプのオプションについて詳しくは、手順2：管理者​用にGoogle reCAPTCHAを設定するを参照してください。

  3. reCAPTCHA Validation Failure Messages​を展開し、検証が失敗した場合や完了できなかった場合にストアフロントに表示されるメッセージを入力します。

  4. Storefront セクションを展開します。

    note note
    NOTE
    設定する各フィールドの​Use system value チェックボックスをオフにします。

  5. 各ストアフロントの場所フィールドを、使用するように設定したreCAPTCHAのタイプに設定します。

手順4：設定の保存

  1. 設定が完了したら、Save Config​をクリックします。

  2. ワークスペースの上部にあるメッセージで「Cache Management」をクリックし、無効なキャッシュを1つずつ更新します。

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1