使用者會使用藍圖 access_agent 範圍的存取權杖呼叫車隊中的代理。 整個團隊中的每個代理都共享這個受眾,因此令牌驗證只證明使用者是誰,但不代表他們被允許使用哪個代理。 執行時會將每個請求路由到代理程式,並自行強制執行各代理程式層級的存取控制。
Prerequisites
- 完成 使用 ASP.NET Core 在裝置群中以代理程式身分呼叫 API。
-
access_agent範圍。 - 一個上游用戶端,負責登入使用者並請求範疇
api://<agent-identity-blueprint-client-id>/access_agent。
配置令牌驗證
令牌驗證與單一代理者相同。 使用藍圖用戶端 ID 作為預期受眾。 有關上游用戶端設定與驗證的詳細資訊,請參閱「驗證使用者以存取 ASP.NET Core 代理程式 API」。
若要限制哪些使用者完全可以呼叫整個艦隊,請在藍圖主體上要求指派應用程式角色。 這些應用程式角色適用於代理程式群組中的每個代理程式。
強制執行各代理程式的存取控制
決定誰可以使用每個代理程式,並將該決定儲存在執行時中。 例如,記錄代理程式擁有者與哪些使用者及群組共用該代理程式。 定義一個存取原則,執行環境會在每個請求時檢查:
using System.Security.Claims;
public interface IAgentAccessPolicy
{
Task<bool> CanUseAgentAsync(ClaimsPrincipal user, string agentId);
}
透過 tid 和 oid 聲明來識別使用者。 不要使用使用者主體名稱或電子郵件作為穩定金鑰。
在對端點進行對應之前,先針對您的共用紀錄實作 IAgentAccessPolicy 並在相依性注入中註冊。 僅靠介面本身並不能強制存取。
將請求路由至代理程式
將執行時的代理程式 ID 輸入到路由中。 在執行代理程式前,先驗證令牌、確認代理程式存在,並檢查存取原則:
using Microsoft.Identity.Web.Resource;
app.MapPost("/agents/{agentId}/messages", async (
string agentId,
HttpContext context,
IAgentDirectory directory,
IAgentAccessPolicy accessPolicy) =>
{
context.VerifyUserHasAnyAcceptedScope("access_agent");
if (await directory.FindAsync(agentId) is null
|| !await accessPolicy.CanUseAgentAsync(context.User, agentId))
{
return Results.NotFound();
}
// Run the agent for this request.
return Results.Accepted();
})
.RequireAuthorization();
端點對未知代理和使用者無法使用的代理都回傳 404 Not Found,因此呼叫者無法發現機群中的其他代理。 在這些檢查都通過後,在處理該請求期間提出的每個權杖要求,都使用 agentId 。
在新增代理程式工作之前,請先使用一位能存取某個代理但無法存取另一個代理的使用者進行測試。 允許的請求會到達佔位符 202 Accepted 回應;對另一個代理程式及未知代理程式的請求會回傳 404 Not Found。 確認遭拒的請求既不會執行代理程式作業,也不會請求下游權杖。 佔位符回應用於驗證路由與存取檢查,而不是驗證代理程式執行。
下一步
以使用者身分在 fleet 中使用 ASP.NET Core 呼叫 API