AI API 密钥应该放在哪里?
把凭据从浏览器、代码仓库和日常日志中移开,降低意外泄露的影响。

浏览器不是密钥保险箱
写进前端代码的密钥,加载应用的人都可能看到;即使它来自构建时环境变量也一样。把有权限的 API 凭据保存在你控制的服务器。浏览器调用经过身份验证的后端,由后端检查用户权限后再发起上游请求。
画出一次请求的路径:用户浏览器访问你的后端,后端读取密钥并向 API 发起请求,再把需要的结果返回浏览器。密钥不应进入 HTML、前端脚本、移动端公开配置或带有查询参数的链接。即使使用 HTTPS,接收代码的一方仍可能读取其中的值;传输加密不能把公开客户端变成秘密存储。
为不同环境使用独立密钥
开发和生产应使用不同凭据;平台支持时,也可以按应用或团队分开。将密钥放在环境配置或专用密钥管理服务中,不要提交到仓库,也不要粘贴到公开问题里。只赋予工作负载实际需要的权限和额度。
开发、测试和生产尽量使用不同的密钥;条件允许时,再按应用或团队划分。这样某一把密钥泄露时,可以更快确定影响范围并单独撤销。使用平台支持的权限、额度和访问限制,避免一把高权限密钥被多个无关服务长期共用。记录密钥的负责人和用途,但不要在登记表中保存明文。
保护 API 密钥,并让它与公开的应用代码分开。让意外泄露可以恢复
密钥一旦出现在截图、日志或公开提交中,就应视为已经泄露:撤销或轮换密钥、部署替换值,并检查相关使用记录。只从最新一次提交中删掉文本并不够,因为旧值可能仍在历史记录里。事先明确谁负责轮换以及如何联系。
发生泄露时,先限制或撤销受影响密钥,创建并部署替代凭据,再检查相关用量和访问记录。提前演练密钥替换能减少事故中的慌乱;但不要把新密钥写入聊天、工单或截图。若某个服务无法立即切换,明确责任人和过渡步骤,并持续监控,直到旧凭据不再被使用。
别忽略周边环节
从日志、错误报告和支持消息中移除授权头与凭据;检查代理配置、CI 输出以及第三方集成。简短且真正会用的处置步骤,加上定期检查访问权限,通常比无人维护的长篇制度更有帮助。具体控制能力请以平台最新文档为准。
除了源码,还要检查构建产物、CI 输出、错误监控、代理日志和截图。授权头、完整请求体及环境变量可能在排障时被意外打印。为日志做脱敏,并只保留定位问题所需的信息;对外求助时提供请求标识、时间和脱敏错误即可。发现敏感信息已进入公开仓库时,也要考虑历史提交和缓存副本。
人员、应用和部署环境会变化,曾经合理的访问权限也可能过期。定期检查不再使用的密钥、过大的权限范围和异常用量,并及时撤销无需保留的访问。具体限制能力以平台实际提供的设置为准。密钥安全也依赖账户登录保护、服务器权限和依赖管理,单靠隐藏字符串不能解决所有问题。
先找到密钥可能出现的位置
检查代码仓库、部署配置、持续集成日志、工单、截图和浏览器开发者工具。前端构建工具中的环境变量并不自动保密:只要变量被打包进发送给浏览器的代码,访问页面的人就可能看到它。移动应用和桌面客户端也可能被反编译,因此不适合长期保存可以代表服务端调用的高权限密钥。
更稳妥的方式是让客户端访问自己的后端,由后端完成用户身份检查、输入校验和额度控制,再从环境变量或密钥管理服务读取凭据。密钥不应出现在网址查询参数里,因为网址可能被代理、浏览器历史或监控系统记录。错误信息也应避免回显请求头。
开发、测试和生产尽可能使用各自的凭据,按实际可用能力限制权限、额度和有效期。这样一个环境出问题时,更容易判断影响范围并单独处理。团队成员离开、项目下线或凭据用途改变时,也应及时检查是否仍然需要这些访问权限。
准备一次可执行的轮换流程
先确认谁能创建和停用密钥、应用从哪里读取它、哪些服务依赖它。生成替代凭据后,通过安全的配置渠道更新服务,验证新凭据能够完成一条最小请求,再按实际平台提供的机制停用旧凭据。不要把新旧密钥同时粘贴到群聊或工单里,也不要在日志中打印完整值。
如果密钥已经公开,不要先花很久寻找责任人。优先限制或停用受影响凭据,检查可疑用量,并更新依赖它的服务。随后再确定泄露入口,例如公开提交、调试截图或错误的构建配置。单纯删除仓库中的一行通常不足以让已泄露的凭据失效,因为历史记录或缓存可能仍然存在。
演练时可以使用专门的测试凭据,确认监控、通知和配置更新确实有效。把步骤写成团队可执行的记录,但不要把真实密钥写进去。具体停用顺序要考虑平台是否允许凭据重叠、服务是否支持无中断切换,以及当前事件的风险程度。
让保护措施适应日常工作
为不同用途创建容易识别的凭据名称,并指定负责人。只在需要的运行环境提供密钥,定期清理不再使用的配置。代码审查和自动扫描可以帮助发现误提交,但扫描不能替代最小权限和轮换;出现告警后应核实并处理,而不是简单忽略。
监控侧关注与业务相符的异常,例如不寻常的用量增长、未知来源或持续的认证失败。告警信息可以包含凭据的非敏感标识、时间和错误类别,但不能包含完整密钥。查看日志时也要遵守实际的数据访问权限,避免把安全工具变成新的泄露来源。
一个简单的上线检查是:在构建后的前端文件、示例配置和截图中搜索凭据前缀;验证失效密钥无法继续调用;确认负责人知道如何轮换。检查结果应和部署日期一起记录。安全不是一次性勾选,而是一套能在人员和服务变化后继续执行的日常习惯。
如果第三方服务需要访问你的系统,优先为它准备独立凭据,并确认服务结束后如何撤销。不要因为一个集成方便,就把生产环境的通用密钥复制到多个无法审计的位置;权限范围越清楚,排查和轮换越容易。
上线前做一次小检查
发布前检查前端产物和仓库历史中是否意外包含凭据,确认生产环境使用独立密钥,再从后端发送一次小请求。检查错误报告是否隐藏授权头。如果密钥已经泄露,应先轮换并检查使用情况,不能只删掉看得见的文字。
为每套服务明确谁可以创建和撤销密钥、谁负责部署更新、谁检查异常使用。权限交接时同步更新记录并移除不再需要的访问。演练时只使用测试凭据,避免把真实生产密钥复制到演示文档;负责人变更后,也要确认紧急联系渠道仍然有效。