密钥管理(生成、存储、注入与轮换)

密钥管理控制凭据从生成、授予、存储、使用到轮换、撤销和销毁的生命周期;出站访问第三方服务需要受控取回原密钥,而验证入站随机令牌可只保存其校验摘要。

二稿核验说明(2026-10-15):已按文末官方文档与原始材料修订概念、适用条件和示例解读。一稿声称的Debian/工具版本及输出作为来源记录保留,不等于本次Windows/Python 3.12.14执行证明;本次运行范围以随稿核验日志为准。示例产品、账号、数据与凭据均为虚构。

一句话定义

密钥管理控制凭据从生成、授予、存储、使用到轮换、撤销和销毁的生命周期;出站访问第三方服务需要受控取回原密钥,而验证入站随机令牌可只保存其校验摘要。

适用边界与判断方法

只有摘要的数据库无法恢复第三方API Key,因此不应称为可取回密钥的保险库。随机高熵令牌可用密码学哈希加恒定时间比较核验,低熵人类密码须采用适当的密码哈希算法。环境变量是注入渠道,不是加密或访问隔离;.env、进程继承、崩溃转储与日志都需管理。已知泄露时应立即撤销,双密钥宽限只适合正常轮换。 对应依据:OWASP密钥管理;OWASP会话管理。

为什么重要

  • LLM API Key、云 Access Key 一旦进仓库或镜像,扫描器与供应链攻击会可能被自动发现和滥用;不存在本文已验证的统一利用时间。
  • K8s Secret 默认只是 base64(见 k6.ops.kubernetes);云上应接 KMS / Secrets Manager。
  • “删掉文件”不等于安全——Git 历史仍在,必须轮换。

原理 / 图解

OWASP Secrets Management Cheat Sheet:https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html;GitHub push protection:https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning

图 1
做法 评价
写死在源码 禁止
.env 进 Git 禁止;.env 应在 .gitignore
环境变量 / 编排系统注入 常用基线
云 Secrets Manager + IAM 生产推荐
镜像层含密钥 禁止(历史层仍可被拉出)

可运行示例

示例版本与验证口径

二稿脚本使用随机令牌、恒定时间比较与临时Git仓库,默认Windows分支跳过POSIX权限效果。下方旧输出仅说明原脚本观察;新脚本运行以核验日志为准。 修订脚本见examples/35_secret_management.py。

"""凭据生命周期教学:默认只在临时目录创建假密钥与临时 Git 仓库。
哈希验证器只能核验收到的随机令牌,不能替代需取出密钥的保险库。
"""
import hashlib, hmac, os, pathlib, secrets, shutil, subprocess, sys, tempfile

FAKE = "sk-FAKE-not-a-real-key-for-demo-only"
print("== ① 环境变量注入:子进程只接收显式环境;不打印完整凭据")
env = {k:v for k,v in os.environ.items() if k.upper() in {"SYSTEMROOT", "WINDIR", "PATH", "TEMP", "TMP"}}
env["LLM_API_KEY"] = FAKE
out = subprocess.check_output([sys.executable, "-X", "utf8", "-c", "import os; print('已收到假密钥:', bool(os.environ.get('LLM_API_KEY')))"] , env=env, text=True, encoding="utf-8")
print("  ", out.strip())

with tempfile.TemporaryDirectory(prefix="k6-secret-demo-") as td:
    task = pathlib.Path(td)
    print("== ② POSIX 文件模式(Windows 不据此判断 ACL)")
    p = task / "key"; p.write_text(FAKE, encoding="utf-8")
    if os.name == "posix":
        for mode in (0o644, 0o600):
            p.chmod(mode); print("   模式:", oct(p.stat().st_mode & 0o777))
        print("   模式位演示未测试其他用户的有效访问权;ACL/root 可改变结果")
    else:
        print("   跳过 Unix 600/644 权限效果;Windows 应检查 NTFS ACL")

    print("== ③ 假密钥从工作区移除后仍留在临时 Git 历史")
    if shutil.which("git"):
        repo=task/"repo"; repo.mkdir()
        # 禁用全局/系统 Git 配置与 hooks,只操作这个新建仓库。
        git_env=env.copy(); git_env.pop("LLM_API_KEY", None)
        git_env["GIT_CONFIG_NOSYSTEM"]="1"; git_env["GIT_CONFIG_GLOBAL"]=os.devnull
        def git(*args):
            return subprocess.check_output(["git", "-c", "core.hooksPath="+os.devnull, "-c", "commit.gpgsign=false", *args], cwd=repo, env=git_env, text=True, encoding="utf-8", stderr=subprocess.STDOUT)
        git("init", "-q"); git("config", "user.email", "demo@example.invalid"); git("config", "user.name", "K6 demo")
        app=repo/"app.py"; app.write_text(f"KEY = {FAKE!r}\n", encoding="utf-8")
        git("add", "app.py"); git("commit", "-q", "-m", "demo fake secret")
        app.write_text("import os\nKEY = os.environ['LLM_API_KEY']\n", encoding="utf-8")
        git("add", "app.py"); git("commit", "-q", "-m", "remove fake secret")
        print("   当前文件含假密钥:", FAKE in app.read_text(encoding="utf-8"))
        print("   历史仍能搜到:", FAKE in git("log", "-p", "--all", "-S", FAKE))
    else:
        print("   未安装 Git:跳过历史分支")

print("== ④ 随机令牌的哈希验证器(不是可取回密钥的保险库)")
issued=secrets.token_urlsafe(32)
digest=lambda value: hashlib.sha256(value.encode()).hexdigest()
db={"svc-demo":digest(issued)}
def check(name, candidate):
    saved=db.get(name)
    return saved is not None and hmac.compare_digest(digest(candidate), saved)
print("   正确/错误/未知主体:", check("svc-demo",issued),check("svc-demo","wrong"),check("unknown",issued))
print("   出站访问第三方服务需取回原密钥,应使用受控加密存储/KMS;本例没有实现")

print("== ⑤ 双密钥窗口:用显式时钟测试,不等待")
keys={"current":secrets.token_urlsafe(32),"previous":issued,"previous_until":100}
def accept(candidate, now):
    if hmac.compare_digest(candidate,keys["current"]): return "current"
    if now < keys["previous_until"] and hmac.compare_digest(candidate,keys["previous"]): return "previous-grace"
    return "reject"
print("   新密钥:",accept(keys["current"],99),"旧密钥宽限内:",accept(issued,99),"截止时:",accept(issued,100))
print("   若旧密钥已泄露,应立即吊销,不能继续给予宽限窗口")

一稿留存输出(原环境记录,非本次复跑结果):

== ① 环境变量注入(进程级),不要写进代码或镜像
   子进程读到: sk-FAKE… len 36
== ② 文件权限:600 vs 644
   644 权限: 0o644 其他人可读
   600 权限: 0o600 仅属主
== ③ git 已跟踪密钥:即使删文件,历史仍在
   当前工作区还有明文: False
   git log -S 仍能搜到历史提交: True (必须轮换密钥,不能只改文件)
== ④ 简单密钥保险库:只存哈希,比对用 compare
   正确密钥: True
   错误密钥: False
   库内无明文: 2f75be345056124f…
== ⑤ 轮换:双密钥窗口
   新密钥: current / 宽限期内旧密钥: previous-grace
   宽限期后旧密钥: reject
  • ① 子进程通过环境变量读到密钥(演示注入方式);代码里只有假值。
  • ② 644 其他人可读;600 仅属主——POSIX可用0600或更严格模式并核对ACL与父目录;Windows需检查NTFS ACL。
  • ③ 提交后再改掉明文,git log -S sk-FAKE 仍然命中历史;正确处置是吊销 + 轮换,而不是只改工作区文件。
  • ④ 二稿将此改为入站随机令牌的哈希验证器;它不能取回第三方API密钥,不是保险库。
  • ⑤ 双密钥窗口:新密钥立即生效,旧密钥在宽限期内仍可用,过期后 reject,避免轮换时服务中断。

常见误区

  • “私有仓库就安全”:协作者、CI 日志、将来转公开都会暴露。
  • “K8s Secret 是加密的”:默认不是,见 k6.ops.kubernetes。
  • “轮换太麻烦,一年一次”:按泄露风险与平台建议周期;怀疑泄露立即轮换。

与 AI 开发的关系

  • 浏览器与移动端不应持有服务端长期模型厂商密钥;若平台提供受限短时客户端凭据,则按其明确协议使用;由服务端持有并签发短时用户令牌。
  • Agent 的工具凭据按工具独立最小权限,勿共用一把“万能 Key”。

二稿示例解读补充

旧输出中的“库内无明文”只说明保存了摘要,不能证明已实现秘密存储、访问审计或加密取回。正常轮换的宽限窗口也不可用于已经确认泄露的凭据。

自测与答案

题目: 把第三方API密钥哈希后丢掉明文,服务还能继续调用该API吗?

答案: 通常不能。第三方要求收到原凭据,哈希不能还原;应在受控秘密存储中保护可取回凭据。若是自己签发的入站随机令牌,则可仅存摘要并验证调用者出示的值。

核验来源与对应结论

未验证与后续检查

  • 真实KMS/Vault/云Secret Manager未运行;Windows未验证POSIX权限效果。
  • 文中一稿具体版本、耗时、IP、PID与生成文本均非普遍保证;需要复现时同时记录平台、依赖、输入和本次日志。

本次示例运行范围

2026-10-15:部分通过。环境变量与临时Git泄露扫描通过;Windows未执行POSIX权限/umask段。

查看本次日志。

“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。

配套代码与核验资料

继续浏览基础 返回知识 →返回顶部 ↑
本篇目录
教程图解100%
教程图解