架构学习通过观察实时 API 流量,自动发现端点接受的参数、标头和正文格式。对于保存到端点管理的所有端点,您可以按主机名以 OpenAPI v3.0.0 格式导出学到的架构。
要使用学到的架构保护您的 API,请参阅架构验证。
-
在 Cloudflare 仪表板中,前往 Web assets(Web 资产) 页面。
Go to Web assets ↗ -
前往 Endpoints(端点) 选项卡。
-
选择 Export schema(导出架构) 并选择要导出的主机名。
-
选择是否包含学到的参数和速率限制建议。
-
选择 Export schema(导出架构) 并选择保存文件的位置。
- 登录到 Cloudflare 仪表板 ↗,然后选择您的账户和域。
- 选择 Security(安全性) > API Shield > Endpoint management(端点管理)。
- 选择 Export schema(导出架构) 并选择要导出的主机名。
- 选择是否包含学到的参数和速率限制建议。
- 选择 Export schema(导出架构) 并选择保存文件的位置。
学到的架构将始终包含:
- 服务器 (servers) 部分中列出的主机名
- 按主机、方法和路径划分的所有端点
对于收到足够流量的端点,学到的架构还将包含:
- 检测到的路径变量和格式
- 检测到的查询参数和格式
- 检测到的
POST、PUT和PATCH响应主体变量名称以及application/json内容类型的格式 - 自动检测到的请求参数的格式
学到的架构可以可选地包含:
- API Shield 的速率限制阈值建议
在架构学习开始之前,端点必须至少添加 24 小时。架构学习是一个持续的过程,会检查端点最近 72 小时的流量。
架构学习仅从具有 2xx 响应代码的请求中学习。
架构学习在流量大时效果最好。对于过去 72 小时内请求数少于 10,000 的端点,您看到的学到的架构置信度可能会较低。