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

本頁面說明如何在網站上安裝以政策為準的驗證金鑰。有了以政策為準的驗證金鑰，reCAPTCHA 就能根據分數門檻和驗證難度，確定觸發 CAPTCHA 驗證問題。

事前準備

  1. 準備 reCAPTCHA 環境。

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

    或者，您也可以執行下列任一步驟，複製現有以政策為準的驗證金鑰 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. 在「Key details」(重要詳細資料) 頁面中，前往「Overview」(總覽) 分頁。

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

後續步驟