You need to enable JavaScript to run this app. 如何通过Graph API仅获取集合内应用的名称、图标及链接信息
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Graph API仅获取集合内应用的名称、图标及链接信息

基于Microsoft Graph API 筛选特定集合下目标用户所属应用的实现方法

前置准备

  • 权限配置:调用applications端点需根据调用模式授予对应读取权限:
    • 委托模式(用户身份调用):需申请Application.Read.All或Directory.Read.All委托权限
    • 应用模式(服务身份调用):需申请对应类型的应用权限
  • 筛选所有者的必带配置:如果需要按应用所有者(owners)做条件筛选,必须额外添加两项配置,否则会触发接口报错:
    • 请求头新增ConsistencyLevel: eventual
    • 查询参数新增$count=true

通用返回字段配置

需在请求中通过$select参数指定目标返回字段,避免拉取冗余数据,对应关系如下:

  • 应用名称:displayName
  • 跳转链接:web/homePageUrl(即应用配置的主页跳转地址)
  • 应用图标:logo(返回图片二进制流),也可通过单独调用应用ID对应的logo端点获取
  • 关联标识:id、appId,用于和其他接口的返回数据做关联
    示例$select参数值:$select=displayName,web/homePageUrl,logo,id,appId

不同集合场景的筛选逻辑

由于“应用所属集合”在Microsoft Entra ID(原Azure AD)体系中没有全局统一的原生字段,需匹配对应集合的实际归类方式选择筛选方案,常见三类场景如下:

场景1:集合为应用配置了自定义目录扩展标识

如果目标集合是通过给应用注册添加自定义扩展属性/标签完成归类,可直接在$filter参数中叠加条件筛选,无需多次调用接口。
筛选逻辑:先限定所有者为目标用户,再匹配自定义扩展属性值为目标集合标识。
示例完整请求参数:

https://graph.microsoft.com/v1.0/applications?$select=displayName,web/homePageUrl,logo,id,appId&$filter=owners/$id eq '目标用户的Entra对象ID' and extension_xxxxxx_自定义扩展属性名 eq '目标集合的标识值'&$count=true

注:extension_xxxxxx_自定义扩展属性名需替换为实际创建目录扩展时生成的完整属性名(包含扩展应用的唯一ID前缀)。

场景2:集合为关联了应用的特定安全组/Microsoft 365组

由于组和应用的关联关系绑定在应用对应的**服务主体(Enterprise Application)**上,而非应用注册本身,因此需要分两步完成筛选:

  1. 先调用组的成员接口,获取该组下所有服务主体对应的appId列表:
    https://graph.microsoft.com/v1.0/groups/目标组的Entra对象ID/members/microsoft.graph.servicePrincipal?$select=appId
    
  2. 拿到所有appId后,回到applications端点,筛选所有者为目标用户且appId在上述列表中的应用,筛选条件示例:
    $filter=owners/$id eq '目标用户的Entra对象ID' and appId in ('第一个appId','第二个appId',...)&$count=true

注:如果组内关联应用过多,需要对组成员接口做分页拉取,同时注意in语句的长度限制,过大的列表可拆分为多次查询。

场景3:集合为Entra管理中心配置的自定义应用分类

该分类规则绑定在服务主体的tags属性上,同样需要分两步完成筛选:

  1. 先调用服务主体接口,筛选带有目标分类标签的服务主体,获取对应的appId列表:
    https://graph.microsoft.com/v1.0/servicePrincipals?$filter=tags/any(t:t eq '目标集合的标签值')&$select=appId
    
  2. 回到applications端点,和场景2的第二步逻辑一致,叠加所有者和appId列表的筛选条件即可。

注意事项

  • 应用数据量较大时,可通过$top参数指定单页返回数量(最大999),后续通过返回结果中的@odata.nextLink字段做分页拉取
  • 应用图标二进制流可根据业务需求转成Base64或存储为本地文件,无需每次重复调用logo接口
  • 所有筛选条件需严格遵守Graph API语法规范,字符串类型的匹配值需要用单引号包裹,多条件用and连接

内容的提问来源于stack exchange,提问作者Mario De Carli

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 11:36:03