跳到主要内容
版本:3.9.x

审计日志

API7 控制面会记录受支持且已通过身份认证的管理操作。每条记录有助于识别操作者、操作时间和受影响资源。审计日志可用于安全监控、故障排查和合规,但不覆盖每个请求或安全事件。

能力​

  • 管理操作跟踪:记录受支持且已通过身份认证的路由、服务、插件和安全策略变更。
  • 详细上下文:记录操作者、事件时间、资源、请求、响应及操作来源。
  • 长期保留:根据合规需求配置审计数据的保留期限。
  • 导出:将筛选后的审计日志导出为 JSON 或 CSV,以供外部分析和归档。

审计日志内容​

每条审计日志包含:

字段说明
时间戳操作发生的时间。
操作者执行操作的用户详情。
事件类型具名操作,例如 UpdateContactPoint。可通过 GET /api/audit_logs/event_types 获取受支持的值。
资源与操作相关的资源 ID 和可用详情。
请求和响应HTTP 请求方法、URI、正文和 User-Agent,以及响应状态码和正文。记录的是请求和响应,而非对象变更前后的差异。
Token 名称通过 Admin API 身份认证的操作所用的 Token。
源 IP发起请求的 IP 地址。
来源操作来自控制台还是 Admin API。ADC 使用 Admin API,其操作与其他 API 操作一同被审计。
网关组与操作相关的网关组 ID(如适用)。

覆盖范围与敏感数据​

API7 只为受支持审计集合中的已认证操作创建审计记录。使用 dry-run=all 的请求和未经身份认证的请求(包括登录失败)不会被记录。

API7 会对受支持的请求和响应结构中的已知敏感字段进行脱敏。若捕获的请求或响应 JSON 不属于这些结构,内容会未经脱敏直接存储。应将审计日志视为敏感数据,限制访问,且不要在普通字段中放入机密。

控制台和 Admin API 不提供编辑审计记录的受支持流程。应保护控制面数据库,防止直接修改或删除日志。

在控制台中查看审计日志​

要查看审计记录,请登录 API7 控制台,然后转到 RBAC > Audit Logs。你可以按日期范围、操作人员、操作类型或特定资源筛选日志。

保留期限​

默认情况下,审计日志保留 60 天。控制面会运行后台清理任务,删除超过配置保留期限的审计条目。要更改保留期限,请在控制面配置中设置 audit.retention_days:

conf.yaml
audit:
retention_days: 180

如果合规框架要求保留更长时间的审计历史,请延长保留期限;如果希望减少数据库存储占用,则可以缩短保留期限。

导出审计日志​

将筛选后的审计日志导出为 JSON 或 CSV,然后归档文件或导入外部分析系统。

合规与问责​

对于审计覆盖范围内的操作,日志有助于确认执行者和操作时间。不要仅依赖审计日志检测未经身份认证的活动。

后续步骤​