Benutzer authentifizieren und Anfragen an Agenten in einer Flotte mit ASP.NET Core weiterleiten

Benutzer rufen einen Flotten-Agent mit einem Zugriffstoken für den Scope des Blueprints access_agent auf. Jeder Agent in der Flotte teilt diese Zielgruppe, sodass die Tokenüberprüfung beweist, wer der Benutzer ist, aber nicht, welcher Agent er verwenden darf. Die Laufzeit leitet jede Anforderung an einen Agent weiter und erzwingt den Zugriff pro Agent selbst.

Voraussetzungen

Konfigurieren der Tokenüberprüfung

Die Tokenüberprüfung ist identisch wie bei einem einzelnen Agenten. Verwenden Sie die Blueprint-Client-ID als erwartete Zielgruppe. Informationen zum Einrichten und Überprüfen von Upstreamclients finden Sie unter Authentifizieren von Benutzern bei einer ASP.NET Core-Agent-API.

Um zu begrenzen, welche Benutzer die Flotte überhaupt aufrufen können, machen Sie eine App-Rollenzuweisung erforderlich für den Blueprintprinzipal. Diese App-Rollen gelten für jeden Agent in der Flotte.

Zugriff pro Agent erzwingen

Entscheiden Sie, wer jeden Agenten verwenden kann, und speichern Sie diese Entscheidung in der Runtime. Notieren Sie beispielsweise die Benutzer und Gruppen, für die der Besitzer eines Agents sie freigegeben hat. Definieren Sie eine Zugriffsrichtlinie, die von der Laufzeit auf jede Anforderung überprüft wird:

using System.Security.Claims;

public interface IAgentAccessPolicy
{
    Task<bool> CanUseAgentAsync(ClaimsPrincipal user, string agentId);
}

Identifizieren Sie den Benutzer anhand der tid und oid Claims. Verwenden Sie nicht den Benutzerprinzipalnamen oder die E-Mail als stabilen Schlüssel.

Implementieren Sie IAgentAccessPolicy für Ihre Freigabedatensätze und registrieren Sie es in der Dependency Injection, bevor Sie den Endpunkt zuordnen. Die Schnittstelle allein erzwingt keinen Zugriff.

Anfragen an Agenten weiterleiten

Setzen Sie die Agent-ID der Laufzeit in die Route. Überprüfen Sie das Token, vergewissern Sie sich, dass der Agent vorhanden ist, und überprüfen Sie die Zugriffsrichtlinie, bevor der Agent ausgeführt wird:

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();

Der Endpunkt gibt 404 Not Found sowohl für einen unbekannten Agent als auch für einen Agent zurück, den der Benutzer nicht verwenden kann, sodass Anrufer keine anderen Agents in der Flotte entdecken können. Verwenden Sie agentId nach diesen Prüfungen bei der Verarbeitung der Anforderung für jede Tokenanforderung.

Testen Sie vor dem Hinzufügen der Agent-Arbeit mit einem Benutzer, der auf einen Agent, aber nicht auf einen anderen Agent zugreifen kann. Die zulässige Anforderung erreicht die Platzhalterantwort 202 Accepted. Anforderungen für den anderen Agenten und einen unbekannten Agenten geben 404 Not Found zurück. Vergewissern Sie sich, dass weder die abgelehnte Anforderung Agent-Arbeit ausführt noch ein downstreames Token anfordert. Die Platzhalterantwort überprüft Routing- und Zugriffsprüfungen, nicht die Ausführung des Agents.

Nächster Schritt

Aufrufen von APIs als Benutzer in einer Flotte mit ASP.NET Core