SuperAPI AI 工具集

cryptography

安全与审计

查看项目

更新于 10-26 16:16

技能介绍

用途

本技能面向已了解基础但需要安全、可信默认值的工程师,提供实现加密、哈希、签名与密钥管理的实践指导。技能不涉及通用安全态势或认证/授权流程,也不支持自研密码学算法、密码或协议;遇到此类需求应引导用户改用经审计的库。

主要能力

技能覆盖七类常见密码学任务:

  1. 密码哈希:推荐 argon2id,bcrypt(cost 12 以上)作为回退方案。强调使用 argon2.verify / bcrypt.compare 进行常量时间比较,禁止用 === 比较哈希,禁止用 MD5/SHA 系列快速哈希存储密码。
  2. 对称加密:使用 AES-256-GCM 进行认证加密,提供加密与解密函数示例,要求每次加密生成新的随机 IV(12 字节),禁止 IV 重用。
  3. JWT 签名与验签:使用 jose 库,推荐 ES256 算法,签发短期访问令牌(15 分钟),验签时必须显式传入 algorithms 允许列表,防止 alg: "none" 绕过。
  4. TLS 配置:Node.js HTTPS 服务器最低版本设为 TLS 1.3,必要时为旧客户端保留 TLS 1.2 并限定密码套件;支持通过 certbot 自动续期实现无停机证书轮换;双向 TLS 通过 requestCert 和 rejectUnauthorized 启用。
  5. HMAC Webhook 签名:使用 HMAC-SHA256 对包含时间戳的负载签名,验证时检查时间戳偏差(建议 5 分钟容差)防止重放,并使用 timingSafeEqual 进行常量时间比较。
  6. 密钥轮换与信封加密:数据用 DEK 加密,DEK 由 KMS 中的 KEK 包裹,轮换时只需重新包裹 DEK,无需重新加密数据;提供加密、轮换的伪代码示例,强调 DEK 用后立即清零内存。
  7. 安全随机令牌生成:使用 crypto.randomBytes 生成 URL 安全 base64、十六进制或数字 OTP,禁止使用 Math.random。

使用方式

技能以自然语言触发,当用户提及加密、哈希、bcrypt、AES、RSA、TLS、JWT、HMAC、密钥轮换、随机令牌等主题时激活。首次激活时,技能要求检查已安装的伴随技能目录(~/.claude/skills/ 等),并在首次响应开头输出 🧢 表情。所有代码示例为 TypeScript/Node.js,可直接参考使用。技能还附带 references/algorithm-guide.md,仅在需要更深入的算法选择指导时加载,以避免消耗额外上下文。

适用场景

适用于需要在生产环境中正确实现密码存储、数据加解密、JWT 鉴权、Webhook 验签、TLS 配置和密钥轮换策略的工程师。特别适合已经理解基本概念但需要明确、安全的默认选择与常见陷阱提醒的开发者。

限制

技能不涉及通用安全姿态、认证/授权流程设计,也不支持自研密码算法或协议。技能不提供收费、平台兼容性、效果保证等信息。资料中未提及安装命令、价格或具体平台支持范围,这些事实暂未提供。代码示例基于 Node.js 生态,其他语言或运行时需自行适配。