You need to enable JavaScript to run this app. Azure Cosmos DB主令牌有效期及使用规则咨询
优惠活动
大模型
产品
解决方案
定价
更多

Azure Cosmos DB主令牌有效期及使用规则咨询

Azure Cosmos DB 直接HTTP对接的Master凭证常见认知澄清

你碰到的15分钟失效,根本不是Master密钥本身的问题

很多新手刚接Cosmos DB REST API都会遇到这个坑:手里存的主密钥明明没换,怎么每隔15分钟就返回401未授权?
这和主密钥本身的有效期没有任何关系:

  • Cosmos DB的Master主/从密钥本身是内置永久有效的,不存在默认的15分钟过期时间——除非你主动在Azure侧手动轮换、禁用某把密钥,否则它可以一直用
  • 所谓的15分钟超时,是API本身的两层安全校验规则卡的结果:
    1. 所有REST请求必须携带x-ms-date请求头标注发请求的UTC时间,服务器会校验这个时间和当前服务端时间的偏差,只要超过15分钟,直接拒绝请求
    2. 如果你照搬第三方教程构造Authorization签名的时候,不小心在签名字符串里加了自定义的过期时间参数,那这个生成的临时签名本身才会到点失效——不少教程默认带了15分钟的过期参数,才会让新手误以为主密钥本身15分钟就过期

按照官方的Master密钥签名构造规则:标准的签名格式为type=master&ver=1.0&sig={主密钥计算出的HMAC值},这个格式生成的合法签名只要满足时间偏差要求,没有内置过期限制。


两个核心疑问的明确结论

关于Master密钥能不能长期用于业务对接,是不是必须搭Resource Token中间件

  • 完全不需要为了“长期有效”专门部署Resource Token中间件:如果你的场景是后端受信服务自己调用Cosmos DB,没有给终端前端、第三方用户开放直接访问权限的需求,只要每次发请求的时候,实时用主密钥计算对应时间的合法签名,保证x-ms-date是当前真实UTC时间,主密钥本身永不过期,可以长期稳定支撑业务运行
  • 只有当你需要给终端用户分配细粒度、限时、权限边界严格的访问权限时,才需要用Resource Token(比如给每个终端用户只开放自己个人分区的读权限,权限1小时自动过期)——这种场景下才需要部署一个受信的中间件,用主密钥生成对应权限的Resource Token分发给终端,避免把全库最高权限的主密钥暴露到不可信的客户端侧
  • 你之前判断需要Resource Token才能适配长期运行,本质是把“临时签名的时间校验限制”和“主密钥本身的有效期”搞混了。

关于Master密钥是不是只能用于测试场景

  • 根本不是:Master密钥的标准生产级使用方式,就是受信的后端服务持有主密钥,每次调用API时在服务端动态计算合法签名
  • 大家常说的“Master密钥不能随便用”,本质是因为它是全库最高权限凭证,拥有读写全部数据、修改数据库配置的能力,绝对不能把主密钥硬编码到前端代码、公开代码仓库、客户端本地配置里——只要主密钥存放在后端受信的配置管理、密钥管理服务里,它本身是完全合规的生产凭证
  • 你之前碰到的“只能用15分钟”的糟糕体验,本质是Postman调试时把一个算好的固定签名、对应的旧时间戳存在环境变量里当长期凭证用——过了15分钟服务端校验时间差不满足要求,自然就拒绝了,这和生产环境里每次动态算实时签名的使用方式没有任何关系。

当前开发阶段的实操建议

  • Postman调试时:每次发请求前重新生成匹配当前UTC时间的合法签名,把新的时间戳填到x-ms-date请求头里,不需要15分钟就换一次主密钥
  • 后端代码对接时:不要在代码里硬编码固定的预生成签名,严格按照签名算法逻辑,每次发请求前实时计算HMAC值、塞入当前实时时间戳,主密钥存放到受信的密钥管理服务中,即可实现长期稳定调用,不需要额外搭建Resource Token服务
  • 生产安全兜底:可以按照内部安全规范,每3-6个月定期轮换一次主从密钥,降低密钥泄露风险——这是通用的凭证管理要求,不是因为主密钥本身会过期。

内容的提问来源于stack exchange,提问作者markokstate

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.19 11:15:07