文件CommerceAdmin System指南

Google reCAPTCHA

Last update: Thu May 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 初學者
  • 中繼
  • 管理員

Google reCAPTCHA可確保人(而非電腦（或「機器人」）)與您的網站互動。 與標準Adobe Commerce和Magento Open Source CAPTCHA不同，Google reCAPTCHA透過選取不同的顯示選項和方法，提供增強式安全性。 您可在Google reCAPTCHA帳戶的控制面板中取得其他網站流量資訊。

Google reCAPTCHA已針對管理員和店面分別設定。

  • 針對管理員，Google reCAPTCHA可用於登入頁面以及使用者要求重設密碼時。 如果標準Commerce CAPTCHA也已啟用，則可同時使用Google reCAPTCHA而不會發生任何問題。

  • 對於店面，Google reCAPTCHA可用於登入客戶帳戶、從聯絡我們頁面及許多其他店面位置傳送訊息。

    Google reCAPTCHA — 客戶登入 {width="700" modal="regular"}

Google reCAPTCHA可透過數種方式實作：

  • reCAPTCHA v3不可見 — 使用演演算法來評估使用者互動，並根據分數判斷使用者是否為人類的可能性。

  • reCAPTCHA v2不可見 — 執行背景驗證而不需使用者互動。 使用者和客戶會自動驗證，但可能需要選取特定影像以完成挑戰。

  • reCAPTCHA v2 （「我不是機器人」） — 使用​ 「我不是機器人」 ​核取方塊驗證要求。

IMPORTANT
設定Google reCAPTCHA之前，請確定您的PHP.ini檔案包含下列設定： allow_url_fopen = 1。 這可能需要開發人員協助。 請參閱安裝指南中的必要的PHP設定。

步驟1：產生Google reCAPTCHA金鑰

Google reCAPTCHA需要一對API金鑰才能啟用。 您可以透過reCAPTCHA網站免費取得這些金鑰。 在產生金鑰之前，您必須知道您要使用的reCAPTCHA型別。

  1. 開啟Google reCAPTCHA頁面並登入您的帳戶。

  2. 針對​ Label，輸入名稱以識別內部參考的索引鍵。

    Adobe Commerce或Magento Open Source安裝中所使用的每個reCAPTCHA型別，都需要一組金鑰。 例如： Commerce Invisible

  3. 針對​ reCAPTCHA type，選擇您要使用的方法。

    • reCAPTCHA v3隱藏
    • reCAPTCHA v2隱藏
    • reCAPTCHA v2 （「我不是機器人」）

  4. 針對​ Domain，輸入您商店的網域。 例如： mystore.com

    如果您有多個不同網域的商店，請在單獨的行中輸入每個網域。

    • 新增您的商店網域及任何子網域。
    • 您可以視測試需要新增localhost、其他本機VM網域和暫存網域。

  5. 選取​ Accept the reCAPTCHA Terms of Service ​的核取方塊。

  6. （選擇性）選取​ Send alerts to owners ​核取方塊，以在Google偵測到問題或可疑流量時傳送通知。

  7. 按一下​ Submit ​完成註冊並接收金鑰。

    note important
    IMPORTANT
    並非所有金鑰都適用於所有型別的reCAPTCHA，若未套用這些金鑰可能會導致非預期的行為。 例如，為reCAPTCHA v2 「我不是機器人」產生的Google reCAPTCHA金鑰無法搭配​_reCAPTCHA v2 Invisible_​使用，且可能會封鎖啟用reCAPTCHA的功能。

步驟2：為管理員設定Google reCAPTCHA

僅[個PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

  1. 登入您的管理員帳戶。

  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型別建立的網站金鑰。

    • 針對​ Google API Secret Key，輸入與您的Google reCAPTCHA帳戶相關聯的秘密金鑰。

    • 針對​ Size，選擇您要顯示的Google reCAPTCHA方塊大小。 選項： Normal (default) / Compact

    • 針對​ Theme，選擇您要用來設定Google reCAPTCHA方塊樣式的佈景主題。 選項： Light Theme (default) / Dark Theme

    • 針對​ Language Code，輸入雙字元代碼，以指定用於Google reCAPTCHA文字與傳訊🔗的語言。

    reCAPTCHA v2 - 「我不是機器人」 {width="600" modal="regular"}

  6. 若要使用​ reCAPTCHA v2 Invisible，請展開​ reCAPTCHA v2 Invisible ​區段並執行下列動作：

    • 針對​ Google API Website Key，輸入在您註冊Google reCAPTCHA帳戶時為此reCAPTCHA型別建立的網站金鑰。

    • 針對​ 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文字與訊息的語言。

    reCAPTCHA v2隱藏 {width="600" modal="regular"}

  7. 若要使用​ reCAPTCHA v3 Invisible，請展開​ reCAPTCHA v3 Invisible ​區段並執行下列動作：

    • 針對​ Google API Website Key，輸入在您註冊Google reCAPTCHA帳戶時為此reCAPTCHA型別建立的網站金鑰。

    • 針對​ 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文字與訊息的語言。

    reCAPTCHA v3隱藏 {width="600" modal="regular"}

  8. 展開​ reCAPTCHA Validation Failure Messages ​並輸入在驗證失敗或無法完成時顯示在管理員中的訊息。

    reCAPTCHA失敗訊息 {width="600" modal="regular"}

  9. 展開​ Admin Panel ​區段，並視需要設定下列專案：

    • 將​ Enable for Login ​設為您要用於管理員登入頁面的reCAPTCHA型別。

    • 將​ Enable for Forgot Password ​設為您要用於密碼重設要求的reCAPTCHA型別。

    reCAPTCHA管理選項 {width="600" modal="regular"}

步驟3：為店面設定Google reCAPTCHA

  1. 在左側面板的​ Security ​下，選擇​ Google reCAPTCHA Storefront。

  2. 針對您要在店面中使用的每個reCAPTCHA型別，完成區段。

    請參閱​ 步驟2：為管理員設定Google reCAPTCHA中的資訊，以取得有關每個reCAPTCHA型別的選項的詳細資訊。

  3. 展開​ reCAPTCHA Validation Failure Messages ​並輸入在驗證失敗或無法完成時顯示在店面中的訊息。

  4. 展開​ Storefront ​區段。

    note note
    NOTE
    清除您要設定的每個欄位的​ Use system value ​核取方塊。

  5. 將每個店面位置欄位設定為您已設定要使用的reCAPTCHA型別。

    • Enable for Customer Login
    • Enable for Forgot Password
    • Enable for Create New Customer Account
    • Enable for Edit Customer Account
    • Enable for Create New Company Account Adobe Commerce B2B (僅適用於Adobe Commerce B2B)
    • Enable for Contact Us
    • Enable for Product Review
    • Enable for Newsletter Subscription
    • Enable for Gift Card Adobe Commerce (僅限Adobe Commerce)
    • Enable for Invitation Create Account
    • Enable for Send To Friend
    • Enable for Checkout/Placing Order
    • Enable for Wishlist Sharing
    • Enable for Coupon Codes
    • Enable for PayPal PayflowPro payment form

    店面選項組態 {width="600" modal="regular"}

步驟4：儲存設定

  1. 組態設定完成後，按一下​ Save Config。

  2. 在工作區頂端的訊息中，按一下​ Cache Management ​並重新整理每個無效的快取。

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