审计日志：API 活动追踪与合规审计

审计日志提供您组织内所有 API 活动的完整、可搜索记录。无论请求来自控制台、您的集成还是团队成员，发送到 Didit 平台的每个请求都会被自动记录，用于安全、合规和故障排查。

---

​

为什么需要审计日志？

---

​

访问审计日志

在 Didit 控制台中打开 Settings > Organization > Audit log。界面会按时间顺序显示您组织内所有 API 请求的列表。 每条日志记录包含以下字段：

​

调查员所做的决定

每项由调查员自行做出的决定都记录在 调查员 名下，而不记录在某个成员或 API 密钥名下。这些决定包括：批准或拒绝会话、要求重新提交、设置交易状态，以及结案、升级案件或请求提供案件相关信息。 该条目会链接到该决定所依据的调查员报告。 当人员接受或推翻调查员的建议时，该条目会记录在该人员名下。

---

​

筛选与搜索

审计日志界面提供强大的筛选功能，帮助您准确找到所需内容。

​

智能搜索

搜索栏会自动识别您要查找的内容：

​

可用过滤器

---

​

数据保留

您的套餐决定了您可以回溯查看审计日志的时长，以及是否可以导出日志： 在不支持导出的套餐上发起导出，将返回 403，并附带 "code": "plan_limit_exceeded"。

---

​

安全与隐私

​

记录的内容

审计日志记录 API 请求的元数据：

• 请求时间戳和持续时间
• 用户身份（邮箱、用户 ID），或发出请求的 API 密钥（其名称以及密钥的前几个字符，绝不包含完整密钥）
• 请求路径和查询参数
• 响应状态码
• 客户端地址和用户代理

​

API 密钥调用的请求体和响应体

对于使用 API 密钥发起的调用，审计日志会保存写入操作的 JSON 请求体的脱敏副本，以及写入操作或出错调用的响应的脱敏副本，以便您了解调用失败的原因。成功的读取操作的响应不会被保存。 脱敏采用默认拒绝策略：

• 结构保持不变：字段名、嵌套关系、值类型、数组长度和字符串长度。
• 仅当某个值是 Didit 自身的标识符、状态、代码、计数或时间戳，且位于 Didit 定义的字段中并符合该字段的预期格式时，该值才会保留。
• 布尔值仅在 Didit 定义的字段中保留。
• 其他所有值都会被替换为标记，标明其类型和长度，例如 [redacted:string:12]、[redacted:number:5] 或 [redacted:boolean]；null 保持为 null。
• 如果字段名不是普通标识符（例如用作键的邮箱地址或电话号码），则会被替换为 [redacted:key:23]。
• 非 JSON 的请求体（例如表单或文件上传）会被替换为说明其类型的备注。
• 保留的内容最多为 4,096 个字符。

查询参数同样经过上述脱敏处理。 仅保留 content-type、user-agent 和速率限制头等标准请求头；其他所有请求头连同其值一并丢弃。 您自己的系统发送的值（例如 metadata 或 vendor_data 中的值）绝不会被保留，即使其字段名与 Didit 的某个字段名相似。

​

未记录的内容

为保护敏感数据，以下内容会被自动排除：

• 身份验证令牌和凭据
• 密码和密钥
• 验证会话中的个人数据

​

访问控制

查看审计日志需要 audit-logs 的读取权限和列表权限。Reader、Compliance Officer、Developer、Admin 和 Owner 角色均拥有这些权限；自定义角色可在角色编辑器中勾选 Audit logs 来获得这些权限。

---

​

常见用例

---

​

最佳实践

1. 定期检查：定期审查审计日志，尽早发现异常。
2. 缩小搜索范围：使用特定过滤器减少干扰信息，更快找到相关记录。
3. 日期范围：处理大型数据集时，请始终指定日期范围，以获得更好的性能。
4. 收藏搜索：将常用的过滤器组合保存为浏览器书签，方便快速访问。