常見問題

我應該使用 reCAPTCHA Enterprise 嗎？

reCAPTCHA Enterprise 每月最多可免付費進行 10,000 次評估，並提供額外功能。其他功能 (例如即時數據分析) 是大多數開發人員的最佳起點。 按這裡開始。

reCAPTCHA 可以與第三方解決方案搭配使用嗎？

可以，您可以同時使用 reCAPTCHA (非 Enterprise 版本) 和 reCAPTCHA Enterprise。第三方解決方案通常會要求您提供公開金鑰，以及私密金鑰或 API 金鑰。請務必只將密鑰和 API 金鑰提供給信任的第三方。

如何從 v2 或 v3 遷移至 reCAPTCHA Enterprise？

遷移程序需要 5 到 10 分鐘才能完成，且不需變更程式碼。

我應該使用 reCAPTCHA v2 還是 v3？

reCAPTCHA v3 適合想進一步瞭解流量的網站擁有者。 詳情請參閱 reCAPTCHA v3 開發人員指南。

我們支援第 2 版的安全性和可用性。

如要進一步瞭解 reCAPTCHA v2 和 v3 的差異，請參閱版本比較。

reCAPTCHA 是否會使用 Cookie？

reCAPTCHA 執行時會設定必要的 Cookie (_GRECAPTCHA)，以便提供風險分析。 如果您不想使用可能已設定其他 Cookie 的 www.google.com 網域，可以改用 www.recaptcha.net。

使用 reCAPTCHA 時，是否有 QPS 或每日限制？

如要每秒呼叫超過 1,000 次或每月呼叫超過 1,000,000 次，請使用 reCAPTCHA Enterprise，或填寫這份表單並等待例外狀況核准。 如果網站金鑰超過 1,000 QPS，部分要求可能無法處理。 如果第 3 版網站金鑰超過每月配額，`site_verify` 可能會失敗，並在當月剩餘時間傳回靜態分數 0.9 和錯誤訊息 `"Over free quota."`。當第 3 版網站超過配額時，使用者不會看到任何提示。 如果 v2 網站金鑰超出每月配額，reCAPTCHA 小工具可能會在當月剩餘時間內，向使用者顯示以下或類似訊息：「這個網站已超出 reCAPTCHA 配額。」 在配額強制執行前，網站擁有者會收到三次電子郵件通知，並有至少 90 天的時間可遷移至 reCAPTCHA Enterprise。 如果任何網域每月呼叫次數超過 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 提供淺色和深色兩種主題，如下所示。如要選擇主題，只要在 grecaptcha.render 參數中設定 data-theme 屬性即可。

淺色主題：

深色主題：

如何自訂 reCAPTCHA v3？

隱形 reCAPTCHA 適用的 JavaScript API 也適用於 v3。只要使用 JavaScript API，透過第 3 版網站金鑰明確顯示 reCAPTCHA，即可存取重新定位徽章或變更主題等選項。

使用這個方法算繪 reCAPTCHA v3 時，請務必將 size 參數設為 'invisible'，並在呼叫 grecaptcha.execute 時使用 grecaptcha.render 傳回的用戶端 ID，而非網站金鑰。

我的 reCAPTCHA 小工具最近開始顯示「網站金鑰無效」。預期情況

如果看到這則錯誤訊息，表示 reCAPTCHA 網站金鑰已失效。如要啟用，請註冊新金鑰，並按照該頁面的操作說明進行。

我收到未擷取的 SecurityError：已封鎖來源為「https://www.google.com」的框架，禁止存取來源為「<您的網域>」的框架。該怎麼辦？

這種情況通常發生在使用者點選核取方塊後，系統透過程式輔助方式移除 reCAPTCHA 小工具 HTML 元素。建議使用 grecaptcha.reset() JavaScript 函式重設 reCAPTCHA 小工具。

我的網站使用內容安全政策 (CSP)。如何設定與 reCAPTCHA 搭配使用？

建議您使用 CSP3 記載的 Nonce 做法。 請務必在 reCAPTCHA api.js 指令碼標記中加入 Nonce，其餘部分由我們處理。

NOTE: reCAPTCHA also works with 'strict-dynamic' on browsers that support it.

或者，請在指令中加入下列值：

  • 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 方面的焦點錯誤，我們已向他們回報。這只會影響 iOS 10 使用者，且僅限部分網站。如果受到影響，可以將 reCAPTCHA 小工具移到頁面較高或較低的位置，或使用 reCAPTCHA v3。

我的電腦或網路可能正在傳送自動查詢？

如果您是從 reCAPTCHA 小工具導向這個頁面，應該會看到以下訊息：「很抱歉，您的電腦或網路可能正在傳送自動查詢。為保護使用者，我們目前無法處理你的要求。」

很遺憾，優質使用者也可能遇到這種情況，原因如下：

  • 你可能使用遭濫用的共用網路
  • 網際網路服務供應商最近可能指派了可疑的 IP 位址給你
  • 你嘗試存取的網站目前可能受到猛烈攻擊

如要排解這些問題，請參閱流量異常說明頁面，或稍後再試。

哪些動作名稱有效？

動作只能包含英數字元、斜線和底線。 動作不得因使用者而異。