如何查看和导出 Apifox 审计日志

Apifox 审计日志会在组织级别记录受支持的安全相关活动。组织所有者和管理员可以利用这些日志确定谁执行了某项操作、操作发生的时间、来源 IP 地址以及受影响的组织资源。

本教程涵盖筛选、调查、CSV 导出和基于 API 的采集。这些记录属于管理审计日志；它们不是生产环境的 API 请求日志或网关访问日志。

开始之前

如果调查可能超出 180 天，请在记录过期前导出或采集所需记录。

打开你的 Apifox 组织，然后前往 审计日志 在组织设置中。

表格包含：

审计日志提供组织级别的受支持安全和管理事件记录。

只有当 Apifox 能够可靠地将身份验证事件归因于该组织时，这些事件才会显示。

从一个具体问题入手，例如：

使用实际可行的最小时间范围。可用的预设包括最近 7、30、90 和 180 天。你也可以在 180 天的数据保留期限内选择自定义范围。

在将这些事件与身份提供商、工单系统、Git 或服务日志进行比较前，记录事件响应或审计流程所使用的时区。

按以下条件筛选表格：

组合使用时间、事件和操作者筛选条件，以隔离调查所需的记录。

如果不知道操作者，先按时间和事件筛选。如果不确定事件名称，先按操作者和较短的时间范围筛选。

对于每一条相关记录，请记录：

然后，将事件与能够回答下一个问题的来源进行关联：

审计事件表明某项受支持的操作已经发生。但仅凭该事件本身，无法证明该操作经过授权、安全或合规。

筛选条件确认无误后：

CSV 导出使用当前应用于审计日志页面的筛选条件，并包含 180 天保留期内匹配的记录。

导出审计日志这一操作本身也会记录在审计日志中。下游 CSV 是单独的副本，因此请使用适当的访问控制、保留策略和完整性控制来保护它。

Enterprise 组织可以通过审计日志 API 以编程方式查询记录。该 API 支持在 180 天保留期内按时间窗口查询，并支持游标分页。

对于计划任务式的采集流程：

每次 API 查询都会作为摘要记录下来，其中可能包括调用方、IP 地址、查询窗口、limit、结果和时间戳。完整的返回载荷不会复制到该事件的元数据中。

在实现身份验证、端点路径、请求参数或响应解析之前，请验证当前的 API 参考文档。不要将未经验证的代码示例直接复制到生产环境采集器中。

结束调查前，请确认你已经：

对于访问权限变更，还要验证当前状态。日志可以显示角色发生了变化，但成员页面会显示当前分配的角色。

Apifox 对审计日志页面、CSV 导出和 API 响应应用相同的脱敏策略。审计记录不会暴露令牌值、密码、密钥值、原始 SAML 断言、重置令牌、私钥或导出的文件内容。

元数据仍可能包含敏感信息。请限制对导出记录的访问，避免将其放入公开工单或共享文档中。

问题	检查项
审计日志页面不可用	确认组织使用 Enterprise SaaS，且查看者是组织所有者或管理员。
缺少预期的身份验证事件	只有当 Apifox 能够可靠地将身份验证事件归因于该组织时，这些事件才会显示。同时检查身份提供商。
CSV 中的记录少于预期	检查当前启用的时间、事件和操作者筛选条件。导出使用当前筛选条件。
API 采集器遗漏记录	检查查询窗口、游标处理、重试机制以及 180 天限制。
缺少运行时 API 调用	使用网关、应用程序或 API 访问日志。Apifox 审计日志是组织管理日志。