二稿核验说明(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
| 做法 | 评价 |
|---|---|
| 写死在源码 | 禁止 |
.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段。
“一稿留存输出”保留原字,不是二稿代码新生成的结果;其原结论须结合二稿修订与边界阅读。
配套代码与核验资料