SuperAPI AI 工具集

audit-logging

智能体与模型

查看项目

更新于 10-15 20:30

技能介绍

用途:为应用提供全面的审计日志能力,追踪用户操作、数据变更与系统事件,满足合规、调试和安全事件调查需求。适用场景包括 SOC 2 / HIPAA 合规、金融交易追踪、用户操作历史、安全事件调查和数据变更追踪。

主要能力:提供 AuditLogService,通过 record 方法记录事件,事件包含 action(如 user.login、order.create)、actor(用户/系统/API 密钥)、resource、details、outcome 等字段;自动补充 id、timestamp、requestId、ip、userAgent 等上下文。提供 logLogin、logDataAccess、logDataChange 等便捷方法。支持将记录写入数据库并可选发送到 CloudWatch 等外部日志。

使用方式:在 Express 或 FastAPI 中通过中间件设置请求上下文(requestId、ip、userAgent),再在业务代码中调用 auditLog.record 或便捷方法。数据库使用追加式 audit_logs 表,并通过触发器阻止 UPDATE/DELETE,保证不可篡改。提供常见查询示例,如用户近期活动、资源变更历史、失败登录、数据导出记录。

限制与注意:资料未提供安装命令、依赖版本、定价或平台支持信息。最佳实践要求永不删除审计日志、记录足够上下文、成功与失败都记录、使用 resource.verb 结构化动作、与普通应用日志分离存储。合规方面需注意 SOC 2、HIPAA、GDPR、PCI DSS 对敏感数据访问、PHI 访问、数据导出与删除、持卡人数据访问的日志要求。