與網站適用的 Google Cloud Armor 整合

本文說明如何在網站上整合 Google Cloud Fraud Defense for Cloud Armor。

如要完成整合，請導入一或多項 Cloud Armor 適用的 Fraud Defense 功能，並設定 Cloud Armor 安全性政策。

事前準備

  1. 啟用 reCAPTCHA Enterprise API。

    啟用 API 所需的角色

    您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  2. 規劃如何導入 Cloud Armor 的 Fraud Defense 功能，保護網站。

    1. 選擇一或多項最符合用途的 WAF 功能。
    2. 找出要保護的網頁，以及要在這些網頁上實作的 Cloud Armor 功能類型。

實作 Cloud Armor 的 Fraud Defense 功能

您可以根據需求，在單一應用程式中使用一或多項 Cloud Armor 的 Fraud Defense 功能。

如要使用多項功能，則必須為每項功能建立 reCAPTCHA 金鑰，並在應用程式中使用。舉例來說，如要使用 reCAPTCHA 動作權杖和 reCAPTCHA 驗證問題頁面，就必須建立動作權杖金鑰和驗證問題頁面金鑰，並在應用程式中使用。

導入 reCAPTCHA 動作權杖

您必須在網頁上執行 reCAPTCHA，才能產生動作權杖。 reCAPTCHA 產生動作權杖後，您可以在需要保護任何使用者動作 (例如 checkout) 的位置，將動作權杖附加至預先定義的要求標頭。動作權杖預設有效時間為 30 分鐘，但可能因流量而異。您必須在權杖到期前，將動作權杖附加至預先定義的要求標頭，Cloud Armor 才能評估權杖屬性。

如要導入 reCAPTCHA 動作權杖，請按照下列步驟操作：

  1. 為網站建立動作符記金鑰。

    Cloud 控制台

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

      前往 Google Cloud Fraud Defense

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

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

    3. 選取「金鑰」分頁標籤。
    4. 按一下「建立金鑰」。
    5. 在「Display name」(顯示名稱) 欄位中，輸入金鑰的顯示名稱。
    6. 視您要建立 reCAPTCHA 金鑰的 WAF 平台而定，執行適當的操作：
      1. 在「Application type」部分，選取「Web」。

        「網域清單」部分隨即顯示。

      2. 為保護網域和子網域的 reCAPTCHA 金鑰，請務必關閉「Disable domain verification」(停用網域驗證) 切換鈕。

        停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

      3. 輸入網站的網域名稱：

        1. 在「網域清單」部分，按一下「新增網域」。
        2. 在「Domain」欄位中輸入網域名稱。

        3. 選用：如要新增其他網域，請按一下「新增網域」，然後在「網域」欄位中輸入其他網域的名稱。最多可新增 250 個網域。

          如果是網站，reCAPTCHA 金鑰會因您指定的網域和子網域而異。如果網站透過多個網域提供服務，您可以指定多個網域。如果您指定網域 (例如 examplepetstore.com)，就不需要指定其子網域 (例如 subdomain.examplepetstore.com)。網域清單變更最多可能需要 30 分鐘才會生效。

      4. 在「其他設定」中，開啟「您是否要在網頁應用程式防火牆 (WAF) 中部署這個金鑰？」切換鈕。

      5. 在「功能」選項中，選取「動作」。

      6. 選用：開啟「您會使用驗證問題嗎？」切換鈕。

      7. 按一下 [Create key] (建立金鑰)。

        8. 新建立的金鑰會列在「reCAPTCHA keys」(reCAPTCHA 金鑰) 頁面。

    gcloud

    如要建立 reCAPTCHA 金鑰，請使用 gcloud recaptcha keys create 指令。

    使用下列任何指令資料前，請先替換以下項目：

    • INTEGRATION_TYPE：整合類型。 指定 score 或 checkbox。
    • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
    • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。

      如要指定多個網域，請以半形逗號分隔。選用：指定 --allow-all-domains 即可停用網域驗證。

      停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

    • WAF_FEATURE：WAF 功能的名稱。 指定 action-token。
    • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。

    執行 gcloud recaptcha keys create 指令：

    Linux、macOS 或 Cloud Shell

    gcloud recaptcha keys create \
--web \
--display-name=DISPLAY_NAME  \
--integration-type=INTEGRATION_TYPE \
--domains=DOMAIN_NAME \
--waf-feature=WAF_FEATURE \
--waf-service=WAF_SERVICE

    Windows (PowerShell)

    gcloud recaptcha keys create `
--web `
--display-name=DISPLAY_NAME  `
--integration-type=INTEGRATION_TYPE `
--domains=DOMAIN_NAME `
--waf-feature=WAF_FEATURE `
--waf-service=WAF_SERVICE

    Windows (cmd.exe)

    gcloud recaptcha keys create ^
--web ^
--display-name=DISPLAY_NAME  ^
--integration-type=INTEGRATION_TYPE ^
--domains=DOMAIN_NAME ^
--waf-feature=WAF_FEATURE ^
--waf-service=WAF_SERVICE

    回應中會包含新建立的 reCAPTCHA 金鑰。

    REST

    如需金鑰類型和整合類型的 API 參考資訊，請參閱「金鑰」和「整合類型」。

    使用任何要求資料之前，請先修改下列項目的值：

    • INTEGRATION_TYPE：整合類型。 指定 score 或 checkbox。
    • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
    • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。

      如要指定多個網域，請以半形逗號分隔。選用：指定 --allow-all-domains 即可停用網域驗證。

      停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

    • WAF_FEATURE：WAF 功能的名稱。 指定 action-token。
    • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。
    • DEFAULT_SCORE_THRESHOLD：如果是政策型驗證金鑰，這項設定會定義金鑰的一般驗證門檻 (未定義自訂分數門檻時)。這項功能目前為預先發布版。
    • ACTION_SCORE_THRESHOLDS：如果是政策型驗證金鑰，這個欄位會指定動作和對應的門檻分數 (介於 0.0 和 1.0 之間)。例如，login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'。這項功能目前為預先發布版。

    HTTP 方法和網址：

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

    JSON 要求內文：

    
{
  "displayName": "DISPLAY_NAME",
   'wafSettings': "  {
       "wafService": "WAF_SERVICE",
  
"wafFeature": "WAF_FEATURE"
  }
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "INTEGRATION_TYPE"
   }
   
}

    如要傳送要求，請選擇以下其中一個選項：

    curl

    將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

    PowerShell

    將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

    您應該會收到如下的 JSON 回覆：

    
{
  "name": "projects/project-id/keys/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
"displayName": "DISPLAY_NAME,

"webSettings": {
  "allowAllDomains": true,
  "allowedDomains": [
    "localhost"
  ],

 "integrationType": "SCORE",


},
"wafSettings": {
  "wafService": "CA",

  "wafFeature": "ACTION_TOKEN"
  

}
}

  2. 使用您建立的動作權杖金鑰，在網頁上整合 reCAPTCHA JavaScript。如需操作說明，請參閱與動作權杖金鑰整合類型對應的文件。

  3. 從 reCAPTCHA 收到權杖後，請將權杖附加至預先定義的要求標頭，格式如下： 

     X-Recaptcha-Token: value-of-your-action-token

    您可以使用 XHR、Ajax 或 Fetch API 等語言，將權杖附加至預先定義的要求標頭。

    下列指令碼範例說明如何使用 JavaScript + XHR 保護 execute 動作，並將權杖附加至預先定義的要求標頭：

      
  <script>
    src="https://www.google.com/recaptcha/enterprise.js?render=ACTION_TOKEN_KEY"></script>

    <script>
    function onSuccess(action_token) {
         const xhr = new XMLHttpRequest();
         xhr.open('GET','YOUR_URL', false);
         // Attach the action-token to the predefined request header
         xhr.setRequestHeader("X-Recaptcha-Token", action_token);
         xhr.send(null);
       }
       function onError(reason) {
         alert('Response promise rejected: ' + reason);
       grecaptcha.enterprise.ready(function () {
         document.getElementById("execute-button").onclick = () => {
           grecaptcha.enterprise.execute('ACTION_TOKEN_KEY', {
           }).then(onSuccess, onError);
         };
       });
      }
    </script>

導入 reCAPTCHA 工作階段權杖

呼叫 execute() 後，reCAPTCHA JavaScript 會在使用者的瀏覽器，將 reCAPTCHA 工作階段權杖設為 Cookie。只要 reCAPTCHA JavaScript 保持啟用，使用者的瀏覽器就會附加並重新整理 Cookie。

如要以 Cookie 形式提供工作階段權杖，請在使用者瀏覽受保護網頁前，至少在一個網頁上安裝工作階段權杖金鑰。舉例來說，如要保護結帳頁面，請在首頁或產品頁面安裝工作階段符記金鑰。

如要瞭解如何在網頁上安裝工作階段符記金鑰，請參閱「整合評分金鑰與前端」。

您可以使用這個 Cookie，保護使用者後續在特定網域上提出的要求和載入的網頁。工作階段權杖的預設效期為 30 分鐘。不過，如果使用者停留在您導入工作階段權杖的頁面，reCAPTCHA 會定期重新整理工作階段權杖，防止權杖過期。

在需要 reCAPTCHA 保護的每個頁面安裝工作階段符記。 建議您使用 reCAPTCHA 保護每個頁面，並使用 Cloud Armor 規則強制執行所有頁面的存取權，但使用者瀏覽的第一個頁面除外。

以下是 reCAPTCHA 工作階段權杖範例： 
   recaptcha-ca-t=value-of-your-session-token;domain=domain;expires=expiration_time

如要導入 reCAPTCHA 工作階段權杖，請按照下列步驟操作：

  1. 為網站建立工作階段符記金鑰。

    Cloud 控制台

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

      前往 Google Cloud Fraud Defense

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

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

    3. 選取「金鑰」分頁標籤。
    4. 按一下「建立金鑰」。
    5. 在「Display name」(顯示名稱) 欄位中，輸入金鑰的顯示名稱。
    6. 視您要建立 reCAPTCHA 金鑰的 WAF 平台而定，執行適當的操作：
      1. 在「Application type」部分，選取「Web」。

        「網域清單」部分隨即顯示。

      2. 為保護網域和子網域的 reCAPTCHA 金鑰，請務必關閉「Disable domain verification」(停用網域驗證) 切換鈕。

        停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

      3. 輸入網站的網域名稱：

        1. 在「網域清單」部分，按一下「新增網域」。
        2. 在「Domain」欄位中輸入網域名稱。

        3. 選用：如要新增其他網域，請按一下「新增網域」，然後在「網域」欄位中輸入其他網域的名稱。最多可新增 250 個網域。

          如果是網站，reCAPTCHA 金鑰會因您指定的網域和子網域而異。如果網站透過多個網域提供服務，您可以指定多個網域。如果您指定網域 (例如 examplepetstore.com)，就不需要指定其子網域 (例如 subdomain.examplepetstore.com)。網域清單變更最多可能需要 30 分鐘才會生效。

      4. 在「其他設定」中，開啟「您是否要在網頁應用程式防火牆 (WAF) 中部署這個金鑰？」切換鈕。

      5. 在「Feature」(功能) 選項中，選取「Session」(工作階段)。

      6. 選用：開啟「停用網域驗證」。

        停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

      7. 按一下 [Create key] (建立金鑰)。

        8. 新建立的金鑰會列在「reCAPTCHA keys」(reCAPTCHA 金鑰) 頁面。

    gcloud

    如要建立 reCAPTCHA 金鑰，請使用 gcloud recaptcha keys create 指令。

    使用下列任何指令資料前，請先替換以下項目：

    • INTEGRATION_TYPE：整合類型。 指定 score。
    • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
    • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。

      如要指定多個網域，請以半形逗號分隔。選用：指定 --allow-all-domains 即可停用網域驗證。

      停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

    • WAF_FEATURE：WAF 功能的名稱。 指定 session-token。
    • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。

    執行 gcloud recaptcha keys create 指令：

    Linux、macOS 或 Cloud Shell

    gcloud recaptcha keys create \
--web \
--display-name=DISPLAY_NAME  \
--integration-type=INTEGRATION_TYPE \
--domains=DOMAIN_NAME \
--waf-feature=WAF_FEATURE \
--waf-service=WAF_SERVICE

    Windows (PowerShell)

    gcloud recaptcha keys create `
--web `
--display-name=DISPLAY_NAME  `
--integration-type=INTEGRATION_TYPE `
--domains=DOMAIN_NAME `
--waf-feature=WAF_FEATURE `
--waf-service=WAF_SERVICE

    Windows (cmd.exe)

    gcloud recaptcha keys create ^
--web ^
--display-name=DISPLAY_NAME  ^
--integration-type=INTEGRATION_TYPE ^
--domains=DOMAIN_NAME ^
--waf-feature=WAF_FEATURE ^
--waf-service=WAF_SERVICE

    回應中會包含新建立的 reCAPTCHA 金鑰。

    REST

    如需金鑰類型和整合類型的 API 參考資訊，請參閱「金鑰」和「整合類型」。

    使用任何要求資料之前，請先修改下列項目的值：

    • INTEGRATION_TYPE：整合類型。 指定 score。
    • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
    • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。

      如要指定多個網域，請以半形逗號分隔。選用：指定 --allow-all-domains 即可停用網域驗證。

      停用網域驗證機制會造成安全風險，因為網站沒有任何限制，任何人都能存取及使用您的 reCAPTCHA 金鑰。

    • WAF_FEATURE：WAF 功能的名稱。 指定 session-token。
    • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。
    • DEFAULT_SCORE_THRESHOLD：如果是政策型驗證金鑰，這項設定會定義金鑰的一般驗證門檻 (未定義自訂分數門檻時)。這項功能目前為預先發布版。
    • ACTION_SCORE_THRESHOLDS：如果是策略型驗證金鑰，這個欄位會指定動作和對應的門檻分數 (介於 0.0 和 1.0 之間)。例如，login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'。這項功能目前為預先發布版。

    HTTP 方法和網址：

    POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

    JSON 要求內文：

    
{
  "displayName": "DISPLAY_NAME",
   'wafSettings': "  {
       "wafService": "WAF_SERVICE",
  
"wafFeature": "WAF_FEATURE"
  }
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "INTEGRATION_TYPE"
   }
   
}

    如要傳送要求，請選擇以下其中一個選項：

    curl

    將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
         "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

    PowerShell

    將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

    $cred = gcloud auth print-access-token
    $headers = @{ "Authorization" = "Bearer $cred" }

    Invoke-WebRequest `
        -Method POST `
        -Headers $headers `
        -ContentType: "application/json; charset=utf-8" `
        -InFile request.json `
        -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

    您應該會收到如下的 JSON 回覆：

    
{
  "name": "projects/project-id/keys/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
"displayName": "DISPLAY_NAME,

"webSettings": {
  "allowAllDomains": true,
  "allowedDomains": [
    "localhost"
  ],

 "integrationType": "SCORE",


},
"wafSettings": {
  "wafService": "CA",

  "wafFeature": "SESSION_TOKEN"


}
}

  2. 將工作階段權杖金鑰和 waf=session 新增至 reCAPTCHA JavaScript。

    以下範例指令碼說明如何在網頁上導入工作階段權杖：

    <!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>reCAPTCHA WAF Session Token</title>
 <script src="https://www.google.com/recaptcha/enterprise.js?render=SESSION_TOKEN_KEY&waf=session"></script>
</head>
<body></body>
</html>

導入 reCAPTCHA 驗證問題頁面

導入 reCAPTCHA 驗證問題頁面後，reCAPTCHA 會重新導向至插頁式頁面，判斷是否需要向使用者顯示 CAPTCHA 驗證問題。因此，並非所有使用者都會看到 CAPTCHA 驗證。

如要導入 reCAPTCHA 驗證問題頁面，請為網站建立驗證頁面金鑰。

Cloud 控制台

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

    前往 Google Cloud Fraud Defense

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

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

  3. 選取「金鑰」分頁標籤。
  4. 按一下「建立金鑰」。
  5. 在「Display name」(顯示名稱) 欄位中，輸入金鑰的顯示名稱。
  6. 視您要建立 reCAPTCHA 金鑰的 WAF 平台而定，執行適當的操作：
    1. 在「Application type」部分，選取「Web」。
    2. 在「其他設定」中，開啟「您是否要在網頁應用程式防火牆 (WAF) 中部署這個金鑰？」切換鈕。

    3. 在「功能」選項中，選取「挑戰」。

    4. 開啟「停用網域驗證」。

      如果停用驗證頁面金鑰的網域驗證功能，Cloud Armor 會驗證網域。

    5. 按一下 [Create key] (建立金鑰)。

      6. 新建立的金鑰會列在「reCAPTCHA keys」(reCAPTCHA 金鑰) 頁面。

gcloud

如要建立 reCAPTCHA 金鑰，請使用 gcloud recaptcha keys create 指令。

使用下列任何指令資料前，請先替換以下項目：

  • INTEGRATION_TYPE：整合類型。 指定 invisible。
  • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
  • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。指定 --allow-all-domains。
  • WAF_FEATURE：WAF 功能的名稱。 指定 challenge-page。
  • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。

執行 gcloud recaptcha keys create 指令：

Linux、macOS 或 Cloud Shell

gcloud recaptcha keys create \
--web \
--display-name=DISPLAY_NAME  \
--integration-type=INTEGRATION_TYPE \
--domains=DOMAIN_NAME \
--waf-feature=WAF_FEATURE \
--waf-service=WAF_SERVICE

Windows (PowerShell)

gcloud recaptcha keys create `
--web `
--display-name=DISPLAY_NAME  `
--integration-type=INTEGRATION_TYPE `
--domains=DOMAIN_NAME `
--waf-feature=WAF_FEATURE `
--waf-service=WAF_SERVICE

Windows (cmd.exe)

gcloud recaptcha keys create ^
--web ^
--display-name=DISPLAY_NAME  ^
--integration-type=INTEGRATION_TYPE ^
--domains=DOMAIN_NAME ^
--waf-feature=WAF_FEATURE ^
--waf-service=WAF_SERVICE

回應中會包含新建立的 reCAPTCHA 金鑰。

REST

如需金鑰類型和整合類型的 API 參考資訊，請參閱「金鑰」和「整合類型」。

使用任何要求資料之前，請先修改下列項目的值：

  • INTEGRATION_TYPE：整合類型。 指定 invisible。
  • DISPLAY_NAME：金鑰名稱。通常是網站名稱。
  • DOMAIN_NAME：允許使用金鑰的網站網域或子網域。指定 --allow-all-domains。
  • WAF_FEATURE：WAF 功能的名稱。 指定 challenge-page。
  • WAF_SERVICE：WAF 服務供應商的名稱。為 Cloud Armor 指定 CA。
  • DEFAULT_SCORE_THRESHOLD：如果是政策型驗證金鑰，這項設定會定義金鑰的一般驗證門檻 (未定義自訂分數門檻時)。這項功能目前為預先發布版。
  • ACTION_SCORE_THRESHOLDS：如果是政策型驗證金鑰，這個欄位會指定動作和對應的門檻分數 (介於 0.0 和 1.0 之間)。例如，login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'。這項功能目前為預先發布版。

HTTP 方法和網址：

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys

JSON 要求內文：


{
  "displayName": "DISPLAY_NAME",
   'wafSettings': "  {
       "wafService": "WAF_SERVICE",
  
"wafFeature": "WAF_FEATURE"
  }
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "INTEGRATION_TYPE"
   }
   
}

如要傳送要求，請選擇以下其中一個選項：

curl

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

PowerShell

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：


{
  "name": "projects/project-id/keys/7Ldqgs0UBBBBBIn4k7YxEB-LwEh5S9-Gv6QQIWB8m",
"displayName": "DISPLAY_NAME,

"webSettings": {
  "allowAllDomains": true,
  "allowedDomains": [
    "localhost"
  ],

  "integrationType": "INVISIBLE",
 

},
"wafSettings": {
  "wafService": "CA",

  "wafFeature": "CHALLENGE_PAGE"
  

}
}

設定 Cloud Armor 安全性政策

導入 Cloud Armor 的 Fraud Defense 功能後，您必須設定 Cloud Armor 安全性政策，以便管理機器人。

如果您導入了 reCAPTCHA 驗證問題頁面，則必須執行下列操作：

  1. 將驗證頁面金鑰與安全性政策建立關聯。
  2. 設定安全性政策規則，將要求重新導向至 reCAPTCHA 評估。

如果您導入 reCAPTCHA 動作權杖或工作階段符記，則必須設定安全性政策規則，評估 reCAPTCHA 權杖。

設定 Cloud Armor 安全性政策前，請先瞭解 Cloud Armor 的 reCAPTCHA 權杖屬性。

如要瞭解如何設定 Cloud Armor 安全性政策，以及如何將 WAF 的 reCAPTCHA 金鑰與安全性政策搭配使用，請參閱「設定機器人管理規則」。

取得 reCAPTCHA 分數

如果是 reCAPTCHA 動作符記和工作階段符記，您可以從 X-Recaptcha-Wafdata 標頭取得 reCAPTCHA 分數。您可以根據這些分數，設定要對使用者要求採取的任何自訂動作。

以下是 X-Recaptcha-Wafdata 標頭範例：

X-Recaptcha-Wafdata: waf_service="Google Cloud Armor", action_token;score=0.9, session_token;score=0.8\r\n

您也可以在 Google Cloud Armor 記錄中查看 reCAPTCHA 分數。

後續步驟