排错与安全
Key 安全与最佳实践
Key 就是钱:怎么保管、怎么限权、泄露了怎么办。
约 6 分钟适合:所有拿到 Key 的用户
开始之前
- 至少有一把 Key
步骤 1 · STEP 0x01
正确保管 Key
terminal
$ export API_KEY=<你的 Key>$ echo ".env" >> .gitignore
- 放进环境变量或密码管理器,不要写进代码。
- 不要提交到 git,尤其是公开仓库;
.env文件要加进.gitignore。 - 不要放进网页前端、手机 App 里的代码,任何人都能从里面读出来。
- 不要发在聊天群、工单、截图里。
很多泄露来自「临时贴一下」:把配置贴到论坛求助时,先把 Key 换成占位符。
步骤 2 · STEP 0x02
一个用途一把 Key,并限权
API Key → 编辑
1
预算(USD)
设月度上限
2
模型白名单
只放这个用途需要的模型
3
IP 白名单
固定出口的服务器填 IP
4
过期日期
临时给别人的 Key 设到期日
5
保存
这样即使某把 Key 泄露,损失也被限制在它自己的预算内,吊销时也不影响别的软件。
步骤 3 · STEP 0x03
打开提醒,定期检查
设置 → 邮件通知
1
余额不足提醒
开
2
Key 异常用量提醒
开
3
充值到账通知
开
4
保存
- 每周看一眼「用量」页,有没有你不认识的模型或时间段。
- 在「API Key」页看「最近使用」,长期不用的 Key 直接吊销。
- 定期修改登录密码;改密码后其他设备会被退出登录。
步骤 4 · STEP 0x04
怀疑泄露时按这个顺序做
API Key
1
吊销
2
创建 Key
- 1. 立刻吊销那把 Key。吊销后用它的请求会马上失败。
- 2. 创建新 Key,更新到你的软件里。
- 3. 到「用量」页查看泄露期间有没有陌生请求,有疑问的扣费提交工单(计费申诉,30 天内)。
- 4. 找到泄露的来源(仓库、聊天记录、截图)并清理。
如果泄露的是账号密码,请立刻修改密码,并在工单里说明。
✓ 怎么确认成功了
- 每把 Key 都有名字、预算和合适的限制;你知道泄露后第一步是吊销。
常见问题
分享页会泄露 Key 吗?
不会,分享页不含 Key,只含接入方式。Key 需要你另外发给对方。
可以几个人共用一把 Key 吗?
不建议。每人一把,谁出问题只吊销谁的,也便于看清谁用了多少。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。