SOPS 密钥管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/secret-management-sops 到你的 AI 助手中。
技能介绍
问题:明文密钥不该出现在 Git 和聊天记录里
很多团队把 API key、数据库口令、云凭证直接写进配置文件,再推上 Git。结果是密钥跟着代码一起被复制、被镜像、被离职员工带走,而且无法追溯谁读过、谁改过。聊天记录里贴 secret,更会把敏感信息扩散到本不该出现的地方。
这个技能把密钥当作需要版本化、加密和审计的对象:让密文进仓库,让明文只在 CI/运行时按身份解密注入。
核心能力
- 对配置文件中的特定字段加密,而不是整文件糊掉,保留
yaml/json等结构可读性,正常 diff、评审仍可进行。 - 支持多种加密后端:
AWS KMS、GCP KMS、Azure Key Vault、PGP。 - 通过
.sops.yaml声明哪些字段需要加密、哪些身份可以解密,把策略写进代码,而不是散落在口头约定里。
落地步骤
- 选择
KMS或PGP作为密钥环,确定由谁持有解密能力。 - 编写
.sops.yaml,明确加密范围与允许解密的身份。 - 执行加密后,把密文提交进 Git;仓库里只保存密文。
- 在 CI 或运行环境中,使用对应身份解密并注入环境变量,应用本身仍然只处理运行时的明文。
权限、轮换与审计
- 只给必要角色开通解密权限,避免人人可解。
- 人员离职时立即撤销对应
KMS/PGP权限。 - 定期轮换主密钥,减少长期有效密钥带来的暴露面。
- 审计谁在何时执行了解密,让密钥使用可追溯。
适用边界与注意点
适合已经在用 Git 管理配置、且希望把 secret 纳入版本控制与权限体系的团队。它解决的是存储和分发阶段的明文暴露问题,不能替代权限系统、漏洞扫描或运行时沙箱;密钥泄露后的应急撤销、合规评审仍需要安全团队介入。
常见陷阱包括:把 PGP 私钥明文放在 CI 机器上,效果等同于没加密;全员共用同一把密钥,导致无法追责和隔离;以及把密文和明文一起提交,直接造成泄露。AI 输出以官方资料为准,涉及安全合规的重大策略变更,请先经安全团队评审。
使用场景
- 团队要把 Kubernetes 配置提交到 Git,但不愿把数据库口令和 API key 写成明文
- CI 流水线需要在构建时注入密钥,又想避免把凭证复制进仓库或聊天记录
- 开发者想用 `.sops.yaml` 限制可解密身份,并在人员离职后撤销对应权限
- 运维要轮换主密钥,同时保留谁在何时解密的审计记录
适合人员
- 负责把配置提交进 Git 的后端工程师,希望数据库口令只以密文形式入库
- 维护 CI/CD 流水线的 DevOps 工程师,需要在运行时安全注入密钥
- 保护生产环境的安全工程师,想收敛解密权限并定期轮换主密钥
- 管理密钥策略的平台负责人,需要给团队定解密边界和审计要求