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.
Une flotte d’agents est un ensemble d’agents qui s’exécutent sur un runtime cloud partagé. Par exemple, une plateforme qui permet aux équipes ou aux clients de déployer leurs propres agents héberge chaque nouvel agent sur la même base de calcul et de code. Chaque agent de la flotte obtient son propre identité d’agent, de sorte que ses connexions, ses autorisations et ses enregistrements d’audit restent distincts des autres agents.
Le runtime contient un seul jeu d’informations d’identification de modèle d’identité d’agent et l’utilise pour acquérir des jetons pour toute identité d’agent créée à partir de ce modèle. Le runtime choisit l’identité de l’agent à utiliser sur chaque demande de jeton.
Choisir entre un seul agent et une flotte
| Considérations | Agent individuel | Flotte d’agents |
|---|---|---|
| Nombre d’agents par déploiement | Une | Nombreux, ajoutés et supprimés au moment de l’exécution |
| Lorsque des identités d’agent sont créées | Avant le déploiement de l’agent, par un développeur ou un administrateur | Lorsque chaque agent est déployé, par le runtime ou par Agent 365 |
| Où provient l’ID d’identité de l’agent | Configuration | Recherche sur chaque requête |
| Mode d’octroi de l’accès | À l’identité de l’agent, avant le déploiement de l’agent | Pour chaque identité de l’agent, lorsque l’agent est approvisionné |
| Conseils | Créer des agents cloud avec ASP.NET Core ou le side-car du Kit de développement logiciel (SDK) Auth | Cet article et les articles de flotte qui le suivent |
Le runtime de flotte sélectionne l’identité d’un agent pour chaque opération. Suivez les exemples de flotte tout au long de ce parcours : les didacticiels sur l’agent cloud utilisent une identité configurée et omettent la sélection d’identité par demande requise par une flotte.
Components
| Component | Purpose | Cardinality |
|---|---|---|
| Blueprint d’identité de l’agent | Définit les autorisations, l’étendue entrante et les rôles d’application de la flotte. Crée et supprime des identités d’agent. | Un par flotte, ou un par type d’agent |
| Informations d’identification de Blueprint | Authentifie le runtime en tant que blueprint. Utilisez des informations d’identification fédérées d’identité managée en production. | Un par plan |
| Identité de l’agent | Représente un agent. Reçoit les jetons d’accès utilisés pour appeler des API. | Un par agent |
| Compte d’utilisateur de l’agent | Donne à un agent un objet utilisateur pour les charges de travail Microsoft 365 telles qu’une boîte aux lettres ou une appartenance à une équipe Teams. | Facultatif, au plus un par identité d’agent |
| Répertoire des agents | Magasin du runtime qui mappe chaque agent à son identité d’agent et au compte d’utilisateur de l’agent. | Un élément par flotte |
| Service de provisionnement | Crée et supprime des identités lorsque les agents sont déployés et mis hors service. | Un par parc |
| Courtier de jetons | Obtient des jetons pour une identité d’agent donnée. Microsoft.Identity.Web dans le processus d’exécution ou le side-car du Kit de développement logiciel (SDK) Auth. | Un ou plusieurs par runtime |
Cycle de vie de l’agent
- Déployer. Un utilisateur ou un pipeline déploie un nouvel agent sur le runtime.
- Disposition. Le service de provisionnement crée une identité d’agent à partir du modèle. Si l'agent a besoin des fonctionnalités utilisateur de Microsoft 365, il crée également le compte d'utilisateur d'un agent. Il enregistre les ID dans le répertoire de l’agent et l’identité de l’agent reçoit l’accès dont cet agent a besoin.
- Courir. Pour chaque opération, le runtime recherche l’identité de l’agent dans le répertoire de l’agent et la transmet au répartiteur de jetons.
- Retirer. Le service d’approvisionnement supprime le compte d’utilisateur de l’agent, puis l’identité de l’agent, puis supprime l’entrée d’annuaire de l’agent.
Choisir la façon dont les agents sont provisionnés
| Option | Fonctionnement | Utilisez-le quand |
|---|---|---|
| Le runtime provisionne des identités | Le service de provisionnement s'authentifie en tant que plan et appelle Microsoft Graph pour créer et supprimer des identités d'agent et des comptes d'utilisateur de l'agent. | Le runtime contrôle le déploiement de l’agent. |
| Agent 365 provisionne des identités | Agent 365 crée l’identité de l’agent lorsqu’un agent est provisionné. Le runtime écoute les événements de provisionnement de l’agent, qui incluent l’ID d’identité de l’agent, et enregistre cet ID dans le répertoire de l’agent. | Les agents sont créés via des expériences Microsoft 365. Pour plus d’informations, consultez la documentation du développeur Agent 365. |
Les deux options produisent la même entrée de répertoire d’agent. Le reste des conseils sur la flotte s’applique à l’une ou l’autre des options.
Sélectionnez l’identité de l’agent sur chaque requête
Les identifiants du blueprint peuvent acquérir des jetons pour chaque identité d’agent créée à partir du blueprint. Le code d’exécution qui choisit l’identité de l’agent est donc une limite de sécurité.
- Résolvez l’identité de l’agent à partir du répertoire de l’agent à l’aide d’une clé que le runtime contrôle, telle que son propre ID d’agent.
- N’acceptez pas l’ID client d’identité de l’agent ou l’ID de compte d’utilisateur de l’agent à partir d’une requête, d’une invite ou d’une sortie d’outil.
- Vérifiez que l’appelant est autorisé à utiliser l’agent cible avant de demander un jeton.
Planifier les limites de confiance
- Gardez les informations d’identification hors du code de l’agent. Maintenez les informations d’identification du blueprint dans le runtime ou dans le side-car, jamais dans le code que contrôle un auteur d’agent ou un modèle.
- Isoler le répartiteur de jetons. Si les agents exécutent du code non approuvé ou fourni par le client, ne laissez pas ce code appeler directement le broker de jetons. Un processus qui peut atteindre le broker peut demander un jeton pour n’importe quel agent dans la flotte.
- Séparez le provisionnement de l’acquisition de jetons. Le service de provisionnement utilise des jetons de modèle qui peuvent créer et supprimer des identités. Exécutez-le avec son propre chemin d’accès afin que le code de l’agent ne puisse pas demander ces jetons.
- Limitez le périmètre d’impact. Utilisez plusieurs blueprints lorsque des groupes d’agents s’exécutent dans différentes zones de confiance ou appartiennent à différents clients.
Planification des limites
Un principal de blueprint peut créer au maximum 250 identités d’agent. Pour une flotte plus grande, créez davantage de blueprints et affectez chaque agent à un blueprint lorsqu’il est approvisionné. Enregistrez le blueprint dans l’entrée de répertoire de l’agent. Pour plus d’informations, consultez Principals du blueprint d’identité d’agent.
Les articles d’implémentation qui suivent utilisent un blueprint par configuration d’exécution. Si vous les étendez à plusieurs blueprints, résolvez également la configuration et les informations d’identification correspondantes pour chaque agent ; La sélection d’un ID d’agent seul ne sélectionne pas un autre blueprint. L’exemple d’enregistrement de répertoire doit être étendu pour ce modèle.
Accorder l’accès à chaque agent
Donnez à chaque identité de l’agent uniquement l’accès dont cet agent a besoin. Accordez des autorisations d’application, des autorisations déléguées, des attributions de rôles Azure et un accès à d’autres ressources directement à l’identité de l’agent, dans le cadre de l’approvisionnement ou peu après. Les subventions par agent conservent l’accès de chaque agent séparément. Vous pouvez donc passer en revue, modifier ou révoquer l’accès d’un agent sans affecter le reste de la flotte. Pour connaître les façons d’accorder l’accès, consultez Accorder des autorisations d’application et accorder des autorisations déléguées.
Pour les autorisations dont chaque agent de la flotte a besoin, vous pouvez utiliser des autorisations pouvant être héritées comme commodité. Un administrateur accorde ces autorisations une fois sur le principal du plan, et chaque identité d’agent créée à partir du plan les reçoit dans ses jetons. Les autorisations héritées n’apparaissent pas sur l’identité de l’agent. Par conséquent, les autorisations accordées par agent sont plus faciles à auditer.
Acheminer les demandes des utilisateurs vers les agents
Les utilisateurs contactent un agent de flotte avec un jeton d’accès pour la portée du blueprint access_agent. Chaque agent dans la flotte partage ce public, de sorte que le jeton prouve qui est l’utilisateur, mais n’identifie pas l’agent. Le runtime doit :
- Déterminez l’agent cible à partir de la requête, par exemple à partir d’un segment de routage.
- Vérifiez que l’utilisateur est autorisé à utiliser cet agent. Les rôles d’application sur le blueprint s’appliquent à l’ensemble de la flotte. Par conséquent, appliquez l’accès par agent dans le runtime.
- Utilisez l’identité de l’agent cible pour toute demande de jeton OBO (On-Behalf-Of).
Étape suivante
Configurer un blueprint d’identité d’agent pour une flotte