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

学习请求架构

最后更新 查看 MarkdownAgent 设置

从合格操作流量中学习预期的请求字段和约束。

开始配置文件学习

  1. 在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) > Operations(操作)。

    前往 Web assets(Web 资产) ↗
  2. 打开操作的更多选项菜单,选择 Learn profile(学习配置文件)。

  3. 配置文件可用后,选择 View details(查看详情)。

  4. 按照审查学习结果中的步骤操作。

学到的配置文件可用后,Cloudflare 会运行始终开启的检测。该检测本身不会缓解请求。

要调查结果,请参阅分析配置文件检测。要缓解违规,请参阅使用自定义规则强制执行配置文件。

满足学习要求

学习每周运行,使用过去七天的合格流量。只有收到 2xx 响应的请求会参与计算。

字段学习阈值需要 1,000 个合格请求。边界学习阈值需要 10,000 个合格请求。

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

支持的请求组件、约束和限制请参阅 Schema Profile。

手动运行架构学习

无需等待每周计划即可请求一次临时学习运行。例如,在测试期间发送代表性流量后请求运行。

该运行覆盖整个 zone,而不是单个操作。它使用观察到的流量,不会生成请求。操作必须已选择进行配置文件学习,并满足学习要求。

  1. 在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) > Operations(操作)。

    前往 Web assets(Web 资产) ↗
  2. 打开操作表的 More options(更多选项) 菜单。

  3. 选择 Ad-hoc learn schema(临时学习架构) 以打开 Schema learning(架构学习) 对话框。

  4. 选择 Run learning(运行学习) 以请求一次覆盖整个 zone 的运行。

对话框会显示该 zone 的学习状态和 Last completed run(上次完成的运行)。Running(运行中) 包括等待处理的时间。Idle(空闲) 表示没有活动运行。Waiting to retry(等待重试) 表示 Cloudflare 正在等待重试现有运行。

运行进行中或等待重试时,运行按钮不可用。如果按钮显示 Retry in(稍后重试),请等待后再请求另一次运行。倒计时用于限制手动请求,并不预测学习何时完成。

如果您只有只读访问权限,菜单会显示 Schema learning(架构学习)。您可以查看状态,但不能请求运行。

审查学习结果

完成时间取决于流量规模。单个操作可能在整个 zone 范围运行完成之前就已结束。

  1. 从操作的更多选项菜单中选择 View details(查看详情)。
  2. 在 Security overview(安全概述) > Schema validation(架构验证) 中,选择 View(查看)。
  3. 选择 Learned schema(学到的架构)。
  4. 审查 Schema learning result(架构学习结果) 和 Last learning run(上次学习运行),以检查该操作是否已处理。

结果会显示以下结果之一:

结果 含义
Schema learned(已学习架构) Cloudflare 已为该操作学习到架构。
No usable traffic(没有可用流量) 该运行未找到该操作的可用流量。
Learning failed(学习失败) 该操作的学习尝试失败。

No learning result recorded(尚未记录学习结果) 表示尚无可用结果。在强制执行其检测之前,请先审查学到的架构。

导出架构

导出可用性取决于您的套餐。每次导出都会根据当前学到的配置文件创建一份时间点 OpenAPI 文件。它不会更改配置文件或其检测。

  1. 在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) 页面。

    前往 Web assets(Web 资产) ↗
  2. 前往 Operations(操作) 选项卡。

  3. 选择 Export schema(导出架构) 并选择要导出的主机名。

  4. 选择是否包含学到的参数和速率限制建议。

  5. 选择 Export schema(导出架构) 并选择保存文件的位置。

学到的架构内容

导出的架构会在 servers 部分中包含所列主机名。它们还会按主机名、方法和路径包含操作。

对于收到足够流量的操作,导出的架构还将包含:

  • 检测到的路径变量和格式
  • 检测到的查询参数和格式
  • 检测到的 POST、PUT 和 PATCH 响应主体变量名称以及 application/json 内容类型的格式

导出的架构可以可选地包含 API Shield 的速率限制建议。

对于固定的 Schema Profile,请通过架构验证上传导出的文件。

这篇文档对您有帮助吗?