Cloudflare 不当滥用检测会随着流量模式变化,为各个操作生成自适应的、每个会话的速率限制建议。
Cloudflare 根据用户对单个端点的流量情况来查找端点滥用。
例如,您的 API 在 /reset-password 端点上看到的流量水平可能会与 /login 端点不同。此外,在成功的营销活动后,您的 /login 端点可能会看到高于平均水平的流量。
这两种情况说明了传统速率限制的局限性。不仅不同端点之间的流量有所不同,而且同一端点的流量也可能随时间发生变化。不当滥用检测利用无监督学习(在没有预定义规则的情况下分析流量模式)来为每个端点开发单独的基线,并随着时间的推移适应用户行为的变化,从而解决这些问题。
不当滥用检测的速率限制是基于每个会话而不是每个 IP 地址生成的。当您的 API 流量增加时,这减少了误报,因为速率限制跟踪的是单个会话而不是共享的 IP 地址。
不当滥用检测速率限制是防止公然的不当滥用同时最小化误报的一种方法。如果您试图完全防止滥用的机器人流量,请参阅 Cloudflare 的机器人解决方案。
不当滥用检测会将会话的请求归组为 10 分钟时段。它使用这些请求量的分布,为每个符合条件的操作推荐一个每个会话的阈值。
要访问操作列表,请前往 Security(安全性) > Web Assets(Web 资产) > Operations(操作)。
如果您的流量模式发生变化,建议将继续更新。
不当滥用检测需要在七天分析窗口内有足够的合格流量,才能生成可靠建议。如果某个操作没有建议,可能是合格流量不足。
必须配置 会话标识符(例如作为请求标头或 cookie 提供的授权令牌),以便 Cloudflare 执行每个会话的分析。
添加或更改会话标识符后,请至少等待 24 小时以使建议显示。如果 Cloudflare 无法收集足够的合格流量或无法计算阈值,建议可能需要更长时间或仍然不可用。
在操作列表中选择一个操作行以查看其速率限制建议。详细视图会将建议阈值显示为整体建议、基于百分位数的值(p50、p90、p99),以及仪表板计算的置信度分类。
Cloudflare 会根据过去七天的请求计算每条建议。如果您的流量概况保持一致,建议可能不会发生变化。
Cloudflare 建议使用整体速率限制建议,而不是单个百分位数数值。整体建议考虑了您所有 API 会话的变化。选择单个百分位数数值可能会由于大量的异常值而导致误报。
在操作列表中,您可以审查每个建议的仪表板置信度分类。
实施低置信度速率限制仍然有助于防止 API 滥用。如果置信度较低,请先在 log 模式下启动速率限制规则,并观察违规情况以查找误报,然后再切换到 block。
有关如何创建高级速率限制规则的更多信息,请参阅规则文档。
如果您想随着时间的推移动态更新速率限制,速率限制建议可以通过 API 获取。
Required API token permissions
At least one of the following token permissions is required:Account API GatewayAccount API Gateway ReadDomain API GatewayDomain API Gateway Read
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/api_gateway/operations/$OPERATION_ID" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"Rate Limiting 可以将有效 JSON Web Token(JWT)中的字符串声明用作速率限制特征。这包括 sub 等注册声明和自定义声明。
对于嵌套声明,向 lookup_json_string() 分别传入每个对象键。例如,使用 "user", "email" 访问 user.email。
只有有效的 JWT 才会填充 JWT 声明字段。如果规则也匹配不包含所选声明的请求,这些请求会使用单独的缺失值计数器。请参阅缺失字段与空值。
对于按用户限制,选择能唯一标识用户的声明,例如在应用中具有唯一性的 sub。特征值相同的请求共享速率限制计数器。
要按级别应用不同的用户限额,请为每个级别创建一个速率限制规则。在规则表达式中匹配级别声明,并使用单独的用户标识声明作为速率限制特征。
例如,免费级别的规则可以使用:
lookup_json_string(http.request.jwt.claims["<JWT_TOKEN_CONFIGURATION_ID>"][0], "tier") eq "free"使用 sub 作为速率限制特征,将限额设置为每分钟五个请求。创建另一个规则,匹配 "tier" eq "premium" 并应用对应的高级级别限额。
仅配置会话标识符并不能保证会生成建议。Cloudflare 还必须有足够的合格流量并成功计算出阈值。要启用基于会话的速率限制,请订阅高级速率限制。
不当滥用检测仅适用于企业版客户。如果您是对该产品感兴趣的企业版客户,请联系您的账户团队。