凭据存储的底线:加密、掩码与不落日志
网关会把散落在各处的上游凭据集中管理,这是它的价值所在,也是它的风险敞口所在。凭据库基本等于上游资产的完整清单。
加密存储是硬性要求
上游 Key 用 AES-GCM 之类的机制加密落库,密钥来自环境变量而不是代码或配置文件。而且同一个部署必须一直用同一个密钥——每次启动重新生成会导致旧数据全部解不开。
订单结算、额度增加、Key 发放必须在同一个事务里完成,并且要有幂等约束。
游客购买不应该要求注册账号,但也不能因此放弃安全。
后台永远不返回明文
渠道详情、编辑表单、导出功能,一律掩码。编辑时留空表示保留原值,填写新值才替换。这个设计同时避免了「打开详情页就把密钥抄走」的可能。
浏览器返回地址和前端轮询都不能直接标记支付成功,只有验签通过且金额、状态都对得上才算。
日志里的完整 Key 是最常见的泄露源
异常堆栈、请求体 dump、调试日志——都可能在你不注意的时候把完整凭据写进日志系统。而日志系统的访问范围通常远大于数据库。
所以完整 Key 应该尽量一次性展示、用完即弃,最多缓存极短时间。
真实 token、密码、私钥、支付凭据、完整请求正文,都不应该出现在日志、测试、文档或截图里。
密钥本身要能轮换
支持在后台替换上游凭据并验证通过后再撤销旧凭据,是一条必须有的运维路径。没有轮换能力,泄露之后只能全线更换。
而且权限检查必须落在后端:隐藏菜单不能替代授权,列表、详情、聚合、更新、删除每一条路径都要单独检查作用域。
实操:先查模型列表,确认你的 Key 到底能访问哪些模型。
验证凭据是否有效,最快的方式就是查一次模型列表。
curl "https://aiminis.info/v1/models" \
-H "Authorization: Bearer sk-gw-你的密钥"
# 返回里每项都带上所属平台、支持的能力和是否在售,
# 写代码前先对着这份列表确认模型 ID,别抄文档里的旧名字。
几个容易踩的坑
- 把完整 Key 长期存进 localStorage,页面里任何脚本都能读到。
- 用浏览器返回地址或前端轮询来确认支付成功。
- 游客订单的恢复凭证放在 URL 查询参数里,被写进访问日志和 Referer。
- 权限只在前端菜单里做了隐藏,后端接口没做作用域检查。
小结
网关这层看不见,但它的每一次选择都在影响你的延迟、成本和成功率,值得花点时间打磨。
文中的配置和示例都能在 https://aiminis.info/ 直接跑一遍,接入文档在 https://aiminis.info/docs/api-integration。
- 点赞
- 收藏
- 关注作者
评论(0)