审计日志

查看组织中所有改变状态的操作历史:谁在何时、从何处执行了什么操作。记录仅可追加,任何篡改均可检测。

审计日志以可搜索、可筛选的时间线,展示组织中支持记录的管理操作,包括角色分配、引擎编辑和 API 密钥签发。详见覆盖范围限制。审计日志和角色与权限均需 Enterprise 套餐才能使用。

日志在数据库层面仅允许追加:应用程序的数据库连接无法更新、删除或清空审计记录。一经写入,记录便会原样保留。

记录哪些信息 #

每个事件都会记录操作者、操作、目标,以及接收请求时的 HTTP 上下文。

字段说明
操作者执行操作的用户或 API 密钥
操作表示操作类型的值,例如 engine.created 或 member.role_changed
目标操作涉及的实体(例如引擎、角色或术语表条目)
元数据相关实体的 ID,绝不记录名称、电子邮件地址或内容片段
请求上下文request_id、IP 地址、用户代理,在通过 HTTP 接收到调用时记录
时间戳UTC 时间,以及用于检测序列缺口的单调递增序号

仅存储 ID,是刻意的设计

元数据列只存储 ID,不存储可直接阅读的值。界面在读取时关联当前名称,因此重命名引擎或用户不会改写历史记录。这也避免了审计记录与 GDPR 删除权发生冲突,因为记录中没有需要删除或遮蔽的内容。

覆盖哪些操作 #

事件按类别分组,与仪表板中的筛选类别一致。

类别目前已接入的操作
组织org.created, org.settings_updated, org.deleted
成员member.invited, member.removed, member.role_changed
角色role.created, role.updated, role.deleted
引擎engine.created, engine.updated, engine.deleted
API 密钥api_key.created, api_key.revoked
内容glossary_item.*, instruction.*, brand_voice.*(仅限单项操作)

访问日志 #

审计日志入口始终显示在设置的管理下。未开通此功能时,页面会显示“你的套餐不支持审计日志”,而不是时间线。进入页面后,你会看到:

  • 可筛选列表 — 按操作、操作者和时间段缩小范围(可选择最近 7 天等预设,或设置开始日期 / 结束日期范围)。无法选择未来日期。
  • 加载更早的事件 — 事件按从新到旧的顺序排列;点击列表底部的加载更早的事件即可加载下一页。
  • 事件详情 — 点击任意行即可原位展开,查看完整的元数据、请求 ID、IP 地址和用户代理。
  • 可分享的视图 — 筛选条件和已展开的事件都会体现在 URL 中,因此任何视图都可以分享。

谁可以查看 #

访问此页面需要满足两个条件:

  1. 功能开通 — 组织必须已启用审计日志功能(需要 Enterprise 套餐)。
  2. 权限 — 查看者的角色必须包含 org:view_audit_logs。预置的完全访问角色默认包含此权限;所有者始终拥有此权限。

没有此权限的成员会看到“无权访问”页面,而不是时间线。组织未开通此功能时,其成员会看到付费提示页面。

如果你的 Enterprise 套餐失效

审计日志与 RBAC 受同一套餐级别的功能授权控制。历史事件仍会保留在数据库中,但页面会显示“你的套餐不支持审计日志”,读取端点会返回 403,直到套餐恢复。

篡改检测 #

审计日志不只是留存记录,还能切实增加事后篡改的难度。

  • 数据库层面仅允许追加。 创建表的数据库迁移会对 API 角色执行 REVOKE UPDATE, DELETE, TRUNCATE。此后,任何试图更改记录的代码路径,无论是漏洞、新端点,甚至 SQL 注入,都会在改动发生前被 Postgres 拒绝。
  • 单调递增序列。 每条记录都有一个严格递增的 seq 列。审计人员检查序列时,可以通过序号缺口发现删除行为。

这些措施足以满足 SOC 2 一类的控制要求,但无法防御持有生产数据库直接访问凭据的攻击者。如有需要,可提供更强的防护方案(独立的所有者角色、WORM 镜像)。

保留期限 #

审计事件默认永久保留。自定义保留期限(通常为 1 年、3 年或 7 年)需使用 Enterprise 套餐。如果你需要特定的保留策略来满足合规要求或填写安全问卷,请联系我们。

未覆盖的范围 #

第一版有几项刻意设置的限制,请留意:

  • 尽力写入,不保证事务性。 事务性写入已列入近期开发计划。审计事件在其描述的操作完成后写入,不与该操作处于同一个数据库事务中。在少数故障情况下(操作成功,但随后插入审计记录失败),操作可能已发生,却没有对应的事件记录。
  • 部分操作类型尚未接入。 引擎成员变更、集成连接 / 更新 / 断开连接、模型配置编辑、计费订阅变更,以及批量内容操作(CSV 上传、createMany / updateMany / deleteMany)目前还不会生成事件。相关操作标识已预留,接入后便会出现在现有的筛选类别下。
  • 不审计读取操作。 查看审计日志本身、浏览引擎请求日志或下载术语表都不会生成事件。只有改变状态的操作才会生成事件。
  • 暂不支持导出。 审计数据通过仪表板展示。CSV 导出、SIEM Webhook 和 S3 镜像已列入开发计划,如有需要,请告诉我们。
  • 没有按引擎划分的视图。 组织的所有审计事件都显示在同一条时间线上。可按操作或操作者筛选,缩小查看范围。
  • 不支持实时追踪。 没有刷新按钮,也没有 WebSocket 数据流;请重新加载页面以获取最新事件。

后续步骤 #