使用 ASP.NET Core 以代理身份调用Microsoft Graph

使用代理的应用程序权限列出目录用户,而不是使用入站调用方的委派访问权限。

本文将配置GraphServiceClient,以便在代理 API 单独授权调用方时为代理获取 Microsoft Graph 令牌。

先决条件

  • 该操作所需的 Microsoft Graph 应用程序权限。
  • 通过管理员同意授予代理标识的应用程序权限。 请参阅授予对代理标识Microsoft Graph应用程序权限。
  • 蓝图凭据和 ASP.NET Core服务,包括令牌获取和AgentUser入站授权策略。 重复使用其本地证书配置进行工作站测试。 在这个 Microsoft Graph 示例中,不需要该演练的自定义 API 应用角色或许可授予。

添加Microsoft Graph

安装集成包:

dotnet add package Microsoft.Identity.Web.GraphServiceClient

将 GraphServiceClient 注册到上级文章中配置的服务。 对于仅应用访问,调用 builder.Services.AddMicrosoftGraph,并将 options.BaseUrl 设置为 https://graph.microsoft.com/v1.0,将 options.Scopes 设置为 ["https://graph.microsoft.com/.default"]。 直接使用已配置的客户端 ID;不要添加 WithAgentIdentity。

将此注册放在代理 API 的builder.Build()中,位于Program.cs之前。

builder.Services.AddMicrosoftGraph(options =>
{
    options.BaseUrl = "https://graph.microsoft.com/v1.0";
    options.Scopes = ["https://graph.microsoft.com/.default"];
});

调用 Microsoft Graph

将RequestAppToken设置为true,以便GraphServiceClient获取代理标识的仅应用令牌:

将以下 using 指令与顶部 Program.cs的指令合并,并在其单个 app.Run()终结点之前插入终结点。 可以省略自定义 API 终结点。

using Microsoft.Graph;
using Microsoft.Identity.Web;

app.MapGet("/graph-users", async (GraphServiceClient graphClient) =>
{
    var users = await graphClient.Users.GetAsync(request =>
        request.Options.WithAuthenticationOptions(options =>
        {
            options.RequestAppToken = true;
        }));

    return Results.Ok(users?.Value);
})
.RequireAuthorization("AgentUser");

客户端使用父级文章中配置的共享客户端 ID 和蓝图凭据。 不要添加 Agent ID 覆盖设置。 该示例需要一个可以列出用户的应用程序权限,例如 User.Read.All。 仅授予调用所需的权限。

验证 Graph 调用

遵循父旅程的 API 访问测试,将 /custom-api 替换为 /graph-users。 当代理具有所需的 Graph 应用程序权限时,预期 200 和用户的 JSON 集合。 此终结点返回第一个响应页,不一定是目录中的每个用户。

如果没有入站令牌,预计会出现 401。 如果租户颁发了该令牌,则在缺少 Agent.User 的情况下,预期为 403。 下游 Graph 故障会导致示例抛出异常,而不是从代理返回相同的状态。 将对代理标识的 Graph 授权验证与对调用方角色分配的验证分开进行。

后续步骤

向代理 API 对用户进行身份验证