您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息
您可以查看或自定义 Apigee Sense 检测规则,以确保仅捕获可能不需要的请求。Apigee Sense 检测规则定义了表示可能不需要的客户端请求的模式。
如需详细了解如何查看检测规则的结果,请参阅 Apigee Sense 控制台使用入门。
调整示例
例如,您可能在检测报告中注意到,一些不需要的请求符合暴力猜测模式,该模式在 24 小时内报告的响应错误所占比例较大。但您也注意到,该模式会捕获您希望通过 API 代理允许的请求。
通过自定义 Brute Guessor 模式(下表),您可以对其进行调整,以便更好地允许所需的请求,并捕获不需要的请求。Brate Guessor 模式定义了下表中显示的条件和值。如果一组请求在 24 小时内满足上述条件,则 Apigee Sense 会报告这些请求符合布鲁特玩家模式。
条件 | 值 |
---|---|
来自 IP 的调用次数下限 | 100 |
错误率下限阈值 | 90 |
在某些情况下,您的设计允许 24 小时内 90% 以上的错误。在这种情况下,根据规则的保护设置,真实来源可能会被屏蔽。您可以使用此功能更改条件值。在上面的示例中,您可以先将条件值更改为以下内容:
条件 | 值 |
---|---|
来自 IP 的调用次数下限 | 100 |
错误率下限阈值 | 95 |
您所做的具体自定义更改将因请求数据有关有效客户端如何使用 API 的说明而异。但您可能会发现此过程是迭代的,即您在进行增量更改,直到获得有用的规则定义。
以迭代方式调整检测
对于那些需要调整的检测规则,您可能会发现最好采用增量和迭代方法。根据 Apigee Sense 的检测和分析周期的运作方式,每次迭代可能需要一天左右的时间。在这个周期内,Apigee Sense 会存储有关客户端请求的元数据,批量分析这些数据,然后将结果呈现给您在 Apigee Sense 控制台中查看。
例如,您可以使用以下过程:
- 使用 Apigee Sense 控制台的检测报告来确定可以使用调整的检测规则,例如检测太多实际有用的请求的规则。
- 确定需要调整规则的哪些条件,以便提高规则捕获的不必要的请求百分比。
- 在 Apigee Sense 控制台中,修改规则,对您已确定的条件值进行小幅增量更改。
- 一小时后,使用检测报告评估您的更改是否产生了预期效果。
- 根据需要进行迭代,直到获得有用的结果。
指南和最佳实践
在自定义检测规则时,请注意以下事项。
- 规则的条件之间会以逻辑 AND 关系 (AND) 合并。换句话说,如果有三个条件,则必须满足这三个条件,才能使请求符合规则的格式。
- 一些规则条件定义了最低阈值,而其他规则条件则定义了最高阈值。
- 调整规则,以便在以下两者之间取得平衡:捕获足够多的请求以识别不必要的流量,但又不要捕获太多能捕获到有用的流量。最佳实践是减少捕获的请求数量,以避免捕获到有用的流量。
- 如果对使用情况的值进行极小的更改,则可能不会产生明显的影响。请自行决定要做出的更改有多么出色。
如需详细了解模式、条件和时间范围,请参阅针对可疑活动。
自定义检测规则
确定可以使用调整的检测规则后,请按照以下步骤查看或自定义检测规则,甚至在您认为没有用处时停用规则。您还可以查看上次修改规则的人。
- 打开新版 Edge。
- 在 New Edge 中,点击 Analyze 菜单,然后点击 Sense。
- 在导航栏中,依次点击检测 > 规则。
- 在检测规则页面上,找到您要查看或自定义的规则。
- 将鼠标悬停在列表中相应规则所在的行上,然后点击该行最右端的按钮。
下面显示了可供管理员使用的修改按钮。请注意,您也可以停用规则,导致 Apigee Sense 停止使用该模式评估向 API 发送的请求。
- 在规则的对话框中,查看或调整条件值。
- 点击 Save(保存)。
- 一小时后,在检测报告中查看分析结果,评估您的更改是否获得了预期结果。