# 审计日志

API7 控制面会记录受支持且已通过身份认证的管理操作。每条记录可帮助你确定谁在何时执行了操作，以及操作影响的资源。审计日志可用于安全监控、故障排查和合规，但并不涵盖每个请求或安全事件。

## 能力[​](#能力 "能力的直接链接")

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

## 审计日志内容[​](#审计日志内容 "审计日志内容的直接链接")

每条审计日志包含：

| 字段           | 说明                                                                                                               |
| -------------- | ------------------------------------------------------------------------------------------------------------------ |
| **时间戳**     | 操作发生的时间。                                                                                                   |
| **操作人员**   | 执行操作的用户详细信息。                                                                                           |
| **事件类型**   | 事件名称，例如 `UpdateContactPoint`。使用 `GET /api/audit_logs/event_types` 获取支持的值。                         |
| **资源**       | 与操作关联的资源 ID 及其可用详细信息。                                                                             |
| **请求和响应** | HTTP 请求方法、URI、请求体和用户代理，以及响应状态码和响应体。该条目记录的是请求和响应，而不是对象变更前后的差异。 |
| **Token 名称** | 通过 Admin API 进行身份认证时使用的 Token。                                                                        |
| **源 IP**      | 发起请求的 IP 地址。                                                                                               |
| **来源**       | 操作是通过控制台还是 Admin API 发起。ADC 操作使用 Admin API，会与其他 API 操作一同记录在审计日志中。               |
| **网关组**     | 与操作关联的网关组 ID（如适用）。                                                                                  |

## 覆盖范围与敏感数据[​](#覆盖范围与敏感数据 "覆盖范围与敏感数据的直接链接")

API7 只为受支持审计范围内、已通过身份认证的操作创建审计记录。带有 `dry-run=all` 的请求以及未通过身份认证的请求（包括登录失败）不会被记录。临时登录锁定或第二因素锁定是例外：进入锁定状态时，系统会写入一条 `UserLoginBanned` 记录，但不会说明具体是哪一种锁定。

API7 会对受支持请求和响应结构中已知的敏感字段进行脱敏。对于这些结构之外被捕获的请求或响应 JSON，系统会直接存储，不进行脱敏。请将审计日志视为敏感数据，限制访问权限，并避免将秘密信息放在普通字段中。

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

## 在控制台中查看审计日志[​](#在控制台中查看审计日志 "在控制台中查看审计日志的直接链接")

要查看审计记录，请登录 API7 控制台，然后转到 **Organization > Audit**。你可以按日期范围、操作人员、事件类型、资源或网关组筛选日志。

## 保留期限[​](#保留期限 "保留期限的直接链接")

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

conf.yaml

```
audit:

  retention_days: 180
```

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

## 导出审计日志[​](#导出审计日志 "导出审计日志的直接链接")

在 **Organization > Audit** 中应用所需筛选条件，并将结果导出为 JSON 或 CSV。然后可以存档该文件，或将其导入外部分析系统。

## 合规与问责[​](#合规与问责 "合规与问责的直接链接")

对于审计覆盖的操作，审计日志可帮助确定谁在何时执行了操作。请勿仅依赖审计日志检测未通过身份认证的活动。

## 后续步骤[​](#后续步骤 "后续步骤的直接链接")

* [基于角色的访问控制（RBAC）](https://docs.apiseven.com/api7-gateway/security-and-compliance/role-based-access-control.md)，限制能够执行管理变更的人员。
* 查看 [API7 信任中心](https://docs.apiseven.com/api7-gateway/security-and-compliance/trust-center.md)，了解认证和安全报告。
