本文档介绍了如何识别 reCAPTCHA 密钥版本（v2 或 v3）、将旧版 reCAPTCHA 管理控制台术语映射到Google Cloud 控制台，以及检索内容管理系统 (CMS) 平台和第三方插件（例如 WordPress 或 Shopify 集成）所需的网站密钥和密钥。
将旧版术语映射到 Google Cloud 控制台
如果您仅在 reCAPTCHA 管理控制台中管理密钥，则表示您使用的是 reCAPTCHA Classic。如果您在 Google Cloud 控制台的 Google Cloud Fraud Defense 页面上管理密钥，则表示您使用的是 Fraud Defense。两个控制台都支持 v2 和 v3 网站密钥。
许多 CMS 平台和插件都使用旧版版本号（例如 v2 Checkbox、v2 Invisible 和 v3）来引用 reCAPTCHA 密钥。Google Cloud 控制台使用基于平台的描述符，而不是版本号。
下表将旧版 CMS 和管理控制台术语映射到Google Cloud 控制台术语：
| CMS 或管理控制台术语 | Google Cloud 控制台（平台详情） | 修改密钥（类型字段） | 验证机制和 CMS 兼容性 |
|---|---|---|---|
| 基于得分 (v3) | Website • score |
Website • Score |
顺畅、基于得分的验证。用于需要 reCAPTCHA v3 的 CMS 插件。 |
| 基于验证方式 (v2) | Website • checkbox |
Website • Checkbox challenge |
要求用户勾选“我不是机器人”复选框。适用于需要 reCAPTCHA v2 复选框的 CMS 插件。 |
| 隐形 (v2) | Website • invisible |
Website • Invisible integration |
在后台分析风险，并可能会显示验证问题。用于需要 reCAPTCHA v2 Invisible 的 CMS 插件。 |
| 不适用 | Website • policy-based challenge |
Website • Policy-based challenge |
根据配置的得分阈值触发验证。需要自定义 CreateAssessment 集成。 |
| 不适用 | iOS |
iOS app |
iOS 移动密钥，无需验证。 |
| 不适用 | Android |
Android app |
无需验证的 Android 手机钥匙。 |
在 Google Cloud 控制台中查看密钥版本
如需在 Google Cloud 控制台中查看密钥的版本，请执行以下操作：
在 Google Cloud 控制台中，前往 Fraud Defense 页面。
选择密钥标签页。
如果您的密钥处于卡片视图中，请切换到表格视图。
查看密钥的平台详细信息列。例如，
Website • score对应于v3，Website • checkbox对应于v2 Checkbox。可选。在卡片视图中，点击密钥卡片上的密钥详情，然后选择修改密钥。类型字段显示密钥配置，例如
v3的Website • Score或v2 Checkbox的Website • Checkbox challenge。
查找网站密钥和密钥
第三方插件和 CMS 平台通常需要网站密钥和密钥才能进行 reCAPTCHA 集成：
- 网站密钥：在 Google Cloud 控制台中，密钥 ID 对应于网站密钥。
- 密钥： Google Cloud 控制台默认不显示密钥，因为 Google Cloud 身份验证通常使用 API 密钥或 Identity and Access Management 角色。不过，您可以检索需要旧版密钥的插件的旧版密钥。某些第三方库或文档可能会将旧版密钥称为私钥。
在 Google Cloud 控制台中检索密钥
如需检索网站密钥和密钥，请执行以下操作：
在 Google Cloud 控制台中，前往 Fraud Defense 页面。
选择密钥标签页。
在 reCAPTCHA 密钥部分中，找到您需要其密钥的密钥：
- 如果您在卡片视图中，请点击密钥卡片上的密钥详细信息。 密钥 ID 显示在页面顶部。
- 如果您处于表格视图中，则密钥 ID 会显示在表格中。点击相应密钥，前往其详情页面。
复制页面顶部显示的密钥 ID。此值是您的网站密钥。
前往集成标签页。
根据密钥的状态，执行以下操作之一：
- 如果密钥已配置为旧版用途，请点击使用旧密钥。
- 如果密钥未与旧版服务集成，请点击与第三方服务或插件集成。
系统会显示一个对话框，其中包含您的密钥。请妥善复制此值。请将此密钥视为敏感数据。
或者，在密钥详情页面上，点击修改密钥，然后点击密钥字段旁边的显示。
与 WordPress、Shopify 或其他 CMS 平台集成
如果您使用网站开发工具、电子商务平台或 CMS 插件，该平台或插件会自动加载 reCAPTCHA 脚本并验证用户令牌。您无需安装 reCAPTCHA 客户端库或编写自定义后端代码。
如需在 CMS 或第三方插件中配置 reCAPTCHA，请执行以下操作：
- 检查您的 CMS 或插件所需的 reCAPTCHA 版本：在 CMS 或插件中打开 reCAPTCHA 集成设置，然后检查其支持的密钥类型（通常为 reCAPTCHA v3 或 reCAPTCHA v2 复选框）。
选择或创建匹配键：
- 如果您已有密钥，请查看密钥版本，确认其与您在插件中选择的版本（
v3对应Website • score，v2 Checkbox对应Website • checkbox）一致。 - 如果您需要新密钥，请为您的网站创建与所需版本匹配的密钥，然后将您的网站域名（例如
example.com）添加到密钥的域名列表中。
- 如果您已有密钥，请查看密钥版本，确认其与您在插件中选择的版本（
复制您的网站密钥和旧版密钥：按照在Google Cloud 控制台中检索密钥中的步骤获取密钥 ID（网站密钥）和密钥。
在 CMS 或插件设置中输入密钥：
- 将密钥 ID 粘贴到网站密钥字段中。
- 将Secret粘贴到Secret key（或私钥）字段中，然后保存设置。
使用评估集成自定义网站
CreateAssessment 方法可提供详细的风险分析和原因代码，并支持使用 Fraud Defense 高级功能。您可以使用 reCAPTCHA 客户端库或 REST API 调用 CreateAssessment 方法。
如需了解详情，请参阅为您的网站创建评估。
旧版 SiteVerify 方法
虽然我们建议对新的和自定义集成使用 CreateAssessment 方法，但一些现有系统或第三方插件仍依赖于旧版 SiteVerify 方法。此方法需要与您的 reCAPTCHA 密钥关联的密钥。
如果您需要与需要旧版 SiteVerify API 的系统集成，请参阅使用旧版 SiteVerify 验证用户响应令牌。