审计用途
审计的价值在于事后可核对。请求成功时,记录用来说明调用路径和结果;请求被拒绝时,记录用来说明拒绝发生在哪一步、原因是什么。两类记录合在一起,才能还原一次调用的完整经过。
记录以请求编号串联。调用方、网关节点、信源和结果通过同一编号关联,排查时不必在多个系统之间反复比对。
审计记录服务于核对与排查,不用于评价信源内容。记录范围以网关处理环节为限,信源内部的处理过程不在其中。
记录以够用为原则,字段过多会增加保管成本,也会带来不必要的风险。
审计事件
事件按类型记录,覆盖访问、拒绝、切换、配置和凭据变化。
事件类型保持稳定,新增事件需要同步说明,避免调用方对记录内容产生误解。
拒绝与切换记录尤其重要,前者说明权限或格式问题,后者说明信源状态变化。
| 事件 | 记录内容 | 用途 |
|---|---|---|
| 访问 | 调用方、信源、时间、结果 | 核对请求 |
| 拒绝 | 错误类型、原因、请求编号 | 排查权限和格式问题 |
| 切换 | 原信源、备选信源、原因 | 核对调度 |
| 配置变更 | 变更人、变更内容、时间 | 核对配置 |
| 凭据变更 | 凭据类型、操作、时间 | 核对安全事件 |
审计记录字段
字段围绕定位问题设置,够用即可,不收集业务内容。
字段设计以定位问题为限,不记录业务正文,也不记录与调用无关的个人信息。需要更多业务信息时,由调用方与信源按约定处理。
- 请求编号和调用方标识。
- 路由键和信源标识。
- 请求时间、响应时间和结果。
- 错误码和错误说明。
- 网关节点和协议版本。
保存与查询
审计记录按接入约定保存,到期后按规则处理。查询按时间范围、调用方、信源或请求编号进行,不提供业务正文查询。
查询结果用于核对调用和排查故障。需要长期留存的记录,按接入约定交付,交付范围同样不包含业务正文。
保存期限按接入约定执行,到期处理方式在接入时确认。查询权限按角色划分,调用方在授权范围内查看记录。
访问与导出
审计记录访问需要授权,导出行为本身也写入审计记录。涉及安全事件的排查,可先暂停相关凭据,再按时间范围和请求编号提取记录。
审计记录不保存业务正文,因此不提供正文检索。需要核对业务内容的场景,由调用方与信源按双方约定处理。
导出记录需要说明用途和范围,导出结果按约定保管。安全事件排查期间,可暂停相关凭据,避免影响继续扩大。