审计日志

查清谁改了什么:48 处写入路径记录操作者、动作、目标和元数据。

需要留痕的写入(发放许可证、退款、保存配置、改派工单、删除文件)都会在执行它的代码路径里向 audit_logs 追加一行。后台在 /admin/audit 列出最近 500 条,可按动作筛选,每行的元数据可以展开。

准备工作

  • 一个有 audit.read 的账号。见角色与权限。
  • 无需配置。日志从第一个请求起开始记录,不依赖服务商。

设置

给审计员这一个权限,也只给这一个

audit.read 只能读日志。它不隐含 config.read、users.write 或别的任何权限,所以可以给合规审查人员一个能查看所有变更、但不能做任何修改的账号。

读日志

/admin/audit 列出操作者、动作、目标和时间。按动作筛选可以缩小范围。展开一行可以查看写入时记录的元数据,例如订单号、服务商名、权限键。

给自己的写入补记录

新增写入路径时,在执行写入的那个仓储里追加日志,这样记录和变更一起写入:

await recordAudit("billing.refund.created", orderId, { provider, amountCents });

actor 是执行这次写入的子系统。元数据是 JSON,之后检索不需要迁移。

今天记录了哪些动作

共有 48 处调用点写入日志,按所属子系统分组:

前缀例子
billing.*checkout.created、refund.created、licences.issued、licences.revoked、portal.created
support.*ticket.created、ticket.replied、ticket.assignment.updated
cms.*entry.upserted、taxonomy.created
email.*、notification.*template.saved、delivery.recorded、webhooks.saved、preferences.updated
affiliate.*referral.created、conversion.recorded、payout.requested
newsletter.*、waitlist.*subscribed、unsubscribed、joined
file.*uploaded、deleted
analytics.*event.recorded

一行长什么样

Prop

Type

页面快照还包含限流规则及最近 20 条 webhook 校验结果,可同时排查配置变更和被拒绝的事件。

验证

  1. 在 /admin/licences 手动发放一张许可证。/admin/audit 顶部出现一条 billing.licences.issued,目标是这张许可证的 id。
  2. 按这个动作筛选,只剩这类记录。
  3. 展开这一行,元数据里有产品 key 和被授予的用户。
  4. 用一个没有 audit.read 的角色登录,页面显示无权限。

参考

下一步