凭据存储的底线:加密、掩码与不落日志

举报
Rolle 发表于 2026/11/15 18:09:17 2026/11/15
【摘要】 网关会把散落在各处的上游凭据集中管理,这是它的价值所在,也是它的风险敞口所在。凭据库基本等于上游资产的完整清单。

网关会把散落在各处的上游凭据集中管理,这是它的价值所在,也是它的风险敞口所在。凭据库基本等于上游资产的完整清单。

加密存储是硬性要求

上游 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。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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