使用代理程式的應用程式權限列出目錄使用者,而非使用入站呼叫者的委派存取權限。
在本文中,您將設定GraphServiceClient取得代理程式的 Microsoft Graph 令牌,同時代理程式 API 會獨立授權呼叫者。
先決條件
- 操作所需的 Microsoft Graph 應用程式權限。
- 已在管理員同意下授與代理程式身分識別的應用程式權限。 請參閱「將 Microsoft Graph 應用程式權限授與代理程式身分識別」。
-
藍圖憑證與 ASP.NET Core 服務,包括權杖擷取與
AgentUser輸入授權原則。 可重複使用其本地憑證設定進行工作站測試。 對於此 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 同意,並與呼叫端的角色指派分開。