大网数据广告活动
Microsoft Graph 接口

从云解决方案提供商应用程序中调用 Microsoft Graph

· 52CE 我爱测

本主题介绍如何使应用程序使用授权代码授予流或服务到服务客户端凭据流,通过 Microsoft Graph 访问合作伙伴托管的客户数据。

注意: 本主题 仅 适用于 Microsoft 云解决方案提供商 (CSP) 应用程序开发者。Microsoft 云解决方案提供商 (CSP) 计划使 Microsoft 的合作伙伴可以管理 Microsoft Online Services 并将其转售给客户。

本主题介绍如何使应用程序使用授权代码授予流或服务到服务客户端凭据流,通过 Microsoft Graph 访问合作伙伴托管的客户数据。

重要说明: 从 CSP 应用程序中调用 Microsoft Graph 仅受目录资源(例如 用户、组、设备、组织)和 Intune 资源支持。

什么是合作伙伴托管的应用程序

CSP 计划使 Microsoft 的合作伙伴可以管理 Microsoft Online Services(例如 Microsoft 365、Microsoft Azure 和 CRM Online)并将其转售给客户。客户服务的管理是通过委派管理员特权完成的,这使委派的合作伙伴用户(称为代理)可以访问并配置其客户的环境。

此外,作为合作伙伴开发者,你可以构建 合作伙伴托管的应用 来管理客户的 Microsoft 服务。合作伙伴托管的应用通常称为 预先同意的 应用,因为所有客户都已自动预先同意合作伙伴托管的应用。这意味着,当某个客户租户中的用户使用一个合作伙伴托管的应用时,用户不会收到给予同意的提示就能使用该应用。合作伙伴托管的应用还可以继承委派的管理员特权,因此,你的合作伙伴代理还可以通过合作伙伴托管的应用程序获取对客户的特权访问。

如何设置合作伙伴托管的应用程序

被授予访问客户数据的提升权限时,应用程序被视为 合作伙伴托管。

注意: 合作伙伴托管的应用 仅 可以在合作伙伴租户中配置,为管理客户租户资源,合作伙伴托管的应用 必须 配置为 多租户应用程序。

注册和配置多租户应用

此处所需的初始步骤与注册和配置多租户应用程序所用的步骤相同:

  1. 使用 Azure 门户在合作伙伴租户中注册应用程序。若要作为合作伙伴托管的应用,必须将应用程序配置为多租户应用。此外,如果应用已经过部署并在多个地理区域中销售,你将需要如<a href="#region">此处所述在每个区域中注册你的应用。
  2. 使用最低特权的方法,再次通过 Azure 门户为多租户应用配置需要的 必要权限。

为你的所有客户预先同意应用

最后,向合作伙伴管理的应用授予所有客户配置权限。为此,可以同两国使用 Azure AD powershell V2 或 Microsoft GraphPowerShell 表示应用的 servicePrincipal 添加到合作伙伴租户中的 Adminagents 组。按照以下步骤查找 Adminagents 组 servicePrincipal 并将其添加到组。

Azure AD PowerShell

  1. 打开 PowerShell 会话,并通过在登录窗口中输入管理员凭据连接到合作伙伴租户。

    Connect-AzureAd
    
  2. 查找代表 Adminagents 的组。

    $group = Get-AzureADGroup -Filter "displayName eq 'Adminagents'"
    
  3. 查找与应用具有相同 appId 的服务主体。

    $sp = Get-AzureADServicePrincipal -Filter "appId eq '{yourAppsAppId}'"
    
  4. 最后,将服务主体添加到 Adminagents 组中。

    Add-AzureADGroupMember -ObjectId $group.ObjectId -RefObjectId $sp.ObjectId
    

Microsoft Graph PowerShell

  1. 打开 PowerShell 会话,并通过在登录窗口中输入管理员凭据连接到合作伙伴租户。

    Connect-MgGraph
    
  2. 查找代表 Adminagents 的组。

    $group = Get-MgGroup -Filter "displayName eq 'Adminagents'"
    
  3. 查找与应用具有相同 appId 的服务主体。

    $sp = Get-MgServicePrincipal -Filter "appId eq '{yourAppsAppId}'"
    
  4. 最后,将服务主体添加到 Adminagents 组中。

    New-MgGroupMember -GroupId $group.Id -DirectoryObjectId $sp.Id
    

令牌购置流

合作伙伴托管的应用的令牌购置流(授权代码授予流和服务到服务客户端凭据流)与常规的多租户应用相同。

除了预先同意访问所有客户租户外,合作伙伴托管的应用还具有其他功能。它允许你的代理使用应用访问客户的租户数据(使用委派的管理员特权)。从概念上讲,工作原理如下:

  1. 代理使用从合作伙伴租户颁发的用户凭据登录你的应用。
  2. 你的应用请求对目标合作伙伴托管的客户租户的访问令牌。
  3. 你的应用使用访问令牌调用 Microsoft Graph。

除了代理必须使用其合作伙伴帐户登录之外,这是标准的 授权代码授予流。若要查看其工作原理,请假设你的合作伙伴租户是 partner.com(这是代理的主租户),并将你的一位客户假设为 customer.com:

  1. 获取授权代码:在我们的示例 customer.com 中,对于目标租户,你的应用会对 /authorize 终结点发出请求,且必须使用 客户租户 你的代理将仍然使用其 username@partner.com 帐户登录。

    GET https://login.microsoftonline.com/customer.com/oauth2/authorize
    
  2. 使用授权代码获取访问令牌:在我们的示例 customer.com 中,当对 token 终结点发出请求时,你的应用必须将 客户租户 用作目标租户:

    POST https://login.microsoftonline.com/customer.com/oauth2/token
    
  3. 现在你拥有了访问令牌,请调用 Microsoft Graph,将访问令牌置于 HTTP 授权标头中:

    GET https://graph.microsoft.com/beta/users
    Authorization: Bearer <token>
    

在支持的区域中注册你的应用

CSP 客户服务当前仅限于单个区域。合作伙伴托管的应用程序执行相同的限制。这意味着你在进行销售的每个区域必须具有单独的租户。例如,如果合作伙伴托管的应用在位于美国的租户中注册,但你的客户位于英国,合作伙伴托管的应用将无法工作。每个区域合作伙伴租户必须维护自己的一组合作伙伴托管的应用,才能管理相同区域内的客户。这可能需要应用中的其他逻辑(登录前)获取用户的登录用户名,才能决定使用哪个特定于区域的合作伙伴托管的标识来为用户提供服务。

创建客户后立即调用 Microsoft Graph

使用合作伙伴中心 API 创建新客户时会创建新的客户租户。此外,还会创建合作伙伴关系,这使你成为此新客户租户的在案合作伙伴。这种伙伴关系可能需要最多 3 分钟传播给新客户租户。如果应用在创建后直接调用 Microsoft Graph,应用可能会接收拒绝访问错误。当现有客户接受你的邀请时可能会遇到类似延迟。这是因为预先同意依赖于客户租户中现已存在的合作伙伴关系。

为避免此问题,在调用 Azure AD 以获取令牌(从而调用 Microsoft Graph)之前,我们建议你的合作伙伴应用在创建客户后等待 三分钟。这应该涵盖了大多数情况。但是,如果等待三分钟后仍收到授权错误,请再等待 60 秒后重试。

注意: 重试时,你必须在调用 Microsoft Graph 之前从 Azure AD 获取新的访问令牌。你将无法使用已经拥有的访问令牌调用 Microsoft Graph,因为访问令牌只能使用一小时,且不包含预先同意的权限声明。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 jackson-woods)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。