Lorsque les agents d'IA générative interagissent avec des outils, des API ou des services externes (comme BigQuery, Jira, GitHub ou Google Maps), ils ont besoin d'un mécanisme sécurisé pour authentifier les requêtes sortantes. Le gestionnaire d'authentification Agent Identity (gestionnaire d'authentification) fournit cette fonctionnalité en agissant comme un coffre-fort d'identifiants centralisé et un courtier d'authentification qui simplifie l'authentification des outils sortants.
Avantages du gestionnaire d'authentification
Le gestionnaire d'authentification offre les avantages suivants pour le développement d'agents :
- Coffre-fort d'identifiants centralisé : stocke les clés API, les codes secrets du client OAuth et les jetons utilisateur dans un coffre-fort géré par Google, ce qui permet d'éviter les secrets codés en dur et le stockage de base de données personnalisé.
- OAuth 2.0 automatisé : gère les flux OAuth 2.0 en plusieurs étapes, tels que le consentement utilisateur, l'échange de codes d'autorisation et l'actualisation des jetons, sans code de backend personnalisé.
- Intégration transparente d'ADK : s'intègre de manière native à Agent Development Kit (ADK) pour récupérer et injecter des en-têtes d'authentification sortants, tels que
AuthorizationouX-Goog-Api-Key, dans les appels d'outils et de serveurs MCP (Model Context Protocol). - Contrôle des accès précis aux ID SPIFFE : utilise des identités d'agent basées sur SPIFFE pour définir des stratégies IAM (Identity and Access Management) précises, ce qui permet de s'assurer que seuls les principaux d'agent et les développeurs autorisés peuvent accéder à des fournisseurs d'authentification spécifiques.
Fonctionnement du gestionnaire d'authentification
Le gestionnaire d'authentification agit comme un coffre-fort d'identifiants entre votre environnement Agent Runtime sur Gemini Enterprise Agent Platform et les points de terminaison de service externes.
Lorsqu'un agent appelle un outil externe, l'ADK intercepte l'exécution de l'outil, demande l'identifiant approprié au coffre-fort du gestionnaire d'authentification et associe les en-têtes d'authentification requis avant d'envoyer la requête à l'API cible.
Le diagramme de flux suivant illustre l'architecture générale et le cycle de vie de la récupération des identifiants :
- L'utilisateur final déclenche un événement ou un prompt qui nécessite l'authentification de l'outil sortant.
- L'agent déployé (à l'aide de l'ADK) intercepte de manière transparente la requête de l'outil et interroge le coffre-fort du gestionnaire d'authentification sécurisé.
- Le gestionnaire d'authentification renvoie l'identifiant sécurisé (clé API ou jeton OAuth) à l'agent.
- L'agent appelle l'API ou l'outil externe avec l'identifiant associé.
- Le service tiers valide l'identifiant et renvoie les données demandées à l'agent.
- L'agent utilise les données renvoyées pour générer et fournir la réponse finale à l'utilisateur.
Exemples d'intégrations tierces
Le gestionnaire d'authentification est compatible avec les modèles standards OAuth 2.0 et de clé API, ce qui le rend compatible avec de nombreux services tiers.
Le tableau suivant liste certains services tiers validés, leurs méthodes d'authentification compatibles et la documentation de configuration.
| Service | Méthodes d'authentification compatibles | Documentation sur la configuration des identifiants |
|---|---|---|
| Atlassian Jira | OAuth en trois étapes, clé API | Guide Jira OAuth 2.0 |
| Dropbox | OAuth en trois étapes | Guide OAuth de Dropbox |
| GitHub | OAuth en trois étapes | Applications OAuth GitHub |
| GitLab | OAuth en trois étapes | Fournisseur OAuth GitLab |
| Microsoft | OAuth en trois étapes* | Plate-forme d'identité Microsoft |
| Salesforce | OAuth en trois étapes, OAuth en deux étapes | Applications connectées Salesforce |
| ServiceNow | OAuth en trois étapes*, OAuth en deux étapes | Configuration d'OAuth pour ServiceNow |
* Pour en savoir plus sur les limites et les exigences du service, consultez Considérations spécifiques au service.
Remarques spécifiques au service
- Microsoft : le gestionnaire d'authentification est compatible avec les intégrations à champ d'application unique pour Microsoft. Le gestionnaire d'authentification n'est pas compatible avec les requêtes portant sur plusieurs champs d'application. Pour en savoir plus, consultez Erreur de champs d'application multiples Microsoft.
- ServiceNow : dans ServiceNow, les administrateurs configurent les champs d'application autorisés au niveau de l'application. Quelle que soit la demande d'un agent, ServiceNow n'accorde que ces champs d'application configurés. Si un agent nécessite un champ d'application qui n'est pas configuré, l'authentification peut échouer ou entrer dans une boucle de requêtes. Assurez-vous que la configuration de l'application ServiceNow inclut tous les champs d'application requis par votre agent. Pour en savoir plus, consultez Boucle d'authentification ServiceNow ou champs d'application inattendus.
Emplacements
Le gestionnaire d'authentification Agent Identity est disponible dans plusieurs régions d'Amérique, d'Europe et d'Asie-Pacifique. Pour obtenir la liste des régions prises en charge, consultez Emplacements d'Agent Identity.
Étapes suivantes
- S'authentifier à l'aide d'une clé API avec le gestionnaire d'authentification
- S'authentifier à l'aide d'OAuth à deux acteurs avec le gestionnaire d'authentification
- S'authentifier à l'aide d'OAuth en trois étapes avec le gestionnaire d'authentification
- Présentation de l'identité de l'agent
- Gérer les fournisseurs d'authentification Agent Identity
- Emplacements d'Agent Identity
- Résoudre les problèmes liés au gestionnaire d'authentification Agent Identity