Vault Transit 信封加密验证器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/vault-transit-secrets-envelope-verifier
技能介绍
要解决的具体问题
应用接入 HashiCorp Vault Transit 引擎之后,真正出问题的往往不是「有没有用 Vault」,而是加密链路是否按信封加密的方式工作。常见风险包括:代码虽然调用了 /encrypt、/decrypt,但密钥路径或 key version 传错;轮换时绕过了 /rewrap,导致旧密文无法解密;或者配置里声明了库,实际运行时密钥仍在明文流转。审查者如果只看依赖清单或文档,很难确认密钥的加解密确实发生在 Transit 端点上。
技能如何工作
该技能面向 agent 审查场景,用来实际验证加密工作流,而不是假设库配置好就安全。核心能力:
- 验证
/encrypt、/decrypt、/rewrap端点工作流的调用是否完整、参数是否合理 - 检查信封加密是否真正被使用,确认密钥由 Transit 管理而非本地硬编码
- 检查密钥元数据,确认 key 的版本、类型与状态符合轮换预期
- 覆盖
/rewrap轮换路径,验证现有密文能否被正确重新包裹
关键步骤:扫描应用的密钥处理代码与配置,定位所有加解密调用点;对照 Transit 端点确认信封加密层次;审查密钥元数据与轮换流程,标记任何偏离正确加密模型的位置。
适用边界与注意点
该技能是验证工具,用于确认工作流是否正确,不负责 Vault 自身的部署与高可用配置。它面向自动化审查场景,验证结论依赖于代码与配置的可见性;动态生成的密钥、运行时注入的凭据可能超出检查范围。上游测试需要 Docker 环境。
使用场景
- 代码评审时,确认应用的加解密是否真正走 Vault Transit 端点而不是本地硬编码密钥。
- 轮换密钥后,验证 `/rewrap` 流程能否正确重新包裹存量密文,避免旧数据无法解密。
- 审查服务端密钥处理逻辑,检查 `/encrypt`、`/decrypt` 调用的 key 路径与版本是否符合预期。
- 审计现有密钥的元数据与状态,确认密钥类型、版本和轮换策略满足合规要求。
适合人员
- 负责微服务架构的后端工程师,需要确认服务间密钥交换是否走 Vault Transit 信封加密。
- 安全审计工程师,在上线前验证应用的密钥轮换与密文管理流程是否存在明文泄露风险。
- 构建自动化审查流水线的开发者,需要 agent 能实际验证加密工作流而非仅检查依赖清单。
- 平台工程师,排查因密钥版本或 `/rewrap` 配置错误导致的存量密文解密失败问题。