为网站创建 reCAPTCHA 密钥

管理控制台

1. 前往 reCAPTCHA 管理控制台。

   前往 reCAPTCHA 管理控制台

2. 在标签字段中，输入一个可用于标识您网站的名称。
3. 如果您要创建基于得分的键，请选择基于得分 (v3)。如果您要创建复选框键，请选择基于验证方式 (v2)。
4. 如需添加网域，请输入您的网域名称，然后点击 add 。

   如需添加其他网域，您可以重复此步骤。您最多可以添加 250 个网域。

5. 如果您刚开始使用 Google Cloud 控制台，请阅读服务条款，然后选中相应的复选框。
6. 点击提交。

如果您刚开始使用 Google Cloud 控制台，系统会创建一个 Google Cloud 项目并启用必要的 API，以便您开始使用。如果您已有 Google Cloud 项目，则系统会为您的项目启用必要的 API，以便您开始使用。

Cloud 控制台

1. 在 Google Cloud 控制台中，前往 reCAPTCHA 页面。

   前往 reCAPTCHA

2. 验证项目名称是否显示在页面顶部的项目选择器中。

   如果您没有看到项目名称，请点击资源选择器，然后选择您的项目。

3. 点击创建密钥。
4. 在显示名字段中，输入密钥的显示名。
5. 从选择平台类型菜单中，选择网站。

   系统会显示网域列表部分。

6. 输入您的网站的域名：

   1. 在网域列表部分中，点击添加网域。
   2. 在网域字段中，输入您的域名。

   3. 可选：要添加其他网域，请点击添加网域，然后在网域字段中输入其他网域的名称。 您最多可以添加 250 个网域。

      对于网站，reCAPTCHA 密钥对您指定的网域和子网域具有唯一性。如果您从多个网域传送您的网站，则可以指定多个网域。如果您指定了网域（例如 examplepetstore.com），则无需指定其子网域（例如 subdomain.examplepetstore.com）。

      如需在超过 250 个网域上使用一个密钥，请点击停用域名验证切换开关。 然后，reCAPTCHA 将忽略网域列表。 您需要自行执行域名验证，方法是检查您创建的评估中的 tokenProperties.hostname 字段。

7. 根据您要为网站创建的 reCAPTCHA 密钥类型，执行适当的操作：

创建基于得分的 reCAPTCHA 密钥

1. 可选：如果您要停用域名验证或允许 AMP 网页，请展开 Web 应用防火墙 (WAF)、域名验证、AMP 网页和验证部分。
   
   1. 为了保护您的网域和子网域的 reCAPTCHA 密钥，请确保关闭停用域名验证切换开关。

      停用域名验证是一项安全风险，因为网站不受限制，因此任何人都可以访问和使用 reCAPTCHA 密钥。

      
   2. 如果您希望允许基于得分的密钥用于 Accelerated Mobile Pages (AMP)，请开启允许将此密钥用于 AMP 网页切换开关。

   3. 对于非生产环境，如果您想指定在为键创建任何评估时该键应返回的分数，请执行以下操作：

      1. 点击这是一个测试密钥切换开关。
      2. 在 Score（得分）框中，指定一个介于 0 到 1.0 之间的得分。
      
   4. 点击创建密钥。

   新创建的密钥会列在 reCAPTCHA 密钥页面上。

创建复选框 reCAPTCHA 密钥

1. 展开 Web 应用防火墙 (WAF)、域名验证、AMP 网页和验证部分。
   
2. 为了保护您的网域和子网域的 reCAPTCHA 密钥，请确保关闭停用域名验证切换开关。

   停用域名验证是一项安全风险，因为网站不受限制，因此任何人都可以访问和使用 reCAPTCHA 密钥。

   
3. 开启使用复选框验证切换开关。
   
4. 选择适当的验证安全性选项。

   验证安全性选项可控制提示用户进行二级挑战的可能性，在二级挑战中，将提示用户根据已确定的类别选择图像（例如，选择含摩托车或楼梯的图片）。

   

   如果您想确保最佳的反欺诈防护，请选择难度较大（更加安全，可防范聊天机器人）。

   如果您选择最简单的验证难度，用户就不太可能收到视觉验证提示。

5. 对于非生产环境，如果您想指定在为键创建任何评估时该键应返回的分数，请执行以下操作：

   1. 点击这是一个测试密钥切换开关。
   2. 在 Score（得分）框中，指定一个介于 0 到 1.0 之间的得分。
   3. 选择适当的质询类型选项。
      • 自动有时会弹出相应挑战。
      • No CAPTCHA 表示不显示验证问题。
      • 不可避开的验证会显示图片，但无法通过验证。
      
   4. 点击创建密钥。

   新创建的密钥会列在 reCAPTCHA 密钥页面上。

gcloud

如需创建 reCAPTCHA 键，请使用 gcloud recaptcha keys create 命令。

在使用下面的命令数据之前，请先进行以下替换：

• DISPLAY_NAME：密钥的名称。通常是网站名称。
• INTEGRATION_TYPE：集成类型。 根据密钥类型，指定以下值：
  • score 表示基于得分的键。
  • checkbox 表示复选框键。
• DOMAIN_NAME：获准使用该密钥的网站的网域或子网域。

  以英文逗号分隔的列表形式指定多个网域。

  如需在超过 250 个网域上使用一个密钥，请指定 --allow-all-domains 以停用域名验证。 然后，reCAPTCHA 将忽略网域列表。 您需要自行执行域名验证，方法是检查您创建的评估中的 tokenProperties.hostname 字段。

  停用域名验证是一项安全风险，因为网站不受限制，因此任何人都可以访问和使用 reCAPTCHA 密钥。

执行 gcloud recaptcha keys create 命令：

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME

响应中包含新创建的 reCAPTCHA 密钥。

REST

在使用任何请求数据之前，请先进行以下替换：

• DISPLAY_NAME：密钥的名称。通常是网站名称。
• INTEGRATION_TYPE：集成类型。 根据密钥类型，指定以下值：
  • score 表示基于得分的键。
  • checkbox 表示复选框键。
• DOMAIN_NAME：获准使用该密钥的网站的网域或子网域。

  以英文逗号分隔的列表形式指定多个网域。

  如需在超过 250 个网域上使用一个密钥，请指定 --allow-all-domains 以停用域名验证。 然后，reCAPTCHA 将忽略网域列表。 您需要自行域名验证，方法是检查您创建的评估中的 tokenProperties.hostname 字段。

  停用域名验证是一项安全风险，因为网站不受限制，因此任何人都可以访问和使用 reCAPTCHA 密钥。

HTTP 方法和网址：

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

请求 JSON 正文：

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

如需发送请求，请选择以下方式之一：

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"

$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/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}