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

快速入门

最后更新 查看 MarkdownAgent 设置

为一个 operation 创建学习得到的 Schema Profile。然后在配置缓解之前查看其检测结果。

查看学习要求

Cloudflare 每周根据过去七天内的合格流量学习配置文件。只有收到 2xx 响应的请求才算合格。

一个 operation 需要 1,000 个合格请求才能达到字段学习阈值,需要 10,000 个合格请求才能达到边界学习阈值。

达到字段学习阈值后,Cloudflare 可以学习请求字段。达到边界学习阈值后,Cloudflare 可以学习数值范围、字符串长度等约束。

使用计划学习时,第一个配置文件会在下一次每周运行后出现。这可能需要在达到相关阈值后最多七天。您也可以为整个 zone 请求一次临时 schema 学习运行。

学习并查看配置文件

  1. 在 Cloudflare 仪表板中,前往 Web Assets > Operations。

    前往 Web assets(Web 资产) ↗
  2. 选择一个已发现的 operation,或 手动添加。operation 使用 HTTP 方法、主机名模式和路径模式。

  3. 从该 operation 的溢出菜单中选择 Learn profile(学习配置文件)。发现和手动创建不会开始分析。

  4. 等待 Cloudflare 收集足够的合格流量。

  5. 从该 operation 的溢出菜单中选择 View details(查看详情)。在 Security overview(安全概览) 下查看学习到的 schema。

  6. 在 Security(安全) > Analytics(分析) 中打开 Profile Analysis(配置文件分析)。查看配置文件符合情况与违规的请求时间序列。

    前往 Analytics(分析) ↗
  7. 下钻到采样日志,查看违规原因。

  8. 在查看有代表性的生产流量后,创建 Custom Rule。

  9. 将规则限定到目标主机名、路径或 operation,然后选择缓解动作。

配置文件可用后,Cloudflare 会运行始终开启的检测。没有 Custom Rule 时,它不会缓解请求。

如果没有出现学习到的 schema,请确认您已选择 Learn profile(学习配置文件)。Cloudflare 可能仍在收集足够的合格流量。

有关学习详情和限制,请参阅 Schema Profiles。

使用上传的 schema

如果您已有 OpenAPI schema,可通过 Schema validation 上传。上传的 schema 会通过 cf.schema_validation.uploaded.violated 产生检测。

API Shield 参考文档涵盖上传格式、OpenAPI 要求、API 配置、Terraform 配置和限制。

这篇文档对您有帮助吗?