审计日志
查清谁改了什么: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 校验结果,可同时排查配置变更和被拒绝的事件。
验证
- 在
/admin/licences手动发放一张许可证。/admin/audit顶部出现一条billing.licences.issued,目标是这张许可证的 id。 - 按这个动作筛选,只剩这类记录。
- 展开这一行,元数据里有产品 key 和被授予的用户。
- 用一个没有
audit.read的角色登录,页面显示无权限。
参考
- 角色与权限
- 限流:同一份快照里的限流规则
- Drizzle 插入:仓储如何追加这一行