You need to enable JavaScript to run this app. Azure AD未请求offline_access仍返回refresh_token的原因与规避方法
优惠活动
大模型
产品
解决方案
定价
更多

Azure AD未请求offline_access仍返回refresh_token的原因与规避方法

单页应用对接Azure AD授权时意外返回refresh_token的排查与调整

问题场景

开发SPA应用对接Azure AD OAuth2 PKCE授权流程时,出现了不符合预期的结果:

  • 授权请求阶段,没有在scope参数中主动申请offline_access权限
  • Azure AD应用注册后台的显式配置权限列表中,也没有添加offline_access委托权限
  • 但全授权流程走完后,接口响应的报文中仍然携带了refresh_token字段
  • 安全风险提示:SPA运行在浏览器客户端环境,refresh_token长期存储存在较高的泄露风险,需要从授权流程的源头阻断该字段的返回

当前已验证的配置细节

  • 实际发出的授权请求URL(未主动携带offline_access申请):
    https://login.microsoftonline.com/........./oauth2/v2.0/authorize?client_id=........&redirect_uri=........&response_type=code&scope=openid%20profile%20email%20User.Read&state=......&code_challenge=........&code_challenge_method=S256&response_mode=query
  • Azure AD后台权限配置页:显式配置的委托权限列表中不存在offline_access项
  • 用户授权同意页:仍然向用户展示了“授予离线访问权限”的提示内容
  • 授权最终返回结果:响应报文中实际包含refresh_token字段

触发该现象的本质原因

Azure AD的V2.0授权端点存在内置的默认权限逻辑:只要应用在注册时,把当前使用的重定向URI归类为“单页应用”类型,系统会自动将offline_access权限纳入该应用授权流程的可用权限范围。这个逻辑不需要在后台手动添加对应权限配置,也不需要在授权请求的scope参数里显式申请,系统就会默认在符合条件的流程中下发refresh_token,甚至会在用户授权同意页自动展示对应的离线访问权限提示。
这也是你观察到所有异常现象的核心原因。

可落地的调整操作

  • 方案1(从源头阻断,效果最彻底):修改Azure AD应用注册的身份验证配置
    进入应用注册的「身份验证」板块,找到当前SPA使用的重定向URI条目,把原本标记为「单页应用」类型的URI,调整为「Web」类型。
    修改完成后,系统的隐式权限逻辑就会失效:后续授权流程中,只有当你在授权请求的scope参数里显式带上offline_access,接口才会返回refresh_token;否则哪怕走完整的PKCE授权码流程,也不会下发refresh_token。
  • 方案2(不修改重定向类型的替代方案):换token时显式指定需要的权限范围
    如果因为配置兼容问题,必须保留重定向URI的「单页应用」类型,那么在拿到授权码向token端点换取访问令牌时,不要直接透传授权阶段返回的scope值,显式在请求里传入实际需要的scope集合(比如openid profile User.Read),不要把系统隐式带上的offline_access传递给token接口,接口就不会返回refresh_token。
  • 方案3(兜底防护):客户端响应拦截
    如果调整配置后流程仍然异常返回refresh_token,在前端代码层面对授权响应做拦截,检测到报文中的refresh_token字段时直接丢弃,不要将其写入浏览器的本地存储介质,从存储层面避免泄露风险。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.01 06:54:02