在迁移后使用 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. grecaptcha.enterprise.execute() 替换对 grecaptcha.execute() 的调用。

迁移后端调用

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

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

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

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

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

    虽然此方法速度更快,但我们建议您尽可能使用 v1 API,因为 Annotation API 等某些功能仅适用于 v1 API。

    v1 服务帐号 这是首选方法,但迁移后端调用需要的时间更长。
  3. 根据您选择的端点,创建 API 密钥,或创建和配置服务帐号。

后续步骤