端点管理使用 Web 资产仪表板。前往 Web Assets(Web 资产) > Operations(操作) 来管理 API 端点。
操作是 Cloudflare 对按 HTTP 方法、主机名模式和路径模式标识的端点的术语。Web 资产会持续发现操作,您也可以手动添加。
Cloudflare 发现的操作仅会添加到清单中。要开始分析配置文件,请为目标操作选择 Learn profile(学习配置文件)。
-
在 Cloudflare 仪表板中,前往 Web Assets(Web 资产) 页面。
前往 Web assets(Web 资产) ↗ -
前往 Operations(操作) 选项卡。
Web 资产会持续将发现的操作添加到清单中。发现不会开始配置文件学习。
候选操作可为匹配、边缘安全检测和顺序分析提供上下文。您无需更改每个已发现的操作。
- 从 Web Assets(Web 资产) > Operations(操作),选择 Add operation(添加操作)。
- 选择 Upload schema(上传架构)。
- 上传架构文件。
- 选择 Add schema and endpoints(添加架构和端点)。
API Shield 会查找具有相同主机名、方法和路径的重复操作。重复的操作不会被添加。
- 从 Web Assets(Web 资产) > Operations(操作),选择 Add operation(添加操作)。
- 选择 Manually add(手动添加)。
- 选择方法并输入主机名模式和路径模式。
- 选择 Add operation(添加操作)。
手动添加操作时,您可以在路径或主机名中指定变量字段。将变量用花括号括起来,例如 /api/user/{var1}/details 或 {hostVar1}.example.com。
Cloudflare 支持以下格式的主机名变量:
{hostVar1}.example.com
foo.{hostVar1}.example.com
{hostVar2}.{hostVar1}.example.com主机名变量必须包含整个域字段,并且不得与该字段中的其他文本一起使用。
不支持以下格式:
foo-{hostVar1}.example.com有关 Cloudflare 如何在 API Shield 中使用变量的更多信息,请参阅 API 发现中的示例。
您可以编辑操作的标识。
- 从 Web Assets(Web 资产) > Operations(操作),打开该操作的行操作。
- 选择 Edit operation(编辑操作)。
- 更新 HTTP 方法、主机名模式或路径模式。
- 选择 Save(保存)。
仅在审查操作标识之后再开始分析配置文件。
- 从 Web Assets(Web 资产) > Operations(操作),打开操作的更多选项菜单。
- 选择 Learn profile(学习配置文件)。
- 配置文件可用后,再次打开更多选项菜单。
- 选择 View details(查看详情) 并审查 Security overview(安全概述)。
学习要求、分析和强制执行请参阅应用程序配置文件。
要在不等待每周计划的情况下请求一次覆盖整个 zone 的学习运行,请参阅手动运行架构学习。
您可以逐个或批量删除端点。
- 从 Web Assets(Web 资产) > Operations(操作),选择要删除的操作。
- 选择 Delete operations(删除操作)。
对于每个处于 full 状态的操作,您可以查看:
- Request count(请求计数):操作随时间收到的请求总数。
- Rate limiting recommendation(速率限制建议):每 10 分钟。这以请求计数为指导。
- Latency(延迟):以毫秒 (ms) 为单位的平均源站响应时间。此指标显示从访问者发出请求到访问者收到来自源站的响应所花费的平均时间。
- Error rate(错误率) 与总体流量对比:按 4xx、5xx 以及它们的总和分组。
- Response size(响应大小):返回给请求的平均响应大小(以字节为单位)。
- Labels(标签):分配给该操作的当前标签。
- 身份验证状态:在发往此操作的成功请求中观察到的会话标识符。
- Sequences(顺序):包含该操作的顺序分析顺序数量。
您可以通过 Cloudflare API 管理已保存的操作。有关更多信息,请参阅 操作 API 文档。
敏感数据包含各种个人身份信息和财务数据。Cloudflare 创建了此规则集以应对常见的数据泄露威胁,并且 WAF 可以在来自您源站的 HTTP 响应正文中搜索这些数据。
API Shield 会在处于 full 状态的操作的响应中向您发出敏感数据警报。您的 zone 还必须拥有敏感数据检测托管规则集。
在我们的 Advanced 应用安全计划中,敏感数据检测可供企业版客户使用。
启用敏感数据检测后,API Shield 会将 cf-risk-sensitive 标签应用于过去一周内响应匹配敏感数据检测规则集的操作。
打开操作详情以审查检测到的敏感数据类型。选择 Explore Events(探索事件) 以在安全事件中查看匹配的事件。
在为您的 zone 启用敏感数据检测后,您可以浏览敏感数据检测规则集 ↗。如果未启用敏感数据检测,该链接将不起作用。
当请求由 Cloudflare 服务以阻止其直接传递给您的源服务器的方式处理时,不支持某些性能指标(例如延迟)。
具体在以下情况下会观察到此限制:
- Cloudflare Worker 正在 URL 路径上运行。
- 在应用程序上激活了基于 Workers 构建的其他产品,例如 Waiting Room。
在这些情况下,系统无法准确测量源站响应时间,并且该指标不会在仪表板中填充。