在迁移后使用 reCAPTCHA Enterprise 功能

本页面介绍在从非 Enterprise 版 reCAPTCHA 迁移后,如何修改现有 reCAPTCHA 集成以使用 reCAPTCHA Enterprise 功能(例如多重身份验证 (MFA) 和密码泄露检测)。修改现有 reCAPTCHA 集成涉及对网页进行插桩处理和迁移后端调用。

准备工作

迁移到 reCAPTCHA Enterprise

检测网页

要使用 reCAPTCHA Enterprise 脚本和调用对网页进行插桩处理,请执行以下操作:

  1. 验证您的页面中包含以下脚本:https://www.google.com/recaptcha/api.js
  2. api.js 组件更改为 enterprise.js
  3. 如果您以编程方式调用 API,请替换以下调用:

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

(可选)如需提高 reCAPTCHA Enterprise 的加载性能,请执行以下操作:

  1. 验证您是否是异步加载 enterprise.js。如需了解详情,请参阅异步加载 reCAPTCHA

  2. 在加载 enterprise.js 的页面 <head> 标记中添加以下资源提示:

    • <link rel="preconnect" href="https://www.google.com">
    • <link rel="preconnect" href="https://www.gstatic.com" crossorigin>

迁移后端调用

要使用 reCAPTCHA Enterprise 功能,您必须将后端调用迁移到新端点并设置身份验证:

  1. 将对 https://www.google.com/recaptcha/api/siteverify 的后端调用替换为 https://recaptchaenterprise.googleapis.com

  2. 选择要用于创建评估的端点和身份验证方法:

    端点 身份验证方法 备注
    v1beta1 API 密钥

    这是迁移后端调用的最快方法。

    v1 服务帐号 这是首选方法,但迁移后端调用可能需要更多时间,因为您需要使用 Cloud SDK 或客户端库进行身份验证。
  3. 根据您选择的端点,创建 API 密钥,或创建和配置服务帐号。

后续步骤