审计与记录指南

审计记录回答谁在什么时间访问了哪个信源、结果如何。指南说明记录范围与边界、事件与字段的对应、请求编号的串联方式,以及查询、导出、安全事件排查和记录交付的操作次序。

记录范围与边界

审计记录覆盖网关处理环节,包括接入校验、鉴权判断、路径选择和转发结果。网关不保存业务正文,也不记录与调用无关的个人信息。记录范围以定位问题为限,字段过多会增加保管成本,也会带来不必要的风险。

信源内部的业务处理不在网关记录范围内。需要核对业务内容时,由调用方与信源按双方约定处理。审计记录用于核对调用和排查故障,不用于评价信源内容,也不代替信源自身的业务日志。

记录范围在接入时确认,后续新增字段或事件类型同步说明。记录字段以定位问题为限,不因排查方便而收集业务内容。

事件与字段对照

事件按类型记录,类型保持稳定。新增事件时同步说明字段和用途,避免调用方对记录内容产生误解。查询时先确定事件类型,再按字段缩小范围。

字段与事件对应后,查询结果才能直接用于判断。只记录结果不记录原因,拒绝事件就无法区分权限问题和格式问题;只记录调用方不记录信源,切换过程也无法还原。

事件关键字段用途
访问调用方、信源、时间、结果核对请求是否完成
拒绝错误类型、原因、请求编号排查权限和格式问题
切换原信源、备选信源、原因核对调度与信源状态
配置变更变更人、变更内容、时间核对配置来源
凭据变更凭据类型、操作、时间核对安全事件
访问审计记录查询人、范围、时间核对记录访问

请求编号的串联

请求编号由调用方生成,网关在接入、鉴权、转发和审计各环节沿用同一编号。调用方、网关节点、信源和结果通过编号关联,排查时不需要在多个系统之间反复比对。编号本身不包含业务含义,避免从编号推断内容。

相同请求编号在有效期内只处理一次。调用方超时后使用同一编号重试,可以避免重复写入审计记录。需要区分多次重试时,按编号和时间范围查询,不另造编号。跨系统核对时,请求编号是共同的最小定位信息。

编号由调用方生成,网关不重新编号。调用方在重试时沿用原编号,网关按有效期判断是否重复处理。跨系统核对时,编号与时间范围一起使用,避免只凭编号推断。

查询与导出

查询权限按角色划分,调用方在授权范围内查看记录。导出属于记录使用行为,需要说明用途和范围,导出结果按约定保管。

查询范围过大时先缩小时间区间,再按调用方或信源筛选,避免一次导出过多记录。查询结果与导出结果不一致时,以查询时的记录版本为准,并注明检索条件。

  1. 确认查询用途、时间范围和相关调用方。
  2. 按请求编号、调用方、信源或结果类型缩小范围。
  3. 核对查询权限,确认查询人属于授权角色。
  4. 导出时说明用途和范围,导出行为写入审计记录。
  5. 导出结果按约定保管,不转入未授权的存储位置。

安全事件排查

安全事件排查以控制影响和保留证据为先。暂停凭据可以阻断继续访问,但不应删除已有记录;排查过程中的查询、导出和判断都要留下记录。

  1. 暂停相关凭据,避免影响继续扩大。
  2. 按时间范围和调用方提取访问、拒绝和凭据变更记录。
  3. 核对异常请求的来源、路由键和结果。
  4. 保留原始记录和排查过程,不修改历史日志。
  5. 处理完成后恢复必要凭据,并记录恢复依据。

交付与保管

记录交付按接入约定执行,交付前核对范围、字段和时间区间。保管责任在接入时确认,到期处理方式同样写入约定,避免记录长期无人负责。

  • 记录按接入约定保存,到期后按规则处理。
  • 交付范围以接入约定为准,不包含业务正文。
  • 长期留存按约定执行,交付时注明时间范围和字段。
  • 记录访问需要授权,导出与查阅行为均留记录。
  • 涉及安全事件的记录单独归档,便于后续核对。
  • 交付记录本身也要留痕,注明交付人和接收人。
  • 交付前核对接收方和用途,避免记录流向未授权对象。
  • 记录保管人变更时办理交接,注明交接范围。

常见问题

可以按业务内容查询吗
不提供业务正文查询。需要核对业务内容时,由调用方与信源按约定处理。
日志保存多久
按接入约定执行,到期处理方式在接入时确认。
导出记录需要审批吗
需要授权。导出用途和范围要说明,导出行为本身写入审计记录。
请求编号重复会怎样
有效期内按同一请求处理,返回原结果,不重复写入记录。
审计记录能作为业务凭证吗
审计记录用于核对调用路径和结果,业务凭证由调用方与信源按业务约定处理。
审计记录可以修改吗
不修改历史记录。发现记录错误时新增说明并保留原记录,更正原因一并归档。
调用方可以查看其他租户的记录吗
不可以。查询按租户和授权范围限制,跨租户查询需要单独授权。

明确记录要求

接入前确认事件类型、查询权限、交付范围和保管方式,减少后续分歧。

了解服务