Agent Skills
返回列表
🔒

SOPS 密钥管理

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 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 声明哪些字段需要加密、哪些身份可以解密,把策略写进代码,而不是散落在口头约定里。

落地步骤

  1. 选择 KMS 或 PGP 作为密钥环,确定由谁持有解密能力。
  2. 编写 .sops.yaml,明确加密范围与允许解密的身份。
  3. 执行加密后,把密文提交进 Git;仓库里只保存密文。
  4. 在 CI 或运行环境中,使用对应身份解密并注入环境变量,应用本身仍然只处理运行时的明文。

权限、轮换与审计

  • 只给必要角色开通解密权限,避免人人可解。
  • 人员离职时立即撤销对应 KMS / PGP 权限。
  • 定期轮换主密钥,减少长期有效密钥带来的暴露面。
  • 审计谁在何时执行了解密,让密钥使用可追溯。

适用边界与注意点

适合已经在用 Git 管理配置、且希望把 secret 纳入版本控制与权限体系的团队。它解决的是存储和分发阶段的明文暴露问题,不能替代权限系统、漏洞扫描或运行时沙箱;密钥泄露后的应急撤销、合规评审仍需要安全团队介入。

常见陷阱包括:把 PGP 私钥明文放在 CI 机器上,效果等同于没加密;全员共用同一把密钥,导致无法追责和隔离;以及把密文和明文一起提交,直接造成泄露。AI 输出以官方资料为准,涉及安全合规的重大策略变更,请先经安全团队评审。

使用场景

  • 团队要把 Kubernetes 配置提交到 Git,但不愿把数据库口令和 API key 写成明文
  • CI 流水线需要在构建时注入密钥,又想避免把凭证复制进仓库或聊天记录
  • 开发者想用 `.sops.yaml` 限制可解密身份,并在人员离职后撤销对应权限
  • 运维要轮换主密钥,同时保留谁在何时解密的审计记录

适合人员

  • 负责把配置提交进 Git 的后端工程师,希望数据库口令只以密文形式入库
  • 维护 CI/CD 流水线的 DevOps 工程师,需要在运行时安全注入密钥
  • 保护生产环境的安全工程师,想收敛解密权限并定期轮换主密钥
  • 管理密钥策略的平台负责人,需要给团队定解密边界和审计要求