您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
您可以配置 Apigee Sense，以便在检测到可能不需要的 API 请求时向您发送通知。设置通知后，Apigee Sense 会每 5 分钟向您指定的 webhook URI 发送一份报告。
使用该 webhook URI，Apigee Sense 将发送 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 体验。
- 在新版 Edge 中，点击分析菜单，然后点击 Sense。
- 点击设置菜单。
在设置页面上，输入值以配置通知：
设置 说明 通知 点击即可启用或停用此通知。 URI 您希望 Apigee Sense 在发送通知时使用的 URI。这通常是接受传入 webhook 的监控系统。Apigee Sense 中的报告将发送到此 URI。 API 密钥名称 可选。Apigee Sense 在与您的系统进行身份验证时应使用的密钥名称。使用 API 密钥来提高安全性。 API 密钥值 可选。Apigee Sense 在与您的系统进行身份验证时应使用的键值。使用 API 密钥来提高安全性。 IP 地址数量上限 报表中可包含的客户端 IP 地址数量上限（介于 1 到 300 之间）。Apigee Sense 会按可疑请求数（从最多到最少）的顺序包含 IP 地址，最多包含您在此处指定的 IP 地址数量。