使用 Microsoft Graph 管理Microsoft Entra应用程序和服务主体

本指南概述了关键概念、API 用例和资源,以帮助自动执行Microsoft Entra应用程序的生命周期管理。

应用程序和服务主体

在 Microsoft Entra 中,应用程序由应用程序对象和服务主体对象定义。 跨Microsoft Entra只有一个应用程序对象,但应用程序可以有多个服务主体对象。

应用程序对象位于注册应用的租户中。 在注册应用的租户以及安装并使用的每个租户中创建服务主体。 有关详细信息,请参阅 Microsoft Entra ID 中的应用程序和服务主体对象

在 Microsoft Graph 中,应用程序由 应用程序资源类型表示,服务主体由 servicePrincipal 资源类型表示。 可通过Entra ID应用注册和> Entra ID企业应用程序菜单在Microsoft Entra 管理中心>上访问这两个对象的详细信息。

服务主体从其关联的应用注册继承特定属性。 这些属性从应用注册同步,但同步不是立即或连续的。 有时,更新服务主体可能会提示目录从应用注册刷新属性,从而导致不属于原始请求的更新。

用于管理应用程序的 API 用例

支持以下 API 用例通过 Microsoft Graph 中的 应用程序资源类型管理应用程序

用例 API作
注册应用程序并配置其基本属性 创建应用程序
配置已注册应用程序的属性,包括:
  • 显示名称、徽标和标记等基本属性
  • 权限
  • 向用户分配应用
  • 设置基本标识符 URI
  • 应用支持的Microsoft帐户
  • 应用角色
更新应用程序
删除应用程序 删除应用程序
管理已删除的应用程序
管理应用程序的密码凭据
管理应用程序的联合标识凭据 开始使用 Microsoft Graph 管理联合标识凭据
管理应用程序的基于证书的凭据
管理应用程序的目录扩展
跟踪对应用程序的更改
管理所有者
管理发布者验证

用于管理服务主体的 API 用例

支持以下 API 用例通过 Microsoft Graph 中的 servicePrincipal 资源类型 管理服务主体。

用例 API作
注册服务主体 创建 servicePrincipal
配置服务主体的属性,包括:
- 显示名称和徽标等基本属性
-权限
- 配置 SSO 模式
更新 servicePrincipal
删除服务主体 删除 servicePrincipal
管理已删除的服务主体:查看、还原或永久删除
- 列出 deletedItems
- 列出用户拥有的 deletedItems
- 获取已删除的项目
- 永久删除项目
- 还原已删除的项目
管理服务主体的密码凭据
- servicePrincipal:addPassword
- servicePrincipal:removePassword
管理服务主体的基于证书的凭据
- servicePrincipal:addKey
- servicePrincipal:removeKey
添加 SAML 令牌签名证书 servicePrincipal:addTokenSigningCertificate
跟踪对服务主体的更改
- servicePrincipal: delta
- directoryObject: 具有以下筛选器的增量: ..?$filter=isof('microsoft.graph.servicePrincipal')
管理所有者
- 列表所有者
- 添加所有者
- 删除所有者

应用程序模板

应用程序模板是Microsoft Entra应用库中提供的应用。 使用 applicationTemplate 资源类型及其关联方法 可以:

  • 从应用程序库中标识应用。
  • 按他们支持的 SSO 模式标识应用。
  • 从应用程序库实例化应用和服务主体。

适用于应用程序和服务主体的策略

策略说明 API作 适用对象
(RDS) 身份验证协议管理Microsoft Entra ID远程桌面服务 remoteDesktopSecurityConfiguration 资源类型及其关联方法 服务主体
配置 SAML 令牌策略 tokenIssuancePolicy 资源类型及其关联方法 应用程序
服务主体
配置访问、SAML 和 ID 令牌的策略 令牌生存期策略 - tokenLifetimePolicy 资源类型及其关联方法
令牌颁发策略 - tokenIssuancePolicy 资源类型及其关联方法
应用程序
服务主体
管理所有设备类型的 Microsoft 365 Web 应用的空闲会话超时
注意: 若要仅针对非托管设备触发策略,还需要添加条件访问策略。
activityBasedTimeoutPolicy 资源类型及其关联方法 Microsoft 365 个 Web 应用
管理如何在组织中使用证书和密码机密的策略。 创建租户范围策略或特定于应用的策略,例如阻止使用或限制密码机密或对称密钥的生存期,以及强制实施受信任的证书颁发机构 应用程序身份验证方法策略 应用程序
管理 WS-Fed、SAML、OAuth 2.0 和 OpenID Connect 协议的声明映射策略,以及策略应用于的应用程序 claimsMappingPolicy 资源类型及其关联方法 服务主体
管理租户的主领域发现 (HRD) ,并将策略分配给服务主体 homeRealmDiscoveryPolicy 资源类型及其关联方法 服务主体

标识同步 (预配)

通过 Microsoft Graph 中的预配 API,可以自动执行和管理这些方案中标识的预配和取消预配:

  • 从本地 Active Directory到Microsoft Entra ID
  • 从其他云目录到Microsoft Entra ID
  • 从Microsoft Entra ID到 Dropbox、Salesforce、ServiceNow 等云应用程序

有关详细信息,请参阅Microsoft Entra同步 API 概述