您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
您可以配置 Apigee Sense，使其通过检测到的可能不需要的 API 请求列表通知您。设置通知后，Apigee Sense 会每 5 分钟向您指定的 webhook URI 发送一次报告。
Apigee Sense 将使用 webhook URI 发送 JSON 格式的字符串（您需要使用代码将该字符串解析为 JSON）。以下简短的报告示例已从字符串格式转换为 JSON 格式，以便于阅读：
{
"text": {
"metadata": {
"org": "my-org",
"env": "prod",
"reportTimestamp": "2018-10-09T17:25:12Z",
"messageId": "1539105912220"
},
"totalNumberOfBots": 1,
"bots": [
{
"ipAddress": "11.111.111.11",
"botDetectedLast": "2018-10-0917:04:48Z",
"ipIsp": "Their ISP",
"ipCountry": "United States",
"botReason": [
"Flooder",
"Content Robber"
],
"callCount": "274529",
"topUrl": "/v1/my/url",
"ipCity": "Los Angeles"
}
]
}
}
该报告会捕获有关可能针对您的 API 发起的不必要攻击的以下信息：
- 收集报告的请求的 Apigee 组织和环境。
- 报告的时间戳。
- 报告消息的 ID。
- 发出可能不受欢迎的请求的 IP 地址数量。
发出潜在的不必要请求（例如机器人）的 IP 地址的客户端数据数组。对于每个客户，报告包含以下信息：
客户特征 说明 ipAddress 客户端的 IP 地址。 botDetectedLast 客户端最近一次请求的时间戳。 ipIsp 发出请求的客户的 ISP。 ipCountry 客户端请求的来源国家/地区。 botReason 此 IP 地址发出的请求所符合的 Apigee Sense 检测规则。 callCount 来自相应 IP 地址的请求数。 topUrl 客户端 IP 请求的最常见网址。这是客户端请求的 API。 ipCity 收到请求的城市。
如需设置通知，请执行以下操作
- 打开新版 Edge 体验。
- 在 New Edge 体验中，点击分析菜单，然后点击感知。
- 点击设置菜单。
在设置页面上，输入值以配置通知：
设置 说明 通知 点击可启用或停用此通知。 URI 您希望 Apigee Sense 在发送通知时使用的 URI。这通常是一个接受传入 Webhook 的监控系统。来自 Apigee Sense 的报告将发送到此 URI。 API 密钥名称 可选。Apigee Sense 在向您的系统进行身份验证时应使用的密钥名称。使用 API 密钥来提高安全性。 API 密钥值 可选。Apigee Sense 在向您的系统进行身份验证时应使用的键值。使用 API 密钥来提高安全性。 IP 数量上限 报告中可包含的客户端 IP 地址数量上限（介于 1 到 300 之间）。Apigee Sense 将按可疑请求的数量（从最多到最少）列出 IP 地址，最多列出您在此处指定的 IP 数量。