常见问题解答

了解您在使用 reCAPTCHA 时可能会遇到的常见问题。

实现

我可以在全球范围内使用 reCAPTCHA 吗?

可以。当您的用户无法访问 www.google.com 时,您可以在前端代码中使用 www.recaptcha.net

  • 首先,将 <script src="https://www.google.com/recaptcha/enterprise.js?render=<SITE_KEY>"></script> 替换为 <script src="https://www.recaptcha.net/recaptcha/enterprise.js?render=<SITE_KEY>"></script>,并用您的网站密钥替换 <SITE_KEY>
  • 然后,对网站上的所有 www.google.com/recaptcha/ 实例执行同样的操作。

reCAPTCHA 是否使用 Cookie?

reCAPTCHA 会在执行时设置必要的 Cookie (_GRECAPTCHA),以便进行风险分析。 如果您不想使用可能设置了其他 Cookie 的 www.google.com 网域,可以改用 www.recaptcha.net

我想隐藏 reCAPTCHA 徽章。允许哪些行为?

只要您使用 reCAPTCHA 保护网站,并在用户流中遵循“Google 的服务条款和隐私权政策”,就可以隐藏此徽章。请添加以下文字:

This site is protected by reCAPTCHA and the Google
<a href="https://policies.google.com/privacy">Privacy Policy</a> and
<a href="https://policies.google.com/terms">Terms of Service</a> apply.

例如:

隐私权和服务条款链接示例

我可以自定义 reCAPTCHA widget 或徽章吗?

是的。reCAPTCHA 提供浅色和深色主题。要选择主题背景,请在 grecaptcha.enterprise.render 参数中设置 data-theme 属性。

  • 浅色主题:
    采用浅色主题的 reCAPTCHA 微件或徽章

  • 深色主题:
    采用深色主题的 reCAPTCHA widget 或徽章

我可以在 Google Cloud Console 的“验证网域”列表中添加多少个网域?

每个密钥最多只能包含 250 个网域。

如需在超过 250 个网域上使用密钥,请参阅为网站创建密钥

我使用的第三方插件/实现不会正式支持 reCAPTCHA,而仅支持旧版 reCAPTCHA。我还可以使用 reCAPTCHA 吗?

是的,Google Cloud 控制台中提供了旧版 Secret Key。如需了解如何查找旧版密钥,请参阅查找旧版 reCAPTCHA 密钥

在调试网站时,如何避免单步进入 reCAPTCHA 代码?

为避免在调试您网站上的其他 JavaScript 时进入 reCAPTCHA 代码,请将 reCAPTCHA 脚本 /recaptcha__.+\.js$ 添加到浏览器的忽略列表中。如需了解适用于 Chrome 的说明,请参阅忽略自定义的脚本列表。其他浏览器中也提供类似的功能。

用法

我使用 reCAPTCHA 时是否有速率限制?

有,请参阅配额和限制

reCAPTCHA 信息中心使用哪个时区?我可否对此作出更改?

此时区根据浏览器的客户端时区确定。目前无法更改此设置。

如何衡量 reCAPTCHA 返回的得分的质量?

得分质量最终取决于您的使用场景和期望的结果。一般来说,我们建议您使用您自己的用户行为内部指标,以确定得分是否准确,例如:

  • 重置了密码并获得高分的用户稍后是否报告其账号被盗用?
  • 已登录但得分较低的用户会继续向其他人发送垃圾邮件吗?
  • 登录失败并获得低分的用户会继续尝试使用多个不同用户名登录吗?

我想使用 reCAPTCHA 运行自动化测试。该怎么做?

您可以使用 Google Cloud CLI 创建用于测试的 reCAPTCHA 网站密钥。如需了解详情,请参阅 recaptcha keys create reference 页面中的 --testing-challenge--testing-score 选项。

示例:

  • 创建始终返回“No CAPTCHA”(无质询)和 1.0 的复选框网站密钥(请在下面更改 --网域--显示名)。
gcloud recaptcha keys create --testing-challenge=nocaptcha --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always No CAPTCHA" --integration-type=checkbox
  • 创建始终返回不可解决的挑战的复选框网站密钥(请在下面更改 --网域--显示名)。
gcloud recaptcha keys create --testing-score=0.0 --testing-challenge=challenge --web --domains="domain1.com,domain2.com" --display-name="Unsolvable Challenge" --integration-type=checkbox
  • 创建始终返回设定得分的基于得分的网站密钥(请在下面更改 --网域--显示名--测试得分)。
gcloud recaptcha keys create --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always 1" --integration-type=score

我想与 reCAPTCHA REST API 通信。我可以假设响应格式将来不会改变吗?

随着产品的发展,我们可能会应用非重大更改,例如向 API 添加新字段。如果您使用 JSON,请确保您没有严格验证响应的格式,以保持与 API 将来的添加兼容性。

创建评估时,reCAPTCHA 返回了 BROWSER_ERROR。我该怎么做?

如果 reCAPTCHA 脚本无法执行 execute 操作,则会出现 BROWSER_ERROR 令牌。在大多数情况下,这是由于客户端网络故障或超时造成的。必须通过 JavaScript 重试 execute()

如果我想创建传统版 reCAPTCHA 密钥,有哪些选择?

reCAPTCHA 不再支持创建新的传统密钥。如果您已有传统版密钥,建议您从 reCAPTCHA 传统版迁移。所有 Google Cloud reCAPTCHA 客户每月都可以免费创建 10,000 次评估。如需详细了解使用情况和价格,请参阅 reCAPTCHA 价格

数据处理

reCAPTCHA 会收集哪些会话数据?Google 如何保护这些数据?

了解 reCAPTCHA 收集的数据 Google 为保护数据而采取的措施,请参阅 云端数据处理附录reCAPTCHA 服务专用条款

如需详细了解 Google 如何保护数据安全,请参阅安全白皮书

reCAPTCHA 是否符合 GDPR 规定?

是。Google Cloud 大力支持重视和提升客户个人数据安全性和隐私性的计划,同时希望 reCAPTCHA 客户根据 GDPR 要求放心使用我们的服务。我们在《云端数据处理附录》中承诺,对于所有 Google Cloud 服务(包括 reCAPTCHA)中的客户个人数据,我们都会按照 GDPR 的规定进行处理。

如需了解特定于 reCAPTCHA 的其他条款,请参阅 reCAPTCHA 服务特定条款

reCAPTCHA 会收集付款交易信息吗?

当您在付款交易页面上安装 reCAPTCHA 时,它会检查特定的交易信号,以帮助防范自动攻击。例如,在某些情况下,每秒有大量价格相同的购买尝试可能表示存在攻击。

不过,聊天机器人只是整体欺诈问题的一小部分。对于 集成了 reCAPTCHA Fraud Prevention, 这样您可以发送更全面的交易信息 针对欺诈行为(例如银行卡测试和付款方式被盗使用)的评估。