Microsoft Graph 提供 REST API 来管理标识和网络访问功能,其中大部分可通过 Microsoft Entra 获得。 这些 API 可帮助自动执行标识和网络访问管理任务、与应用程序集成,并充当管理员门户(如 Microsoft Entra 管理中心)的编程替代方法。
Microsoft Entra 是标识和网络访问解决方案系列,包括以下产品。 所有这些功能都可通过 Microsoft Graph API 获得:
- Microsoft Entra ID将身份和访问管理分组 (IAM) 功能。
- Microsoft Entra ID 治理
- Microsoft Entra 外部 ID
- Microsoft Entra 验证 ID
- Microsoft Entra 权限管理 (弃用的)
- Microsoft Entra Internet 访问和网络访问
管理用户标识
用户是任何标识和访问解决方案中的主要标识。 可以使用 Microsoft Graph API 管理组织中用户(包括来宾)及其权利(如许可证或组成员身份)的整个生命周期。 有关详细信息,请参阅 在 Microsoft Graph 中与用户合作。
管理群组
组是容器,允许你将标识的权利作为一个单元有效地管理。 例如,通过组,可以授予用户对资源(如 SharePoint 网站)的访问权限。 或者,可以授予他们使用服务的许可证。 有关详细信息,请参阅 在 Microsoft Graph 中使用组。
管理应用程序。
可以使用 Microsoft Graph API 以编程方式注册和管理应用程序,从而使你能够使用 Microsoft 的 IAM 功能。 有关详细信息,请参阅使用 Microsoft Graph 管理 Microsoft Entra 应用程序和服务主体。
管理代理
AI 代理需要与应用于组织中的用户、应用程序和设备的相同的标识、访问、安全性和治理框架。 Microsoft Graph API 支持完整的代理标识生命周期,包括:
- 创建和管理代理标识 - 以编程方式创建和管理代理标识蓝图、代理标识及其关联的元数据,例如所有者和发起人。
- 安全和访问控制 - 应用条件访问策略以对代理实施访问控制,并使用权利管理访问包向代理分配对安全组的访问权限、应用程序权限和 Microsoft Entra 角色。
- 治理 - 将发起人分配给座席身份,以在座席生命周期内保持人类责任。 使用访问评审定期验证代理身份是否仍然需要其分配的访问权限。
- 风险检测和监视 - 出于合规性和安全性目的,通过审核日志监视代理登录活动。
有关使用 Microsoft Graph API 为代理实现这些功能的详细信息,请参阅 Microsoft Graph 概述中的 Microsoft Entra 智能体 ID API。
租户管理和目录管理
标识和访问管理的核心功能是管理租户配置、管理角色和设置。 Microsoft Graph 提供 API 来管理适用于以下场景的 Microsoft Entra 租户:
| 用例 | API 操作 |
|---|---|
管理包括以下操作在内的管理单元:
|
administrativeUnit 及其关联的 API |
| 检索 BitLocker 恢复密钥 | bitlockerRecoveryKey 及其关联的 API |
| 管理自定义安全属性 | 请参阅使用 Microsoft 图形 API 的自定义安全属性概述 |
将关键目录对象(包括用户、组、应用程序、服务主体和条件访问策略)备份并还原到以前已知的良好状态,帮助你从意外更改或安全损害中恢复
|
请参阅 Microsoft Entra 备份和恢复 API 概述 |
管理已删除的目录对象。 以下对象支持将已删除的对象存储在“回收站”中的功能:
|
|
| 在云中管理设备 |
|
| 查看 Microsoft Entra ID 中启用了本地管理员密码解决方案 (LAPS) 的所有设备对象的本地管理员凭据信息。 此功能是基于云的 LAPS 解决方案 | deviceLocalCredentialInfo 及其关联的 API |
| 目录对象是 Microsoft Entra ID 中的核心对象,例如用户、组和应用程序。 可以使用 directoryObject 资源类型及其关联的 API 来检查目录对象的成员身份、跟踪多个目录对象的更改或验证 Microsoft 365 组的显示名称或邮件昵称是否符合命名策略 | directoryObject 及其关联的 API |
管理管理员角色,包括以下操作:
|
以下资源及其关联的 API: 对于实时和有时限的角色分配,而不是直接永久活动分配,请将 Privileged Identity Management API 用于 Microsoft Entra 角色和组 |
定义以下配置,这些配置可用于自定义租户范围和特定于对象的限制和允许的行为。
|
在 beta: directorySetting 和 directorySettingTemplate 及其关联的 API 在 v1.0: groupSetting 和 groupSettingTemplate 及其关联的 API 有关详细信息,请参阅 组设置概述。 |
域管理操作,例如:
|
域 及其关联的 API |
管理受邀通过 Teams 协作的外部用户的配置文件对象。 这些 API 与用于 Microsoft Entra 外部 ID B2B 协作的邀请 API 不同
|
externalUserProfile 和 pendingExternalUserProfile 及其关联的 API |
| 配置和管理特定 Microsoft Entra ID 功能的分阶段推出 | featureRolloutPolicy 及其关联的 API |
| 监视租户的许可证和订阅 |
|
管理移动设备管理 (MDM) 和移动应用程序管理的策略 (MAM) Microsoft Entra加入和注册设备的自动注册
|
以下资源及其关联的 API: |
| 配置 Microsoft Entra 云同步中可用的选项,例如防止意外删除和管理组写回。 | onPremisesDirectorySynchronization 及其关联的 API |
管理目录对象(例如本地 Active Directory 与云之间的用户、组和组织联系人)的同步设置
|
onPremisesSyncBehavior 及其关联的 API |
| 管理 Microsoft Entra 租户的基本设置 | 组织 及其关联的 API |
管理 Microsoft Entra 租户的租户范围设置,例如是否为组织启用人员和项目见解
|
organizationSettings 及其关联的 API |
| 检索可能从本地目录或 Exchange Online 同步的组织联系人 | orgContact 及其关联的 API |
| 通过使用租户 ID 或域名查询来发现其他 Microsoft Entra 租户的基本详细信息 | tenantInformation 及其关联的 API |
身份和登录
| 用例 | API 操作 |
|---|---|
| 在用户、组或服务主体的资源应用程序上授予、撤销和检索应用角色 | appRoleAssignment 及其关联的 API |
| 配置侦听器来监视应触发或调用自定义逻辑(通常在 Microsoft Entra ID 外部定义)的事件 | authenticationEventListener 及其关联的 API |
| 管理 Microsoft Entra ID 中支持的身份验证方法 | 请参阅 Microsoft Entra 身份验证方法 API 概述和 Microsoft Entra 身份验证方法策略 API 概述 |
| 管理可在 Microsoft Entra 条件访问中用作授权控制的身份验证方法或身份验证方法的组合 | 请参阅 Microsoft Entra 身份验证强度 API 概述 |
管理租户范围的授权策略,例如:
|
authorizationPolicy 及其关联的 API |
使用标识体验框架自定义 Azure AD B2C 中的 UI/UX (IEF)
|
trustFrameworkKeySet 和 trustFrameworkPolicy 及其关联的 API |
| 管理租户中基于证书的身份验证策略 | certificateBasedAuthConfiguration 及其关联的 API |
| 管理 Microsoft Entra 条件访问策略,包括国家/地区、IP 地址和合规网络等网络位置 在强制实施条件访问策略之前评估其影响 配置“持续访问评估” (CAE) ,这允许根据关键事件和策略评估撤销访问令牌,而不是依赖基于生存期的令牌过期
|
以下资源及其关联的 API: |
| 管理跨租户访问设置,并管理多租户组织中用户的出站限制、入站限制、租户限制和跨租户同步 | 请参阅 跨租户访问设置 API 概述 |
使用 B2B 直接连接管理与你或外部租户共享的用户配置文件,包括删除和导出个人数据
|
inboundSharedUserProfile 和 outboundSharedUserProfile 及其关联的 API |
| 配置在用户身份验证会话期间与 Microsoft Entra ID 交互的方式和外部系统 | customAuthenticationExtension 及其关联的 API |
| 管理针对组织中用户数据的请求,例如导出个人数据 | dataPolicyOperation 及其关联的 API |
配置用于管理 Microsoft Entra 加入和 Microsoft Entra 注册设备的策略
|
deviceRegistrationPolicy 及其关联的 API |
管理租户范围的策略,该策略控制外部用户是否可以通过自助服务控制(例如,通过“我的帐户”门户的“组织”菜单)离开 Microsoft Entra 租户
|
externalIdentitiesPolicy 及其关联的 API |
| 强制自动加速登录跳过用户名输入屏幕,并自动将用户转发到联合登录终结点 | homeRealmDiscoveryPolicy 及其关联的 API |
| 使用 Microsoft Entra ID 保护 检测、调查和修正基于标识的风险,并将数据馈送到 SIEM) 工具 (安全信息和事件管理中,以便进一步调查和关联 | 请参阅使用 Microsoft Graph 标识保护 API |
管理 Microsoft Entra ID、Microsoft Entra 外部 ID 和 Azure AD B2C 租户的标识提供者。 可以执行以下操作:
|
identityProviderBase 及其关联的 API |
| 定义属于组织的一组租户,并简化组织内跨租户协作 | 请参阅 多租户组织 API 概述 |
| 管理委托的权限及其分配给租户中服务主体的权限 | oAuth2PermissionGrant 及其关联的 API |
| 自定义登录 UI 以匹配公司品牌,包括应用基于浏览器语言的品牌 | organizationalBranding 及其关联的 API |
| 为可分配给租户中的应用和服务主体的证书配置受信任的证书颁发机构。 | certificateBasedApplicationConfiguration 及其关联的 API |
| 员工租户中 Microsoft Entra 外部 ID 的用户流 | 以下资源及其关联的 API:
|
适用于 Azure AD B2C 的用户流
|
以下资源及其关联的 API:
|
| 外部租户中 Microsoft Entra 外部 ID 的用户流 | 以下资源及其关联的 API:
|
| 管理应用同意策略和条件集 | permissionGrantPolicy |
管理应用同意预先批准策略
|
permissionGrantPreApprovalPolicy |
| 启用或禁用 Microsoft Entra ID 中的安全默认值 | identitySecurityDefaultsEnforcementPolicy |
身份管理
有关详细信息,请参阅使用 Microsoft Graph 的 Microsoft Entra ID 治理概述。
外部租户中的 Microsoft Entra 外部 ID
支持以下 API 用例来自定义用户与面向客户的应用程序交互的方式。 对于管理员来说,大多数功能在 Microsoft Entra ID 中可用,并且还受外部租户中的 Microsoft Entra 外部 ID 支持。 例如,域管理、应用程序管理和条件访问。 有关外部 ID 中支持的所有功能的详细信息,请参阅员工和外部租户中支持的功能。
| 用例 | API 操作 |
|---|---|
| 外部租户中 Microsoft Entra 外部 ID 的用户流和自助注册体验 | authenticationEventsFlow 及其关联的 API |
| 管理 Microsoft Entra 外部 ID 的标识提供者。 可以标识租户中支持或配置的标识提供者 | 请参阅 identityProviderBase 及其关联的 API |
| 在 Microsoft Entra 外部 ID 中配置自定义 URL 域 在外部租户中 |
CustomUrlDomain
域及其关联 API 的 supportedServices 属性的值 |
自定义登录 UI 以匹配公司品牌,包括应用基于浏览器语言的品牌或应用基于应用的品牌
|
organizationalBranding 及其关联的 API |
| 管理 Microsoft Entra 外部 ID 的标识提供者,例如社交标识 | identityProviderBase 及其关联的 API |
使用别名或用户名登录
|
signInIdentifierBase 及其关联的 API |
| 在 Microsoft Entra 外部 ID 中管理客户的用户配置文件 | 有关详细信息,请参阅 客户租户中的默认用户权限 |
| 管理 Microsoft Entra 条件访问策略,例如包括所有用户或排除特定用户和组 目标资源和身份验证上下文 应用条件,例如设备平台和网络位置,例如国家/地区、IP 地址和合规网络 会话控制 (登录频率和持久浏览器会话) |
以下资源及其关联的 API: |
| 通过与 Microsoft Entra ID 外部的系统集成,将自己的业务逻辑添加到身份验证体验 | authenticationEventListener 和 customAuthenticationExtension 及其关联的 API |
| 与欺诈保护提供商集成,以防止用户注册过程中的虚假帐户注册和机器人攻击。 受支持的提供商包括 Arkose Labs 和 HUMAN Security | fraudProtectionProvider 和 onFraudProtectionLoadStartListener 及其关联的 API |
| 与 Akamai 和 Cloudflare 等 Web 应用程序防火墙提供商集成 | webApplicationFirewallProvider 及其关联的 API |
多云权限管理 (已弃用)
有关详细信息,请参阅 使用权限管理 API 发现、修正和监视多云基础架构中的权限。
网络访问管理
有关详细信息,请参阅使用 Microsoft Graph 网络访问 API 保护对云、公共和专用应用的访问。
合作伙伴租户管理
Microsoft Graph 还为云解决方案提供商 (CSP) 、增值经销商 (VAR) 或顾问计划中的Microsoft合作伙伴提供以下标识和访问功能,以帮助管理其客户租户。
| 用例 | API 操作 |
|---|---|
| 管理合作伙伴与其客户的合同 | 合约 及其关联的 API |
| Microsoft 合作伙伴可以授权其客户确保合作伙伴对其客户的租户具有最低特权访问权限。 此功能使客户能够额外控制其安全状况,同时允许他们从 Microsoft 经销商获得支持 | 请参阅精 细委派管理员权限 (GDAP) API 概述 |
获取有关你负责的客户租户中未经授权方滥用、帐户接管和 Azure 订阅异常使用的检测和安全警报。
|
请参阅在 Microsoft Graph 中使用合作伙伴安全警报 API |
标识和访问报告
Microsoft Entra 记录租户中的每项活动,并生成报告和审核日志,可分析这些报告和审核日志以进行监视、合规性和故障排除。 这些活动的记录也可通过 Microsoft Graph 报告和审核日志 API 获得,让你可以使用 Azure Monitor 日志和日志分析分析活动,或流式传输到第三方 SIEM 工具进行进一步调查。 有关详细信息,请参阅 标识和访问报告 API 概述。
零信任
此功能可帮助组织将其租户与零信任体系结构的三个指导原则保持一致:
- 显式验证
- 使用最低权限
- 假定漏洞
要了解有关零信任和其他使您的组织与指导原则保持一致的方法的详细信息,请参阅零信任指导中心。
授权
Microsoft Entra 许可证包括 Microsoft Entra ID 免费版、P1、P2 和治理;Microsoft Entra 权限管理;和 Microsoft Entra Workload ID。
有关不同功能的许可的详细信息,请参阅 Microsoft Entra ID 许可。
相关内容
- 使用 Microsoft Entra ID 实现标识标准
- 独立软件开发人员的 Microsoft Entra ID 指南
- 查看 Microsoft Entra 部署计划,以帮助你制定部署 Microsoft Entra 功能套件的计划。