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

本頁面說明如何在網站上安裝以政策為準的驗證金鑰。使用策略型驗證機制金鑰時，reCAPTCHA 會根據分數門檻和驗證難度，確定觸發 CAPTCHA 驗證問題。

事前準備

  1. 準備 reCAPTCHA 環境。

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

    reCAPTCHA 需要連結專案的帳單功能並啟用，才能使用以政策為準的驗證金鑰。你可以使用信用卡或現有 Google Cloud 專案帳單 ID 啟用帳單。如需帳單方面的協助，請與 Cloud Billing 支援團隊聯絡。

  3. 建立以政策為準的驗證金鑰。

    或者，您也可以執行下列任一步驟，複製現有以政策為準的驗證金鑰 ID：

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

      1. 前往 reCAPTCHA 頁面。

        前往 reCAPTCHA

      2. 在 reCAPTCHA 金鑰清單中，將指標懸停在要複製的金鑰上，然後按一下 。
    • 如要使用 REST API 複製現有金鑰的 ID，請使用 projects.keys.list 方法。
    • 如要使用 gcloud CLI 複製現有金鑰的 ID，請使用 gcloud recaptcha keys list 指令。

設定以政策為準的驗賽項目金鑰

如果是以政策為準的驗證問題金鑰，您必須指定驗證問題難度，決定驗證問題的複雜度和頻率，並為特定動作定義自訂分數門檻，覆寫預設門檻。

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

    前往 reCAPTCHA

    「reCAPTCHA」頁面提供「表格」和「資訊卡」兩種檢視模式。 如果專案有多個 reCAPTCHA 金鑰，則只能使用「表格」檢視畫面。

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

    如果沒有看到專案名稱，請按一下資源選取器，然後選取專案。

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

  4. 在「金鑰詳細資料」頁面上，按一下「總覽」分頁標籤。

  5. 在「設定」部分，按一下「挑戰設定」的「設定」。

  6. 在「調整驗證問題設定」頁面中，選取驗證問題難度。

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

    0.0 的預設閾值不會觸發任何驗證。如果閾值為 1.0，系統會針對每項要求觸發驗證。

  8. 如要為個別動作設定自訂分數門檻 (會覆寫預設門檻值)，請按照下列步驟操作：

    1. 輸入動作名稱。

    2. 如要指定自訂分數門檻，請使用「設定動作門檻」滑桿。

    3. 按一下 [完成]。

  9. 按一下 [儲存]。

在 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 權杖傳送至後端，並在兩分鐘內建立評估。

後續步驟