在網站中安裝以政策為準的驗證問題金鑰

您可以在網站上安裝政策型驗證金鑰,只有在傳入要求符合設定的安全性政策時,才會觸發視覺 CAPTCHA 驗證。整合政策型金鑰,可確保合法訪客享有流暢的瀏覽體驗,同時對可疑流量進行針對性驗證。

事前準備

  1. 準備 Google Cloud Fraud Defense 環境。

  2. 確認 Google Cloud 專案已啟用計費功能。

    如要使用政策型驗證問題金鑰,必須在專案中連結並啟用 reCAPTCHA 計費功能。您可以使用信用卡或現有的 Google Cloud 專案帳單 ID 啟用計費功能。如需帳單方面的協助,請與 Cloud Billing 支援團隊聯絡。

  3. 建立政策型驗證金鑰。

    或者,您也可以執行下列任一步驟,複製現有政策型驗證金鑰的 ID:

    • 如要從 Google Cloud 控制台複製現有金鑰的 ID,請按照下列步驟操作:

      1. 前往 Google Cloud Fraud Defense 頁面。

        前往 Google Cloud Fraud Defense

      2. 選取「金鑰」分頁標籤。
      3. 在 reCAPTCHA 金鑰清單中,找出要複製的金鑰,然後按一下 。
    • 如要使用 REST API 複製現有金鑰的 ID,請使用 projects.keys.list 方法。
    • 如要使用 gcloud CLI 複製現有金鑰的 ID,請使用 gcloud recaptcha keys list 指令。

設定以政策為準的驗證金鑰

針對政策型驗證問題金鑰,您必須指定驗證問題難度,決定 CAPTCHA 驗證問題的複雜度和頻率,並為特定動作定義自訂分數門檻,覆寫預設門檻。

  1. 前往 Google Cloud 控制台的「reCAPTCHA」reCAPTCHA頁面。

    前往 reCAPTCHA

  2. 確認專案名稱顯示在頁面頂端的資源選取器中。

    如果找不到專案名稱,請按一下資源選取器,然後選取專案。

  3. 選取「金鑰」分頁標籤。

    「Keys」(金鑰) 分頁有兩種檢視畫面:「Table」(表格) 和「Cards」(資訊卡)。如果專案有多個 reCAPTCHA 金鑰,則只能使用「Table」(表格) 檢視畫面。

  4. 在「reCAPTCHA keys」(reCAPTCHA 金鑰) 區段中,找出要設定的政策型驗證金鑰,然後按一下該金鑰。

  5. 在「Key details」(金鑰詳細資料) 頁面中,按一下「Overview」(總覽) 分頁標籤。

  6. 在「設定」部分,按一下「驗證設定」的「設定」。

  7. 在「調整驗證問題設定」頁面,選取驗證問題難度。

  8. 如要觸發 CAPTCHA 驗證問題,請使用滑桿指定預設門檻值。

    預設門檻 0.0 不會觸發任何驗證。如果門檻設為 1.0,則每項要求都會觸發驗證。

  9. 如要為個別動作設定自訂分數門檻,覆寫預設門檻值,請按照下列步驟操作:

    1. 輸入動作名稱。

    2. 如要指定自訂分數門檻,請使用「Set action threshold」(設定動作門檻) 滑桿。

    3. 按一下「完成」。

  10. 按一下「儲存」。

在 HTML 按鈕上新增 reCAPTCHA

  1. 如要在網頁上載入 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 語言代碼。

  2. 如要在 HTML 按鈕上新增 reCAPTCHA,請按照下列步驟操作:

    1. 定義用來處理權杖的回呼函式。

      <script>
         function onSubmit(token) {
           document.getElementById("demo-form").submit();
         } // Use `requestSubmit()` for extra features like browser input validation.
      </script>

      詳情請參閱 requestSubmit() 方法。

    2. 為 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。

    3. 如果有人使用這個按鈕在網站上提交表單,g-recaptcha-response POST 參數就會包含回應權杖。

  3. 系統產生權杖後,請將 reCAPTCHA 權杖傳送至後端,並在兩分鐘內建立評估。

後續步驟