Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Gli utenti chiamano un agente della flotta con un token di accesso per l'ambito del blueprint access_agent. Ogni agente della flotta condivide tale audience, quindi la convalida dei token dimostra chi è l'utente, ma non quale agente è autorizzato a usare. Il runtime instrada ogni richiesta a un agente e applica direttamente il controllo di accesso per agente.
Prerequisites
- Completare Call APIs as an agent in a fleet con ASP.NET Core.
- Ambito
access_agentesposto nel blueprint. - Un client upstream che autentica gli utenti e richiede l'ambito
api://<agent-identity-blueprint-client-id>/access_agent.
Configurare la convalida dei token
La convalida dei token è identica a quella di un singolo agente. Usare l'ID client del blueprint come destinatario previsto. Per informazioni dettagliate sulla configurazione e la convalida del client upstream, vedere Autenticare gli utenti a un'API dell'agente ASP.NET Core.
Per limitare gli utenti che possono chiamare la flotta, richiedere un'assegnazione di ruolo dell'app nell'entità blueprint. Questi ruoli dell'app si applicano a ogni agente della flotta.
Applicare il controllo dell'accesso per agente
Decidere chi può usare ogni agente e archiviare tale decisione nel runtime. Ad esempio, registrare gli utenti e i gruppi con cui il proprietario di un agente lo condivide. Definire un criterio di accesso controllato dal runtime per ogni richiesta:
using System.Security.Claims;
public interface IAgentAccessPolicy
{
Task<bool> CanUseAgentAsync(ClaimsPrincipal user, string agentId);
}
Identificare l'utente in base alle attestazioni tid e oid. Non usare il nome principale utente o il messaggio di posta elettronica come chiave stabile.
Implementare IAgentAccessPolicy nei record di condivisione e registrarlo nell'inserimento delle dipendenze prima di eseguire il mapping dell'endpoint. L'interfaccia da sola non controlla l'accesso.
Instradare le richieste agli agenti
Inserire l'ID agente del runtime nella route. Convalidare il token, verificare che l'agente esista e controllare i criteri di accesso prima di eseguire l'agente:
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();
L'endpoint restituisce 404 Not Found sia per un agente sconosciuto che per un agente che l'utente non può usare, quindi i chiamanti non possono individuare altri agenti nella flotta. Dopo aver superato questi controlli, usare agentId per ogni richiesta di token effettuata durante la gestione della richiesta.
Prima di aggiungere il lavoro dell'agente, eseguire il test con un utente che può accedere a un agente ma non a un altro. La richiesta consentita raggiunge la risposta segnaposto 202 Accepted ; le richieste per l'altro agente e un agente sconosciuto restituiscono 404 Not Found. Verificare che nessuna delle richieste rifiutate esegua il lavoro dell'agente o richieda un token downstream. La risposta segnaposto verifica il routing e i controlli di accesso, non l'esecuzione dell'agente.
Passaggio successivo
Chiamata di API come utente in una flotta con ASP.NET Core