如何通过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)**上,而非应用注册本身,因此需要分两步完成筛选:
- 先调用组的成员接口,获取该组下所有服务主体对应的
appId列表:https://graph.microsoft.com/v1.0/groups/目标组的Entra对象ID/members/microsoft.graph.servicePrincipal?$select=appId - 拿到所有
appId后,回到applications端点,筛选所有者为目标用户且appId在上述列表中的应用,筛选条件示例:$filter=owners/$id eq '目标用户的Entra对象ID' and appId in ('第一个appId','第二个appId',...)&$count=true
注:如果组内关联应用过多,需要对组成员接口做分页拉取,同时注意
in语句的长度限制,过大的列表可拆分为多次查询。
场景3:集合为Entra管理中心配置的自定义应用分类
该分类规则绑定在服务主体的tags属性上,同样需要分两步完成筛选:
- 先调用服务主体接口,筛选带有目标分类标签的服务主体,获取对应的
appId列表:https://graph.microsoft.com/v1.0/servicePrincipals?$filter=tags/any(t:t eq '目标集合的标签值')&$select=appId - 回到
applications端点,和场景2的第二步逻辑一致,叠加所有者和appId列表的筛选条件即可。
注意事项
- 应用数据量较大时,可通过
$top参数指定单页返回数量(最大999),后续通过返回结果中的@odata.nextLink字段做分页拉取 - 应用图标二进制流可根据业务需求转成Base64或存储为本地文件,无需每次重复调用logo接口
- 所有筛选条件需严格遵守Graph API语法规范,字符串类型的匹配值需要用单引号包裹,多条件用
and连接
内容的提问来源于stack exchange,提问作者Mario De Carli
相关产品推荐
相关产品推荐

