从合格操作流量中学习预期的请求字段和约束。
-
在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) > Operations(操作)。
前往 Web assets(Web 资产) ↗ -
打开操作的更多选项菜单,选择 Learn profile(学习配置文件)。
-
配置文件可用后,选择 View details(查看详情)。
-
按照审查学习结果中的步骤操作。
学到的配置文件可用后,Cloudflare 会运行始终开启的检测。该检测本身不会缓解请求。
要调查结果,请参阅分析配置文件检测。要缓解违规,请参阅使用自定义规则强制执行配置文件。
学习每周运行,使用过去七天的合格流量。只有收到 2xx 响应的请求会参与计算。
字段学习阈值需要 1,000 个合格请求。边界学习阈值需要 10,000 个合格请求。
使用计划学习时,第一个配置文件会在下一次每周运行后出现。这可能需要在满足相关阈值后最多七天。您也可以手动请求一次学习运行。
支持的请求组件、约束和限制请参阅 Schema Profile。
无需等待每周计划即可请求一次临时学习运行。例如,在测试期间发送代表性流量后请求运行。
该运行覆盖整个 zone,而不是单个操作。它使用观察到的流量,不会生成请求。操作必须已选择进行配置文件学习,并满足学习要求。
-
在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) > Operations(操作)。
前往 Web assets(Web 资产) ↗ -
打开操作表的 More options(更多选项) 菜单。
-
选择 Ad-hoc learn schema(临时学习架构) 以打开 Schema learning(架构学习) 对话框。
-
选择 Run learning(运行学习) 以请求一次覆盖整个 zone 的运行。
对话框会显示该 zone 的学习状态和 Last completed run(上次完成的运行)。Running(运行中) 包括等待处理的时间。Idle(空闲) 表示没有活动运行。Waiting to retry(等待重试) 表示 Cloudflare 正在等待重试现有运行。
运行进行中或等待重试时,运行按钮不可用。如果按钮显示 Retry in(稍后重试),请等待后再请求另一次运行。倒计时用于限制手动请求,并不预测学习何时完成。
如果您只有只读访问权限,菜单会显示 Schema learning(架构学习)。您可以查看状态,但不能请求运行。
完成时间取决于流量规模。单个操作可能在整个 zone 范围运行完成之前就已结束。
- 从操作的更多选项菜单中选择 View details(查看详情)。
- 在 Security overview(安全概述) > Schema validation(架构验证) 中,选择 View(查看)。
- 选择 Learned schema(学到的架构)。
- 审查 Schema learning result(架构学习结果) 和 Last learning run(上次学习运行),以检查该操作是否已处理。
结果会显示以下结果之一:
| 结果 | 含义 |
|---|---|
| Schema learned(已学习架构) | Cloudflare 已为该操作学习到架构。 |
| No usable traffic(没有可用流量) | 该运行未找到该操作的可用流量。 |
| Learning failed(学习失败) | 该操作的学习尝试失败。 |
No learning result recorded(尚未记录学习结果) 表示尚无可用结果。在强制执行其检测之前,请先审查学到的架构。
导出可用性取决于您的套餐。每次导出都会根据当前学到的配置文件创建一份时间点 OpenAPI 文件。它不会更改配置文件或其检测。
-
在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) 页面。
前往 Web assets(Web 资产) ↗ -
前往 Operations(操作) 选项卡。
-
选择 Export schema(导出架构) 并选择要导出的主机名。
-
选择是否包含学到的参数和速率限制建议。
-
选择 Export schema(导出架构) 并选择保存文件的位置。
导出的架构会在 servers 部分中包含所列主机名。它们还会按主机名、方法和路径包含操作。
对于收到足够流量的操作,导出的架构还将包含:
- 检测到的路径变量和格式
- 检测到的查询参数和格式
- 检测到的
POST、PUT和PATCH响应主体变量名称以及application/json内容类型的格式
导出的架构可以可选地包含 API Shield 的速率限制建议。
对于固定的 Schema Profile,请通过架构验证上传导出的文件。