SuperAPI AI 工具集

lgpd-audit-logging

安全与审计

查看项目

更新于 10-30 16:17

技能介绍

审计日志

该技能用于生成不可篡改、哈希链式的审计日志,用来证明合规(第 6 条第 X 项,问责制)以及记录事件(Res. 15/2024 第 10 条,5 年留存)。

原则

  • 只追加(Append-only):不允许更新或删除。
  • 哈希链:每条记录引用前一条的哈希(可检测篡改)。
  • 数据最小化:只记录事件和载荷哈希,不记录明文载荷。
  • 排除 PII:绝不记录完整 PII(需脱敏)。
  • 留存:与事件相关的记录至少保留 5 年;常规事件保留 6 个月以上。

应记录的事件

  • 认证(登录、登出、MFA、失败尝试)
  • 访问个人数据(尤其是敏感数据)
  • 同意变更(授予、撤销)
  • DSAR(接收、履行、拒绝)
  • 隐私配置变更
  • 管理员访问其他用户的数据
  • 批量导出与下载
  • RBAC 变更

Prisma 模型结构

model AuditLogEntry {
  id          String   @id @default(cuid())
  actorId     String?  // null se sistema
  actorType   ActorType
  action      String   // "READ", "WRITE", "DELETE", "EXPORT", "DSAR_FULFILLED", "CONSENT_REVOKED"
  resource    String   // "User:abc123", "Order:xyz"
  subjectId   String?  // titular afetado (se aplicável)
  legalBasis  String?
  purpose     String?
  ipAddress   String?  @db.Inet
  userAgent   String?
  payloadHash String   // SHA-256 do payload (sem PII)
  prevHash    String?  // hash do registro anterior
  selfHash    String   // SHA-256(prevHash || timestamp || action || resource || payloadHash)
  timestamp   DateTime @default(now())

  @@index([subjectId, timestamp])
  @@index([actorId, timestamp])
  @@index([action, timestamp])
}

enum ActorType { USER ADMIN SYSTEM OPERATOR }

Next.js 中间件示例

// lib/audit.ts
import { createHash } from "crypto";
import { db } from "./db";

export async function logAudit(entry: {
  actorId?: string;
  actorType: ActorType;
  action: string;
  resource: string;
  subjectId?: string;
  legalBasis?: string;
  purpose?: string;
  payload?: object;
  req?: Request;
}) {
  const last = await db.auditLogEntry.findFirst({
    orderBy: { timestamp: "desc" },
    select: { selfHash: true }
  });

  const payloadHash = createHash("sha256")
    .update(JSON.stringify(entry.payload ?? {}))
    .digest("hex");

  const timestamp = new Date();

  const selfHash = createHash("sha256")
    .update(`${last?.selfHash ?? ""}|${timestamp.toISOString()}|${entry.action}|${entry.resource}|${payloadHash}`)
    .digest("hex");

  return db.auditLogEntry.create({
    data: {
      ...entry,
      payload: undefined,
      payloadHash,
      prevHash: last?.selfHash,
      selfHash,
      ipAddress: entry.req?.headers.get("x-forwarded-for") ?? null,
      userAgent: entry.req?.headers.get("user-agent") ?? null,
      timestamp
    }
  });
}

完整性校验

定期脚本按顺序遍历所有记录,验证每条记录的 selfHash 是否匹配。任何不一致都意味着篡改或程序缺陷。

使用方式

  • 将生成的 Prisma 模型加入项目 schema,并迁移数据库。
  • 把 logAudit 中间件接入关键路由与操作。
  • 配置周期性完整性校验任务(资料示例为每周一次)。
  • 按留存要求配置清理策略(关键事件 5 年)。

适用场景

  • 需要在应用层实现 LGPD 合规审计追踪的产品与服务。
  • 涉及个人数据访问、同意管理、DSAR 处理、权限变更等需留痕的系统。

限制

  • 资料只提供设计原则、模型与示例代码,未说明其他框架的适配方式。
  • 未提供依赖版本、性能开销、部署要求和成本信息。

状态更新

F6 — 审计日志 ✓

  • Schema 已实现
  • 中间件已在关键路由启用
  • 完整性校验已排期(每周)
  • 留存已配置(关键事件 5 年)
  • 下一步:lgpd-encryption-keys