跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Clearance(通过证明)

最后更新 查看 MarkdownAgent 设置

cf_clearance cookie 向 Cloudflare 证明访客是经过验证的真人,并已通过 Cloudflare 的客户端验证。

该 cookie 包含两种相互配合的 clearance(通过证明):

  • 质询许可:访客解决质询时授予(例如 Interstitial Challenge Page,或启用了预许可的 Turnstile)。
  • Precursor 许可:根据 session 行为持续更新。

该 cookie 安全地与发行它的特定访客和设备绑定,防止跨机器重复使用。

作为额外的安全层,使用 Advanced Rate Limiting 的客户可以使用 Clearance UUID(http.request.clearance.uuid)特征添加速率限制规则。当 Cloudflare 刷新加密的 cf_clearance cookie 值时,包括由 JavaScript Detections 或 Precursor 触发的更新,此稳定标识符可让规则继续使用同一个计数器。

使用计数表达式 http.request.clearance.uuid ne "",避免没有有效许可 cookie 的请求共享空值计数器。如果这些请求也需要速率限制,请使用适当的特征(例如源 IP 地址)创建单独的规则。

质询通过证明

质询通过证明在访客成功完成质询时授予。

每种质询类型都会设置一个证明级别。较高等级的证明会绕过所有该级别或更低级别的质询。较低等级的证明仅绕过相同级别的质询。

许可级别 绕过的质询
交互式(高) 交互式、托管式和非交互式质询(Interactive、Managed 和 Non-Interactive Challenges)
托管式(中) 托管式和非交互式质询(Managed 和 Non-Interactive Challenges)
非交互式(低) 仅非交互式质询(Non-Interactive Challenges only)

如果访客通过了交互式质询(最高安全级别),只要该证明仍然有效,他们就可以绕过所有其他质询。

如果访客获得了较低级别的证明(托管式或非交互式),并在稍后遇到较高级别的质询,他们必须再次解决该较高级别的质询。

如果稍后解决较高级别的质询,最初的证明将被替换。

质询通过证明在客户配置的持续时间(质询通过期)内保持有效,除非处于 Armed 模式的 Precursor 确定该会话存在可疑情况。

Precursor 通过证明

在 Armed 模式下,Precursor 会在整个访客会话期间持续重新评估 clearance。它使用持续行为,而不是单个质询事件。随着 Precursor 观察到新的信号,它会更新 clearance,以反映当前对会话的信任水平。在 Monitor 模式下,Precursor 不会更改质询 clearance。

如果 Precursor 确定某会话存在可疑情况:

  • 访客有效的质询通过证明可能被降级或无效化。
  • 访客可能被重新质询,即使 cookie 尚未过期。

这会创建一种许可同时受时间约束(Interstitial) 和行为约束(Precursor) 的模型。

Turnstile 中的预先证明支持

Turnstile 中的预许可通过使用 cf_clearance cookie 简化网站的用户体验。根据客户设置的安全许可级别,cf_clearance cookie 允许访客绕过该 zone 上所有后续请求(包括 API 请求)的 WAF 质询。这对受信任的访客尤其有用,可以在保持安全性的同时提高易用性。

默认情况下,当访客通过小组件解决质询时,Turnstile 会向他们发放一次性使用令牌。您必须通过对 Siteverify API 发起服务器端调用来验证该令牌。

质询类型 发放的证明
质询页面 cf_clearance cookie(默认)
Turnstile widget token(默认)
cf_clearance cookie(可选附加项)

当您在 Turnstile 上启用预先证明支持时,除了默认的 Turnstile 令牌外,还会向访客发放一个 cf_clearance cookie。

您可以允许 Turnstile 向您的访客发放 cf_clearance cookie 作为预先证明,从而集成 Cloudflare Challenges。使用 Turnstile API 的 clearance_level 在创建小组件或修改小组件时设置预先证明级别。该配置的可能值为:

  • interactive
  • managed
  • jschallenge
  • no_clearance

所有小组件默认将预先证明模式设为 false,安全证明级别设为 no_clearance。

对于符合启用无任何预配置主机名的小组件条件的企业客户,Cloudflare 建议在指定了至少一个主机名且该主机名与您想集成 Turnstile 的区域相同的小组件上发放预先证明 cookie。

请参考博客文章 ↗了解关于预先证明如何与 WAF 配合工作的更多详细信息。

预先证明级别选项

Interactive(交互式,高) interactive

允许具有通过证明 cookie 的用户不受到非交互式质询、托管质询或交互式质询防火墙规则的质询。

Managed(托管式,中) managed

允许具有通过证明 cookie 的用户不受到非交互式质询或托管质询防火墙规则的质询。

Non-Interactive(非交互式,低) jschallenge

允许具有通过证明 cookie 的用户不受到非交互式质询防火墙规则的质询。

Turnstile widget 生成的许可 cookie 在 zone 级 Challenge Passage 值指定的时间内有效。要配置 Challenge Passage 设置,请参阅 Challenge Passage。

设置

要启用预先证明,您必须确保 Turnstile 小组件的主机名与具有 WAF 规则的区域匹配。在 Cloudflare 仪表板中进行 Turnstile 配置设置期间,您可以访问已注册的区域列表。从此列表中选择适当的主机名。

此先决条件对于预先证明正常运作至关重要。如果设置正确,成功解决 Turnstile 的访客将获得具有客户设定安全证明级别的 cookie。当在同一区域遇到 WAF 质询时,他们将绕过对配置的证明级别及更低级别的其他质询。

有关管理主机名的更多细节,请参考主机名管理文档。

在新网站上启用预先证明

  1. 在 Cloudflare 仪表板中,转到 Turnstile。

    前往 Turnstile ↗
  2. 选择 Add widget(添加小组件)。

  3. 在 Would you like to opt for pre-clearance for this site?(是否为此站点选择预先证明?) 下,选择 Yes(是)。

  4. 选择一个 pre-clearance level(预先证明级别)。

  5. 选择 Create(创建)。

在现有网站上启用预先证明

  1. 在 Cloudflare 仪表板中,转到 Turnstile。

    前往 Turnstile ↗
  2. 选择一个现有的小组件,然后打开 Settings(设置)。

  3. 在 Would you like to opt for pre-clearance for this site?(是否为此站点选择预先证明?) 下,选择 Yes(是)。

  4. 选择一个 pre-clearance level(预先证明级别)。

  5. 选择 Update(更新)。

这篇文档对您有帮助吗?