大模型应用开发 / 系统课时
配置模型凭证
配置模型凭证
这一节解决“密钥放在哪里、应用怎么拿到、怎样验证又不泄露”的问题。完成后,你会把访问凭证留在代码之外,并能用环境变量或生产密钥管理服务安全地注入运行进程。
学习目标
- 用环境变量向本地进程注入模型访问凭证
- 验证凭证已加载,同时避免把密钥打印到终端或日志
- 知道生产环境何时应改用密钥管理服务
把密钥放进运行环境
不要把 API Key 写进源码、配置样例或仓库提交记录。下面以 Bash 为例,交互式读取密钥时关闭终端回显,再把它导出为当前 Shell 及其子进程可见的 OPENAI_API_KEY。
bash
read -s -p "OPENAI_API_KEY: " OPENAI_API_KEY
echo
export OPENAI_API_KEY
python - <<'PY'
import os
key = os.getenv("OPENAI_API_KEY")
if not key:
raise SystemExit("OPENAI_API_KEY is missing")
print(f"credential loaded: yes, length={len(key)}")
PY预期输出
text
credential loaded: yes, length=<VALUE><VALUE> 是密钥长度,实际数字会因凭证格式而不同。验证时只检查“是否存在、格式是否合理”,不要输出密钥正文。
让应用读取而不是保存密钥
应用启动后应从进程环境读取 OPENAI_API_KEY,并在缺失时直接失败,而不是退回到硬编码默认值。这样开发、测试和生产可以使用同一份代码,只改变部署环境中的凭证来源。
本地开发若使用 .env 文件,也应把它加入忽略规则并限制文件权限;共享仓库只提交 .env.example 这类不含真实密钥的模板。
生产环境交给密钥管理服务
生产环境更适合让云平台、容器编排系统或专用密钥管理服务保存凭证,再在进程启动时注入环境变量或挂载为受控 Secret。应用只负责读取,不负责把真实密钥长期落盘。
密钥轮换时先创建新凭证并更新运行环境,确认新实例调用正常后再撤销旧凭证。若怀疑泄露,应直接吊销并重新签发,而不是仅修改代码中的字符串。
凭证失败时怎么查
遇到“明明配置了却读取不到”,先确认运行应用的进程是否继承了目标环境变量,再确认变量名没有拼错,最后检查 IDE、容器或服务管理器是否使用了另一套启动环境。若认证请求仍失败,再核对密钥是否已失效、被撤销或没有目标项目权限。
安全配置的关键不是“把密钥藏得更深”,而是让密钥始终脱离源码与普通日志,并把读取、轮换和撤销都放在可控的运行环境中。
按自己的节奏,确认真正理解。