You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

AzureAD应用注册授权最佳方式:单AD组场景用角色还是组声明?

问题解答

一、用户权限验证的两种可行方案

1. 直接验证AD组(匹配业务需求的最优解)

你认为直接验证用户是否属于目标AD组更合理是完全正确的,这是最贴合“仅对特定AD组开放”这个业务规则的方式。之前没拿到组声明,大概率是配置环节有遗漏,核心排查点:

  • 进入Azure AD应用注册的令牌配置 -> 可选声明,勾选groups声明,并选择对应的令牌类型(SPA场景下,ID令牌里的组声明更适合前端直接验证)。
  • 切换到企业应用找到你的应用,进入“属性”页面,找到“组声明”选项,设置为“安全组”(或根据需要选“安全组和通讯组”),如果只需要目标组,还可以设置筛选规则限定返回的组。
  • 注意:默认返回的组是GUID格式,若需要组名称,可在可选声明中添加display_name作为组的附加声明;如果用户所属组数量超过150个,令牌里不会返回所有组,这种情况要调用Microsoft Graph的/me/memberOf接口获取完整组列表。

2. 使用应用角色(开发与扩展更灵活)

你当前采用的“给AD组分配应用角色”的方式,在开发阶段和未来扩展多角色场景时优势明显——比如后续新增“编辑者”“访客”等权限,只需在应用注册里添加角色再分配给对应组,不用修改前端的权限判断逻辑。这种方式的核心是解耦了AD组结构和应用权限体系,即使AD组调整,只要角色分配对应上,应用代码无需改动。

二、组声明获取失败的具体排查步骤

  1. 确认应用注册的令牌配置中已添加groups可选声明,且勾选了ID Token(前端用)或Access Token(调用API用)。
  2. 在企业应用的应用“属性”页,确认“组声明”已设置为正确的组类型(如安全组),且目标组已在“用户和组”中完成分配。
  3. 清除浏览器缓存、注销后重新登录,用jwt.ms解码ID Token/Access Token,检查是否包含groups字段。
  4. 若仍无groups字段,检查用户所属组数量是否超过150个——超过阈值的话,令牌不会返回组列表,需调用Graph API的/me/memberOf接口获取,此时需要给应用添加User.Read.All的委托权限(需管理员同意)。

三、未来接入后端API的权限验证建议

前端的权限验证仅能做体验优化,真正的安全验证必须放在后端API层面,因为前端的声明可被篡改:

  • 方案一:API接收前端传来的Access Token,解码后验证groups或roles声明,判断用户是否具备访问权限。
  • 方案二:API主动调用Microsoft Graph的/me/memberOf或/me/appRoleAssignments接口,获取用户的组或角色信息后再做验证。
  • 注意:API需配置对应权限,比如调用memberOf接口,服务端场景用Directory.Read.All应用权限,前端转API场景用User.Read.All委托权限,均需管理员同意。

四、权限范围与配置项检查

目前你仅配置了User.Read权限,满足基础认证需求,但要获取组信息需补充:

  • 前端直接调用Graph获取组:添加User.Read.All委托权限(需管理员同意)。
  • 后端API调用Graph获取组:添加Directory.Read.All应用权限(需管理员同意)。
  • 另外,确认应用注册的身份验证页面中,SPA的重定向URI配置正确,且已启用“ID令牌”和“访问令牌”(授权码流必须依赖这两种令牌)。

内容的提问来源于stack exchange,提问作者J-man

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.24 16:06:28