使用 ASP.NET Core 以代理程式身分呼叫 Microsoft Graph

使用代理程式的應用程式權限列出目錄使用者,而非使用入站呼叫者的委派存取權限。

在本文中,您將設定GraphServiceClient取得代理程式的 Microsoft Graph 令牌,同時代理程式 API 會獨立授權呼叫者。

先決條件

新增 Microsoft Graph

安裝整合套件:

dotnet add package Microsoft.Identity.Web.GraphServiceClient

註冊 GraphServiceClient 至父文章中所設定的服務。 若為僅限應用程式的存取,請呼叫 https://graph.microsoft.com/v1.0,並將 options.BaseUrl 設為 builder.Services.AddMicrosoftGraph,以及將 ["https://graph.microsoft.com/.default"] 設為 options.Scopes。 直接使用已設定的用戶端 ID;不要加上 WithAgentIdentity。

請將此註冊放在代理程式 API 的 Program.cs 中,並置於 builder.Build() 之前。

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 同意,並與呼叫端的角色指派分開。

下一步

向 agent API 驗證使用者