Lorsque votre agent orchestrateur appelle un agent Agent2Agent (A2A) distant, la définition du champ d'application des identifiants permet de s'assurer que l'agent distant ne reçoit que les autorisations nécessaires pour cette requête. Après avoir découvert un agent dans le registre d'agents, vous pouvez inclure les identifiants de votre utilisateur ou générer des jetons limités à l'aide du gestionnaire d'authentification Agent Identity avec des champs d'application OAuth restreints ou des limites d'accès aux identifiants pour Cloud Storage.
Avant de commencer
Avant de limiter les autorisations des agents avec des identifiants limités pour les appels A2A, procédez comme suit :
- Configurer le registre d'agents.
Pour une configuration à projet unique, obtenez l'ID de projet du projet de gouvernance où le registre d'agents est activé. Si vous avez configuré une limite de gestion pour plusieurs projets, utilisez l'ID de votre projet de gestion pour la découverte et l'enregistrement à l'échelle de la limite, ou spécifiez l'ID d'un projet membre pour les opérations sur un seul projet.
Si vous souhaitez restreindre les jetons Cloud Storage, activez l'API Security Token Service (
sts.googleapis.com) dans votre projet.Installez les bibliothèques Python
google-authetrequests:pip install --upgrade google-auth requestsConfigurez les identifiants par défaut de l'application (ADC) pour le développement local. Sinon, associez un compte de service ou une configuration d'identifiants de fédération d'identité de charge de travail :
gcloud auth application-default login
Rôles requis
Vous pouvez utiliser votre compte utilisateur pour le développement local, ou un compte de service ou un principal d'agent pour que votre agent orchestrateur découvre les agents enregistrés et appelle les agents A2A cibles. Le compte utilisateur, le compte de service ou le principal d'agent doit disposer des rôles appropriés pour effectuer ces tâches.
Pour vous assurer que votre compte utilisateur, votre compte de service ou votre principal d'agent dispose des autorisations nécessaires pour découvrir les agents A2A dans Agent Registry et appeler les agents A2A cibles, demandez à votre administrateur d'accorder les rôles IAM suivants à votre compte utilisateur, votre compte de service ou votre principal d'agent :
-
Pour découvrir des agents dans Agent Registry : Lecteur de l'API Agent Registry (
roles/agentregistry.viewer) sur le projet de gouvernance où Agent Registry est activé -
Pour appeler un agent A2A cible au moment de l'exécution : rôle d'exécution ou de passerelle pour le service qui héberge l'agent cible, requis pour appeler cet agent. Par exemple, si l'agent cible s'exécute sur Cloud Run, le compte ou le compte principal doit disposer du rôle Demandeur Cloud Run (
roles/run.invoker).
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Votre administrateur peut également attribuer à votre compte utilisateur, à votre compte de service ou à votre principal d'agent les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Comment les identifiants sont transmis entre les agents
Lorsqu'un client A2A ou un agent orchestrateur envoie un message à un agent distant, les services en aval vérifient les autorisations en fonction de la manière dont la requête est authentifiée :
- Au nom d'un utilisateur : un utilisateur se connecte à votre agent d'orchestration, qui transmet un jeton OAuth 2.0 autorisé par l'utilisateur ou un jeton géré par le gestionnaire d'authentification à l'agent A2A distant. Les API Google Cloud vérifient le jeton et les autorisations IAM (Identity and Access Management) de l'utilisateur afin que l'agent distant ne puisse pas accéder aux ressources auxquelles l'utilisateur n'est pas autorisé à accéder.
- Utiliser l'identité de l'agent : lorsqu'un agent orchestrateur s'exécute sans utilisateur connecté, il s'authentifie avec sa propre identité d'agent ou son propre compte de service. Les services en aval vérifient les rôles attribués au compte principal de cet agent (
principal://), à un ensemble de comptes principaux correspondant (principalSet://) ou à son compte de service. - À partir de charges de travail externes ou cross-cloud : les agents exécutés en dehors deGoogle Cloud échangent des jetons d'un fournisseur d'identité externe via la fédération d'identité de charge de travail pour obtenir des jetons d'accès Google Cloud fédérés avant d'appeler les points de terminaison de l'agent A2A cible.
Pour limiter les autorisations qu'un jeton accorde à un agent distant, vous pouvez limiter le champ d'application des jetons OAuth avec des liaisons pour les agents A2A tiers ou SaaS.
Vous pouvez également restreindre les jetons Cloud Storage à l'aide d'une limite d'accès aux identifiants pour limiter un jeton d'accès Google Cloud à des buckets ou des objets Cloud Storage spécifiques. Les limites d'accès aux identifiants ne sont compatibles qu'avec les autorisations Cloud Storage (storage.googleapis.com). Pour les autres API Google Cloud et les appels d'agent A2A, limitez l'accès via des liaisons de gestionnaire d'authentification, des identités d'agent avec privilèges minimaux avec des stratégies d'autorisation et de refus IAM ou Agent Gateway.
Si ces options ne correspondent pas à votre cas d'utilisation et que votre agent d'orchestrateur s'authentifie avec un compte de service, vous pouvez également utiliser l'emprunt d'identité d'un compte de service pour demander un jeton de courte durée pour un compte de service dédié qui ne dispose que des rôles nécessaires à une tâche spécifique.
Limiter les jetons OAuth avec des liaisons
Lorsque vous appelez un agent A2A tiers ou SaaS qui utilise OAuth 2.0 à deux ou trois acteurs, créez un fournisseur d'authentification dans le gestionnaire d'authentification et associez une ressource Binding dans le registre d'agents qui ne liste que les scopes OAuth dont l'agent distant a besoin. Lorsque Agent Development Kit (ADK) récupère l'agent distant à l'aide de get_remote_a2a_agent(), il demande des jetons limités aux champs d'application de cette liaison. Pour connaître la procédure de configuration, consultez S'authentifier auprès des outils et des ressources et Gérer les liaisons.
Limiter les jetons Cloud Storage
Si votre agent orchestrateur transmet un jeton d'accès OAuth 2.0 à un agent ou à un outil qui lit ou écrit des données Cloud Storage, vous pouvez réduire les autorisations du jeton pour n'autoriser l'accès qu'à des buckets ou des préfixes d'objets spécifiques. Utilisez Security Token Service pour appliquer une limite d'accès aux identifiants avant d'envoyer la requête :
import google.auth
from google.auth import downscoped
from google.auth.transport.requests import Request
source_creds, _ = google.auth.default(
scopes=["https://www.googleapis.com/auth/cloud-platform"]
)
access_boundary_rule = downscoped.AccessBoundaryRule(
available_resource=(
"//storage.googleapis.com/projects/_/buckets/BUCKET_NAME"
),
available_permissions=["inRole:roles/storage.objectViewer"],
)
cab = downscoped.CredentialAccessBoundary(rules=[access_boundary_rule])
downscoped_creds = downscoped.Credentials(
source_credentials=source_creds,
credential_access_boundary=cab,
)
downscoped_creds.refresh(Request())
Remplacez BUCKET_NAME par le nom du bucket Cloud Storage que l'agent distant peut lire.
Contrôles de sécurité supplémentaires
Vous pouvez combiner la définition du champ d'application des identifiants avec des règles de réseau et l'inspection des requêtes :
- Stratégies d'accès réseau : acheminent les appels A2A via Agent Gateway pour appliquer les stratégies d'accès unifiées (UAP) d'Identity-Aware Proxy (IAP) aux ressources
Agentenregistrées. - Inspection des prompts et des réponses : configurez l'intégration de Model Armor à Agent Gateway et les liaisons d'extension de service pour inspecter les prompts et les réponses A2A compatibles afin de détecter les injections de prompts et l'exposition de données sensibles.
Étapes suivantes
- Configurez les liaisons OAuth à deux et trois acteurs dans S'authentifier auprès des outils et des ressources.
- Appelez les points de terminaison de l'agent A2A cible à l'aide de jetons OAuth 2.0 et OIDC dans Créer des systèmes multi-agents et appeler des agents A2A.
- Consultez les rôles pour appeler des agents A2A et les stratégies de refus IAM dans Rôles et autorisations.