您可以在網站上安裝政策型驗證金鑰,只有在傳入要求符合設定的安全性政策時,才會觸發視覺 CAPTCHA 驗證。整合政策型金鑰,可確保合法訪客享有流暢的瀏覽體驗,同時對可疑流量進行針對性驗證。
事前準備
如要使用政策型驗證問題金鑰,必須在專案中連結並啟用 reCAPTCHA 計費功能。您可以使用信用卡或現有的 Google Cloud 專案帳單 ID 啟用計費功能。如需帳單方面的協助,請與 Cloud Billing 支援團隊聯絡。
-
或者,您也可以執行下列任一步驟,複製現有政策型驗證金鑰的 ID:
如要從 Google Cloud 控制台複製現有金鑰的 ID,請按照下列步驟操作:
前往 Google Cloud Fraud Defense 頁面。
- 選取「金鑰」分頁標籤。
- 在 reCAPTCHA 金鑰清單中,找出要複製的金鑰,然後按一下 。
- 如要使用 REST API 複製現有金鑰的 ID,請使用 projects.keys.list 方法。
- 如要使用 gcloud CLI 複製現有金鑰的 ID,請使用 gcloud recaptcha keys list 指令。
設定以政策為準的驗證金鑰
針對政策型驗證問題金鑰,您必須指定驗證問題難度,決定 CAPTCHA 驗證問題的複雜度和頻率,並為特定動作定義自訂分數門檻,覆寫預設門檻。
前往 Google Cloud 控制台的「reCAPTCHA」reCAPTCHA頁面。
確認專案名稱顯示在頁面頂端的資源選取器中。
如果找不到專案名稱,請按一下資源選取器,然後選取專案。
選取「金鑰」分頁標籤。
「Keys」(金鑰) 分頁有兩種檢視畫面:「Table」(表格) 和「Cards」(資訊卡)。如果專案有多個 reCAPTCHA 金鑰,則只能使用「Table」(表格) 檢視畫面。
在「reCAPTCHA keys」(reCAPTCHA 金鑰) 區段中,找出要設定的政策型驗證金鑰,然後按一下該金鑰。
在「Key details」(金鑰詳細資料) 頁面中,按一下「Overview」(總覽) 分頁標籤。
在「設定」部分,按一下「驗證設定」的「設定」。
在「調整驗證問題設定」頁面,選取驗證問題難度。
如要觸發 CAPTCHA 驗證問題,請使用滑桿指定預設門檻值。
預設門檻
0.0不會觸發任何驗證。如果門檻設為1.0,則每項要求都會觸發驗證。如要為個別動作設定自訂分數門檻,覆寫預設門檻值,請按照下列步驟操作:
輸入動作名稱。
如要指定自訂分數門檻,請使用「Set action threshold」(設定動作門檻) 滑桿。
按一下「完成」。
按一下「儲存」。
在 HTML 按鈕上新增 reCAPTCHA
如要在網頁上載入 reCAPTCHA,請在網頁的
<head></head>元素中,加入 JavaScript API 和政策型驗證問題金鑰。<head> <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script> .... </head>reCAPTCHA 預設會使用瀏覽器的語言。如要指定其他語言,請在指令碼中使用
hl=LANG屬性。舉例來說,如要使用法文,請指定<script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>。如要瞭解支援的語言,請參閱 reCAPTCHA 語言代碼。如要在 HTML 按鈕上新增 reCAPTCHA,請按照下列步驟操作:
定義用來處理權杖的回呼函式。
<script> function onSubmit(token) { document.getElementById("demo-form").submit(); } // Use `requestSubmit()` for extra features like browser input validation. </script>詳情請參閱 requestSubmit() 方法。
為 HTML 按鈕新增屬性。
<button class="g-recaptcha" data-sitekey="KEY_ID" data-callback="onSubmit" data-action="submit">Submit</button>
如要指定徽章的位置,請在具有
class=g-recaptcha的元素上使用data-badge=LOCATION屬性。根據預設,位置會設為bottomright。其他可能的值為inline和bottomleft。如果有人使用這個按鈕在網站上提交表單,
g-recaptcha-responsePOST 參數就會包含回應權杖。
系統產生權杖後,請將 reCAPTCHA 權杖傳送至後端,並在兩分鐘內建立評估。
後續步驟
- 如要評估 reCAPTCHA 回應權杖,請建立評估。