協調管理控制台和 Google Cloud 控制台的術語

本文說明如何識別 reCAPTCHA 金鑰版本 (v2 或 v3)、將舊版 reCAPTCHA 管理控制台術語對應至Google Cloud 控制台，以及擷取內容管理系統 (CMS) 平台和第三方外掛程式 (例如 WordPress 或 Shopify 整合) 所需的網站金鑰和密鑰。

將舊版術語對應至 Google Cloud 控制台

如果您只在 reCAPTCHA 管理控制台管理金鑰，代表您使用的是 reCAPTCHA Classic。如果您是在 Google Cloud 控制台的 Google Cloud Fraud Defense 頁面管理金鑰，代表您使用的是 Fraud Defense。這兩個控制台都支援 v2 和 v3 網站金鑰。

許多 CMS 平台和外掛程式會使用舊版號碼參照 reCAPTCHA 金鑰，例如 v2 Checkbox、v2 Invisible 和 v3。Google Cloud 控制台會使用平台型描述元，而非版本號碼。

下表列出舊版 CMS 和管理控制台術語與Google Cloud 控制台術語的對應關係：

CMS 或管理控制台術語 Google Cloud 控制台 (平台詳細資料) 編輯金鑰 (「Type」欄位) 驗證機制和 CMS 相容性
以分數為依據 (v3) Website • score Website • Score 順暢無阻、以分數為依據的驗證機制。適用於需要 reCAPTCHA v3 的 CMS 外掛程式。
驗證問題 (v2) Website • checkbox Website • Checkbox challenge 使用者必須勾選「我不是機器人」核取方塊。適用於需要 reCAPTCHA v2 核取方塊的 CMS 外掛程式。
隱形 (v2) Website • invisible Website • Invisible integration 在背景分析風險，並可能顯示驗證問題。適用於需要 reCAPTCHA v2 隱形的 CMS 外掛程式。
不適用 Website • policy-based challenge Website • Policy-based challenge 依據設定的分數門檻，觸發驗證問題。需要自訂 CreateAssessment 整合。
不適用 iOS iOS app iOS 行動金鑰，不需驗證。
不適用 Android Android app Android 行動金鑰，不需驗證。

在 Google Cloud 控制台中查看金鑰版本

如要在 Google Cloud 控制台查看金鑰版本，請按照下列步驟操作：

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

    前往 Fraud Defense

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

  3. 如果金鑰位於「資訊卡」檢視畫面，請切換至「表格」檢視畫面。

  4. 查看金鑰的「Platform details」(平台詳細資料) 欄。例如，Website • score 對應 v3，Website • checkbox 則對應 v2 Checkbox。

  5. 選用。在「資訊卡」檢視畫面中，按一下金鑰資訊卡上的「金鑰詳細資料」，然後選取「編輯金鑰」。「Type」(類型) 欄位會顯示金鑰設定，例如 v3 的 Website • Score 或 v2 Checkbox 的 Website • Checkbox challenge。

找出網站金鑰和密鑰

第三方外掛程式和 CMS 平台通常需要網站金鑰和密鑰，才能整合 reCAPTCHA：

  • 網站金鑰： Google Cloud 控制台中的「Key ID」(金鑰 ID) 對應至網站金鑰。
  • Secret key： Google Cloud 控制台預設不會顯示 Secret key，因為 Google Cloud 驗證通常會使用 API 金鑰或 Identity and Access Management 角色。不過，您可以擷取外掛程式所需的舊版密鑰。部分第三方資料庫或說明文件可能會將舊版密鑰稱為「私密金鑰」。

在 Google Cloud 控制台中擷取 Secret 金鑰

如要擷取網站金鑰和密鑰，請按照下列步驟操作：

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

    前往 Fraud Defense

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

  3. 在「reCAPTCHA Keys」(reCAPTCHA 金鑰) 專區中，找出需要密鑰的金鑰：

    • 如果使用「資訊卡」檢視畫面，請按一下金鑰資訊卡上的「重要詳細資料」。 金鑰 ID 會顯示在頁面頂端。
    • 如果使用「表格」檢視畫面，表格中會顯示「金鑰 ID」。按一下金鑰，前往詳細資料頁面。

  4. 複製頁面頂端顯示的金鑰 ID。這個值就是網站金鑰。

  5. 前往「Integration」(整合) 分頁。

  6. 視金鑰狀態而定，執行下列其中一項操作：

    • 如果金鑰已設為舊版，請按一下「使用舊版金鑰」。
    • 如果金鑰未與舊版服務整合，請按一下「Integrate with a third-party service or plugin」(與第三方服務或外掛程式整合)。

  7. 畫面上會顯示一個對話方塊，其中包含您的密鑰。請妥善複製這個值。請將這個密鑰視為機密資料。

    或者，在「Key details」(金鑰詳細資料) 頁面中，按一下「Edit key」(編輯金鑰)，然後點選「Secret key」(密鑰) 欄位旁的「Reveal」(顯示)。

與 WordPress、Shopify 或其他 CMS 平台整合

如果您使用網站製作工具、電子商務平台或 CMS 外掛程式，平台或外掛程式會自動載入 reCAPTCHA 指令碼並驗證使用者權杖。您不需要安裝 reCAPTCHA 用戶端程式庫，也不必編寫自訂後端程式碼。

如要在 CMS 或第三方外掛程式中設定 reCAPTCHA，請按照下列步驟操作：

  1. 查看 CMS 或外掛程式所需的 reCAPTCHA 版本：在 CMS 或外掛程式中開啟 reCAPTCHA 整合設定，查看支援的金鑰類型 (通常是 reCAPTCHA v3 或 reCAPTCHA v2 核取方塊)。

  2. 選取或建立比對鍵：

    • 如果您已有金鑰，請查看金鑰版本，確認與外掛程式中選取的版本相符 (v3 應為 Website • score，v2 Checkbox 應為 Website • checkbox)。
    • 如需新金鑰，請為網站建立金鑰，並確保金鑰符合所需版本，然後將網站網域 (例如 example.com) 新增至金鑰的「Domain list」(網域清單)。

  3. 複製網站金鑰和舊版密鑰：按照「在Google Cloud 控制台擷取密鑰」一節的步驟，取得金鑰 ID (網站金鑰) 和密鑰。

  4. 在 CMS 或外掛程式設定中輸入金鑰：

    • 將金鑰 ID 貼到「Site key」(網站金鑰) 欄位。
    • 將密鑰貼到「Secret key」(密鑰) (或「Private key」(私密金鑰)) 欄位，然後儲存設定。

使用評量整合自訂網站

CreateAssessment 方法提供詳細的風險分析和原因代碼，並可存取進階 Fraud Defense 功能。您可以使用 reCAPTCHA 用戶端程式庫或 REST API 呼叫 CreateAssessment 方法。

詳情請參閱「為網站建立評估作業」。

舊版 SiteVerify 方法

雖然我們建議在新的和自訂整合中使用 CreateAssessment 方法，但部分現有系統或第三方外掛程式仍依賴舊版 SiteVerify 方法。這個方法需要與 reCAPTCHA 金鑰相關聯的密鑰。

如需與需要舊版 SiteVerify API 的系統整合，請參閱「使用舊版 SiteVerify 驗證使用者回應權杖」。

後續步驟