在网站上安装基于政策的验证密钥

您可以在网站上安装基于政策的验证密钥，以便仅在传入请求与配置的安全政策匹配时触发可视化人机识别系统验证。集成基于政策的密钥有助于为合法访问者维持顺畅的浏览体验，同时向可疑流量呈现有针对性的验证。

准备工作

  1. 为 Google Cloud Fraud Defense 准备好环境。

  2. 验证是否已为您的 Google Cloud 项目启用结算功能。

    reCAPTCHA 要求在项目中关联并启用结算功能，才能使用基于政策的验证密钥。您可以使用信用卡或现有 Google Cloud 项目结算 ID 来启用结算功能。如果您需要结算方面的帮助，请与 Cloud Billing 支持团队联系。

  3. 创建基于政策的质询密钥。

    或者，您也可以通过执行以下任一步骤来复制现有基于政策的质询密钥的 ID：

    • 如需从 Google Cloud 控制台复制现有密钥的 ID，请执行以下操作：

      1. 前往 Google Cloud Fraud Defense 页面。

        前往 Google Cloud Fraud Defense

      2. 选择密钥标签页。
      3. 在 reCAPTCHA 密钥列表中，找到要复制的密钥，然后点击 。
    • 如需使用 REST API 复制现有密钥的 ID，请使用 projects.keys.list 方法。
    • 如需使用 gcloud CLI 复制现有密钥的 ID，请使用 gcloud recaptcha keys list 命令。

配置基于政策的验证密钥

对于基于政策的验证密钥，您必须指定验证难度（决定人机识别系统验证的复杂性和频率），并为特定操作定义自定义得分阈值（会覆盖默认阈值）。

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

    前往 reCAPTCHA

  2. 检查项目名称是否显示在页面顶部的资源选择器中。

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

  3. 选择密钥标签页。

    密钥标签页有两个视图：表格和卡片。如果您的项目有许多 reCAPTCHA 密钥，则只有表格视图可用。

  4. 在 reCAPTCHA 密钥部分中，找到要配置的基于政策的验证任务密钥，然后点击该密钥。

  5. 在密钥详情页面上，点击概览标签页。

  6. 在配置部分中，点击验证设置对应的配置。

  7. 在配置验证设置页面上，选择验证难度。

  8. 如需触发人机识别系统验证，请使用滑块指定默认阈值。

    默认阈值 0.0 不会触发任何验证。阈值为 1.0 会针对每个请求触发验证。

  9. 如需为个别操作配置自定义得分阈值（该阈值会覆盖默认阈值），请执行以下操作：

    1. 输入操作名称。

    2. 如需指定自定义得分阈值，请使用设置操作阈值滑块。

    3. 点击完成。

  10. 点击保存。

在 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 令牌发送到后端，并在两分钟内创建评估。

后续步骤