Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les utilisateurs appellent un agent de flotte avec un jeton d’accès pour la portée du blueprint access_agent. Chaque agent de la flotte partage ce public, de sorte que la validation des jetons prouve qui est l’utilisateur, mais pas l’agent qu’il est autorisé à utiliser. Le runtime achemine chaque requête vers un agent et applique lui-même l’accès par agent.
Prerequisites
- Effectuer des appels d’API en tant qu’agent dans une flotte avec ASP.NET Core.
- La portée
access_agentexposée sur le blueprint. - Un client en amont qui authentifie les utilisateurs et demande la portée
api://<agent-identity-blueprint-client-id>/access_agent.
Configurer la validation des jetons
La validation de jeton est la même que pour un seul agent. Utilisez l’ID client blueprint comme public attendu. Pour plus d’informations sur la configuration et la validation du client en amont, consultez Authentifier les utilisateurs sur une API d’agent ASP.NET Core.
Pour limiter les utilisateurs qui peuvent appeler la flotte, exigez une attribution de rôle d’application sur le principal de blueprint. Ces rôles d’application s’appliquent à chaque agent de la flotte.
Imposer l’accès par agent
Décidez qui peut utiliser chaque agent et stocker cette décision dans le runtime. Par exemple, enregistrez les utilisateurs et les groupes avec lesquels le propriétaire d’un agent le partage. Définissez une stratégie d’accès que le runtime vérifie sur chaque requête :
using System.Security.Claims;
public interface IAgentAccessPolicy
{
Task<bool> CanUseAgentAsync(ClaimsPrincipal user, string agentId);
}
Identifiez l’utilisateur par les claims oid et tid. N’utilisez pas le nom d’utilisateur principal ou l’e-mail comme clé stable.
Implémentez IAgentAccessPolicy sur vos enregistrements de partage et inscrivez-le dans l’injection de dépendances avant de mapper le point de terminaison. L’interface seule ne garantit pas l’accès.
Acheminer les demandes vers les agents
Placez l’ID de l’agent du runtime dans la route. Validez le jeton, vérifiez que l’agent existe et vérifiez la stratégie d’accès avant d’exécuter l’agent :
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();
Le point de terminaison retourne 404 Not Found à la fois pour un agent inconnu et pour un agent que l’utilisateur ne peut pas utiliser, de sorte que les appelants ne peuvent pas découvrir d’autres agents dans la flotte. Une fois ces vérifications passées, utilisez agentId pour chaque demande de jeton effectuée lors de la gestion de la demande.
Avant d’ajouter la gestion des agents, testez avec un utilisateur qui peut accéder à un agent, mais pas à un autre. La requête autorisée atteint la réponse de l’espace réservé 202 Accepted ; les requêtes pour l’autre agent et pour un agent inconnu renvoient 404 Not Found. Vérifiez que aucune des demandes rejetées n’exécute le travail de l’agent ou demande un jeton en aval. La réponse placeholder vérifie le routage et les vérifications d’accès, et non l’exécution de l’agent.
Étape suivante
Appeler des API en tant qu’utilisateur dans une flotte avec ASP.NET Core