Descripción general del administrador de autenticación de identidad del agente

Cuando los agentes de IA generativa interactúan con herramientas, APIs o servicios externos (como BigQuery, Jira, GitHub o Google Maps), necesitan un mecanismo seguro para autenticar las solicitudes salientes. El administrador de autenticación de Agent Identity (administrador de autenticación) proporciona esto actuando como un almacén de credenciales centralizado y un agente de autenticación que simplifica la autenticación de herramientas salientes.

Beneficios de usar el administrador de autenticación

El administrador de autenticación proporciona los siguientes beneficios para el desarrollo de agentes:

  • Almacén de credenciales centralizado: Almacena claves de API, secretos de cliente de OAuth y tokens de usuario en un almacén administrado por Google, lo que ayuda a evitar secretos codificados y almacenamiento de bases de datos personalizado.
  • OAuth 2.0 automatizado: Controla los flujos de OAuth 2.0 de varios pasos, como el consentimiento del usuario, el intercambio de códigos de autorización y las actualizaciones de tokens, sin código de backend personalizado.
  • Integración perfecta con el ADK: Se integra de forma nativa con el Kit de desarrollo de agentes (ADK) para recuperar e insertar encabezados de autenticación salientes, como Authorization o X-Goog-Api-Key, en las invocaciones de herramientas y del servidor del protocolo de contexto de modelo (MCP).
  • Control de acceso detallado con IDs de SPIFFE: Usa identidades de agentes basadas en SPIFFE para definir políticas precisas de Identity and Access Management (IAM), lo que ayuda a garantizar que solo los principales de agentes y los desarrolladores autorizados puedan acceder a proveedores de autenticación específicos.

Cómo funciona el administrador de autenticación

El administrador de autenticación actúa como una bóveda de credenciales entre tu entorno de Agent Runtime en Gemini Enterprise Agent Platform y los extremos de servicios externos.

Cuando un agente llama a una herramienta externa, el ADK intercepta la ejecución de la herramienta, solicita la credencial adecuada de la bóveda del administrador de autenticación y adjunta los encabezados de autenticación requeridos antes de enviar la solicitud a la API de destino.

En el siguiente diagrama de flujo, se ilustra la arquitectura de alto nivel y el ciclo de vida de recuperación de credenciales: Diagrama de arquitectura de recuperación de credenciales salientes.

  1. El usuario final activa un evento o una instrucción que requiere autenticación de herramientas salientes.
  2. El agente implementado (con el ADK) intercepta de forma transparente la solicitud de la herramienta y consulta la bóveda segura del administrador de autenticación.
  3. El administrador de autenticación devuelve la credencial segura (clave de API o token de OAuth) al agente.
  4. El agente invoca la API o la herramienta externa con la credencial adjunta.
  5. El servicio de terceros valida la credencial y devuelve los datos solicitados al agente.
  6. El agente usa los datos que se devuelven para generar y entregar la respuesta final al usuario.

Ejemplos de integraciones de terceros

El administrador de autenticación admite patrones estándar de OAuth 2.0 y claves de API, lo que lo hace compatible con muchos servicios de terceros.

En la siguiente tabla, se enumeran algunos servicios de terceros verificados, sus métodos de autenticación compatibles y la documentación de configuración.

Servicio Métodos de autenticación compatibles Documentación de configuración de credenciales
Jira de Atlassian OAuth de 3 segmentos, clave de API Guía de OAuth 2.0 de Jira
Dropbox OAuth de 3 segmentos Guía de OAuth de Dropbox
GitHub OAuth de 3 segmentos Apps de OAuth de GitHub
GitLab OAuth de 3 segmentos Proveedor de OAuth de GitLab
Microsoft OAuth de 3 segmentos* Plataforma de identidad de Microsoft
Salesforce OAuth de 3 segmentos, OAuth de 2 segmentos Apps conectadas de Salesforce
ServiceNow OAuth de 3 segmentos*, OAuth de 2 segmentos Configuración de OAuth de ServiceNow

* Para obtener detalles sobre las limitaciones y los requisitos del servicio, consulta Consideraciones específicas del servicio.

Consideraciones específicas del servicio

  • Microsoft: El administrador de autenticación admite integraciones de un solo permiso para Microsoft. El administrador de autenticación no admite la solicitud de varios permisos. Para obtener más información, consulta Error de varios permisos de Microsoft.
  • ServiceNow: En ServiceNow, los administradores configuran los permisos permitidos a nivel de la aplicación. Independientemente de lo que solicite un agente, ServiceNow solo otorga estos permisos configurados. Si un agente requiere un permiso que no está configurado, es posible que la autenticación falle o ingrese en un bucle de solicitudes. Asegúrate de que la configuración de la aplicación de ServiceNow incluya todos los permisos que requiere tu agente. Para obtener más información, consulta Bucle de autenticación de ServiceNow o permisos inesperados.

Ubicaciones

El administrador de autenticación de Agent Identity está disponible en regiones de América, Europa y Asia-Pacífico. Para obtener una lista de las regiones admitidas, consulta Ubicaciones de Agent Identity.

¿Qué sigue?