查询凭证和完整 API Key:为什么它们不该是同一个东西

举报
Rolle 发表于 2026/11/15 18:09:47 2026/11/15
【摘要】 把完整 API Key 直接交给前端去查用量,是一个非常常见、也非常容易出事的设计。查询凭证和完整 Key 的价值完全不对等,凭据就该分层。

把完整 API Key 直接交给前端去查用量,是一个非常常见、也非常容易出事的设计。查询凭证和完整 Key 的价值完全不对等,凭据就该分层。

两把凭据,两种权限

完整 API Key 能调用模型(花钱),查询凭证只能查看用量(不花钱)。把后者泄漏出去,最坏结果是信息泄露,而不是账单失控。

两者的价值不对等,凭据就该按这个分层来设计。

真实 token、密码、私钥、支付凭据、完整请求正文,都不应该出现在日志、测试、文档或截图里。

前端只该拿低敏感度的凭据

查询凭证可以缓存在浏览器 Cookie 里(甚至可以设个 180 天的过期),完整 Key 则应该一次性展示、用完即弃。

所以完整 Key 应该尽量一次性展示、用完即弃,最多缓存极短时间。

查询凭证倒是可以缓存——它本来就是低敏感度的设计。

查询凭证的权限边界要清晰

它只能查看用量,不能调用模型、不能修改配置、不能查看其他 Key。接口层面就要卡死,不能只靠前端不调用。

如果没有 Key 级限流,一个写错循环的脚本就能把共享池子的额度全部吃掉,其他用户跟着受影响。

网关的用量查询页应该一次性回答这三个问题,而不是让用户提工单。

缓存最近的若干张卡是有用的

本地保存最近使用的 10 张卡密方便下次直接查看,但保存时要明确告诉用户「清 Cookie 或换浏览器后需要重新添加」。

模型 ID 不要从文档里抄,要用你的 Key 实际查一次 /v1/models 拿到真实可用的那个。

实操:按 Key 分组隔离资源的思路在配置侧是什么样。

查询凭证的形态:一个 10 位、区分大小写的字符串。

# 分组决定了一个 Key 能看到哪些渠道。
# 三种状态的语义完全不同:

#   未绑定分组  →  所有「启用 + 公开」分组里的渠道
#   绑定公开分组 →  仅该组渠道
#   绑定专属分组 →  仅该组渠道(组停用/为空 → 直接拒绝,不回退)

# 配置专属渠道的顺序有讲究:
#   1. 新建分组,类型设为「专属分组」,加入目标渠道
#   2. 把这些渠道从所有公开分组里移除
#      (只要还挂在任何公开分组,未绑定的 Key 就仍能用它)
#   3. 创建 Key 时选择该分组并保存
#   4. 之后要恢复,解除 Key 绑定即可回到公开池

几个容易踩的坑

  • 把完整 Key 长期存进 localStorage,页面里任何脚本都能读到。
  • 用浏览器返回地址或前端轮询来确认支付成功。
  • 游客订单的恢复凭证放在 URL 查询参数里,被写进访问日志和 Referer。
  • 权限只在前端菜单里做了隐藏,后端接口没做作用域检查。

小结

先跑通最小请求,再逐项加功能——这是接入任何网关都适用的节奏。

上面提到的能力基本都来自 https://aiminis.info/ 这个自建的 API 网关,支持 OpenAI 与 Anthropic 双协议接入,还有公开的模型健康看板 https://aiminis.info/model-health 可以先看看状态。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。