AI 严选AIAICN / API FIELD GUIDE费用工作台 →
FIELD NOTES / 安全实践

API Key 应该放在哪里?一份上线前检查表

凭据只留在受控服务端,公开仓库与浏览器都不是保险箱。

AI 严选 · 编辑整理(AI 辅助) · 资料核对

浏览器里的秘密并不秘密

前端打包后的代码、网络请求和浏览器存储都可能被访问者看到。不要把服务商 Key 写入公开网页、URL 查询参数、截图或 GitHub 仓库。即使把变量命名为 SECRET,也不会自动保护它。本站是资料静态站,不提供 Key 输入框,也不替访客请求模型。

用受控服务端隔离凭据

实际应用应从服务端环境配置或专用秘密管理系统读取凭据,并对访问你服务端的用户做认证与限流。把开发和生产 Key 分开;能够限制模型、权限、额度时按最小需求配置。前端只拿业务所需结果,不拿服务商凭据。环境变量不是万能保险箱,同样需要限制日志、进程访问和部署权限。

准备一个泄露响应流程

立即撤销受影响 Key,再创建权限更小的新 Key。检查账单、访问日志和异常调用时间,更新所有使用旧 Key 的应用。只删除 Git 最新版本里的文本不足以消除历史副本;公开过的 Key 必须视为泄露,不能继续使用。不要把新 Key 再贴进处理事故的工单。

交付前逐项确认

检查 .env、构建输出、日志和源码历史;验证前端网络请求不含服务商凭据;核对重试和预算限制;确认运维人员知道如何撤销 Key。文档示例使用占位符,测试使用合成内容。需要协作时共享权限或专用测试凭据,不共享生产密钥。

来源与适用边界

2026-10-21 阅读下列官方资料。操作步骤为本站编辑归纳,代码与数字为本地合成示例;未调用付费模型,不是服务商实测报告,也不构成接口或性能承诺。

  1. https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html