架构与系统设计 / 系统课时

审计日志设计

审计日志设计

本课解决“谁在何时对哪个租户执行了什么敏感操作,结果如何,变更前后有什么差异”的追责问题。完成后,你将能定义统一审计事件、设计可查询的数据表,并建立可靠写入、脱敏和留存策略。

学习目标

  • 区分审计日志与普通运行日志的职责
  • 设计覆盖登录、授权、配置、导出和敏感操作的审计事件
  • 建立可靠、可检索且受权限保护的审计存储方案

审计事件应回答什么

审计日志不是调试日志,而是面向安全、合规和责任追溯的业务证据。每条事件至少要回答六个问题:哪个租户、谁操作、何时发生、操作对象是什么、执行结果如何、关键数据发生了什么变化。

建议统一记录 tenantId、eventId、eventTime、actorId、actionType、resourceType、resourceId、result、requestId 和 traceId。登录失败时可能没有确定的 actorId,但仍应保留登录名摘要、客户端 IP、失败原因和租户识别结果。

登录、角色授权、租户配置修改、密钥轮换、批量导出、资金相关操作、数据删除和管理员代操作都应进入审计范围。普通查询不必全部记录,否则会造成高噪声和高存储成本;但读取敏感数据或大批量导出属于例外。

可靠写入链路

敏感操作的业务结果与审计事件必须保持一致。直接在接口末尾“顺手写一条日志”容易在事务回滚、进程崩溃或消息发送失败时丢失记录。更稳妥的做法是在同一事务中写业务数据和审计发件箱,再由消费者异步写入独立审计库。

审计事件可靠写入流程图

低风险系统也可以同步写审计表,但必须明确失败策略:审计写入失败时,是阻断敏感操作,还是记录补偿任务。对于授权变更、密钥操作和资金操作,通常应优先保证审计成功,不能静默忽略异常。

审计表结构

下面给出 MySQL 8 的主表示例。before_data、after_data 和 detail 使用 JSON 保存结构化信息,但只记录必要字段,不能把完整请求体原样落库。

sql
CREATE TABLE tenant_audit_event (
    id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
    event_id VARCHAR(64) NOT NULL,
    tenant_id BIGINT UNSIGNED NOT NULL,
    event_time DATETIME(3) NOT NULL,
    actor_type VARCHAR(32) NOT NULL,
    actor_id VARCHAR(64) NULL,
    actor_name VARCHAR(128) NULL,
    action_type VARCHAR(64) NOT NULL,
    resource_type VARCHAR(64) NOT NULL,
    resource_id VARCHAR(128) NULL,
    result VARCHAR(16) NOT NULL,
    risk_level VARCHAR(16) NOT NULL,
    request_id VARCHAR(64) NULL,
    trace_id VARCHAR(64) NULL,
    client_ip VARCHAR(45) NULL,
    before_data JSON NULL,
    after_data JSON NULL,
    detail JSON NULL,
    created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
    PRIMARY KEY (id),
    UNIQUE KEY uk_event_id (event_id),
    KEY idx_tenant_time (tenant_id, event_time),
    KEY idx_actor_time (tenant_id, actor_id, event_time),
    KEY idx_action_time (tenant_id, action_type, event_time)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

预期输出如下,执行耗时会因环境不同而变化。

text
Query OK, 0 rows affected (<TIME> sec)

uk_event_id 用于消费幂等,避免消息重试生成重复事件。idx_tenant_time 支持租户按时间检索,另外两个索引分别覆盖“查看某个操作者”和“查看某类敏感操作”的常见查询路径。不要只建立单列时间索引,因为审计查询通常必须先限定租户。

记录变更与敏感信息

配置和授权变更应保存最小化的前后差异。例如角色权限从 ["order:read"] 变为 ["order:read","order:refund"],审计事件应记录新增权限,而不是复制整张角色表。对于数据导出,记录查询条件摘要、导出条数、文件标识和审批单号,不记录导出文件的完整内容。

密码、访问令牌、私钥、验证码和银行卡敏感字段禁止进入审计明文。手机号、证件号等标识可以脱敏或保存不可逆摘要;确需查看原值时,应通过受控业务系统访问,并产生新的审计事件。

result 建议区分 SUCCESS、FAILURE 和 DENIED。业务校验失败、权限拒绝和系统异常不是同一种结果,分类后才能准确识别越权尝试、暴力登录和异常失败率。

权限、留存与验证

审计表应使用独立数据库账号,应用账号只具备插入和查询所需权限,不具备更新与删除权限。更高要求的场景可定期归档到对象存储并启用保留策略,降低数据库被入侵后批量篡改历史记录的风险。

留存周期应根据法规、合同和风险等级制定。可以将近几个月数据保留在在线库以便检索,更早数据转入归档;不要把具体天数写死在代码中,而应由租户策略或合规配置管理。

验证时执行一次角色授权变更,确认业务数据与发件箱在同一事务提交,随后检查审计库只出现一条对应 eventId 的记录。重复投递同一消息后,唯一键应阻止重复写入;再模拟消费失败,确认重试和告警能够触发。

本课总结

  • 审计事件必须完整回答租户、主体、时间、对象、结果和变更内容
  • 业务事务加发件箱可以降低审计事件丢失风险,eventId 唯一键负责消费幂等
  • 审计数据要最小化、脱敏、只追加,并通过独立权限和归档策略保护

下一课预告

下一课将把日志、链路和审计数据接入统一监控体系,设计租户级指标、告警规则和运维排查入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

审计日志设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通