Descripción general de la identidad del agente

Agent Identity proporciona una identidad criptográfica y fuertemente atestiguada para cada agente que se basa en el estándar SPIFFE. Con Agent Identity, tu agente puede autenticarse de forma segura en servidores MCP, recursos de la nube, extremos y otros agentes, ya sea en su propio nombre o en nombre de un usuario final. Agent Identity usa la propia credencial del agente y el administrador de autenticación de Agent Identity. Puedes usar el administrador de autenticación para crear y administrar proveedores de autenticación, que son las configuraciones específicas que se usan para adquirir, administrar y proteger claves de API, IDs de cliente de OAuth, secretos de cliente de OAuth y tokens de OAuth de usuario final delegados.

A diferencia de las cuentas de servicio, las identidades de los agentes no se comparten con varias cargas de trabajo de forma predeterminada, no se pueden suplantar y no permiten que los desarrolladores generen claves de cuenta de servicio de larga duración. Los tokens de acceso generados para Google Cloud se vinculan de forma criptográfica a los certificados X.509 únicos del agente para evitar el robo de tokens.

Cuando se usa Agent Identity con Agent Gateway y Gemini Enterprise, el administrador de autenticación encripta las credenciales del usuario final, como las que proporcionan los conectores de Gemini Enterprise, y la puerta de enlace las desencripta, lo que garantiza que el agente nunca pueda acceder a la credencial sin procesar.

Los siguientes servicios admiten Agent Identity:

Modelos de autenticación

Para autenticarse con varias herramientas y servicios, Agent Identity admite varios modelos de autenticación. El modelo que usa un agente depende del método de autenticación que ofrece el recurso de destino y de si el agente actúa por su propia autoridad o en nombre de un usuario final.

Autoridad Método de autenticación Recurso objetivo Caso de uso y solución
Autoridad delegada por el usuario OAuth 2.0 (de 3 segmentos) Herramientas y servicios externos Cuando un agente actúa en nombre de un usuario específico (por ejemplo, para acceder a las tareas de Jira o los repositorios de GitHub de un usuario). Configuras un proveedor de autenticación de OAuth de 3 segmentos en el administrador de autenticación de Agent Identity para administrar el consentimiento y los tokens del usuario. Para obtener más información, consulta Autentica con OAuth de 3 segmentos con el administrador de autenticación.
Autoridad propia del agente Identidad basada en la nube (Agent Identity) Google Cloud Servicios de Cuando un agente alojado en Google Cloud necesita acceder a otros Google Cloud servicios con su propia identidad. Para obtener más información, consulta Autentica con la propia identidad de un agente.
OAuth 2.0 (de 2 segmentos) Herramientas y servicios externos Se recomienda para la autenticación de máquina a máquina con servicios externos que admiten OAuth. Configuras un proveedor de autenticación de OAuth de 2 segmentos en el administrador de autenticación de Agent Identity para controlar las credenciales de cliente y los tokens de acceso. Para obtener más información, consulta Autentica con OAuth de 2 segmentos con el administrador de autenticación.
Clave de API Herramientas y servicios externos Para servicios externos que requieren una clave criptográfica o una contraseña para autenticación. Configuras un proveedor de autenticación de clave de API en el administrador de autenticación de Agent Identity para ayudar a almacenar y administrar las claves de forma segura. Para obtener más información, consulta Autentica con una clave de API con el administrador de autenticación.
Autenticación básica HTTP Herramientas y servicios externos Usa contraseñas de texto simple. No se recomienda este método. Puedes almacenar contraseñas similares a la clave de API. Para obtener más información, consulta Autentica con una clave de API con el administrador de autenticación.

Componentes centrales

Agent Identity incluye varios componentes clave que, en conjunto, ayudan a proporcionar autenticación y autorización seguras.

Identidad basada en SPIFFE

A cada agente se le asigna una cadena de identidad única, o ID de SPIFFE, según el estándar SPIFFE. Esta identidad está fuertemente atestiguada, vinculada al ciclo de vida del agente y asignada directamente al URI del recurso en el que se aloja el agente.

La identidad sigue este formato:

spiffe://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH

Por ejemplo:

  • spiffe://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

Cuando se usa una identidad de agente en una política de permisos de IAM, el identificador principal sigue este formato:

principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH

Ejemplos:

  • Agent Runtime: principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent
  • Gemini Enterprise: principal://agents.global.org-123456789012.system.id.goog/resources/discoveryengine/projects/9876543210/locations/global/collections/default_collection/engines/my-test-agent

Los identificadores usan lo siguiente:

  • TRUST_DOMAIN: El dominio de confianza de tu organización (por ejemplo, agents.global.org-123456789012.system.id.goog).
  • SERVICE: El nombre abreviado del Google Cloud servicio (por ejemplo, aiplatform o discoveryengine).
  • RESOURCE_PATH: La ruta de acceso completa al recurso que aloja el agente.

Como el agente en sí es la principal, le otorgas permisos directamente a este identificador para controlar a qué recursos puede acceder el agente.

Credenciales del agente

Las credenciales del agente proporcionan una prueba criptográfica de la identidad de un agente. El sistema admite certificados X.509 y Google Cloud tokens de acceso. Un certificado X.509 se aprovisiona y administra automáticamente en el agente para ayudar a admitir una autenticación más sólida.

De forma predeterminada, las identidades de los agentes usan TLS mutua (mTLS) con certificados X.509 cuando se comunican directamente con Google Cloud las APIs. Cuando los agentes interactúan a través de Agent Gateway, también usan la demostración de prueba de posesión (DPoP), lo que crea credenciales de doble vinculación para la seguridad de extremo a extremo. Esta doble vinculación significa que los agentes se autentican con mTLS para el acceso de origen a la puerta de enlace y usan DPoP para las interacciones más allá de la puerta de enlace.

Administrador de autenticación de identidad del agente

El administrador de autenticación de Agent Identity es un almacén de credenciales centralizado y un agente de autenticación que simplifica la autenticación de herramientas salientes para tus agentes. Permite que los agentes se autentiquen con una clave de API o un ID y un secreto de cliente de OAuth, o en nombre de un usuario a través de la delegación de OAuth con tokens de acceso de usuario final. Dentro del administrador de autenticación, configuras proveedores de autenticación que definen el tipo de autenticación y las credenciales para aplicaciones específicas de terceros.

El acceso al administrador de autenticación de Agent Identity se rige por IAM, y el agente usa su propio ID de SPIFFE de agente para autenticarse en el administrador de autenticación. Todos los eventos de acceso del usuario final también se pueden atribuir al ID de SPIFFE del agente, lo que permite una administración sencilla.

El administrador de autenticación de Agent Identity automatiza la adquisición de credenciales de OAuth, como la apertura de un diálogo para el acceso y el consentimiento del usuario. También proporciona visibilidad del acceso del usuario final y permite la revocación del acceso, lo que garantiza una mejor administración de los permisos delegados por el usuario.

Para obtener más información, consulta la descripción general del administrador de autenticación de Agent Identity.

Seguridad y administración

Agent Identity está completamente integrado con los sistemas de políticas de Google, como IAM, el límite de acceso de la entidad (PAB) y los Controles del servicio de VPC, que permiten mejorar la seguridad y la administración. También se integra con el registro de auditoría para garantizar la responsabilidad y proporcionar registros de auditoría claros cuando el agente actúa por sí mismo y cuando lo hace en nombre de un usuario final.

  • Acceso adaptado al contexto: De forma predeterminada, una política de Acceso adaptado al contexto administrada por Google ayuda a proteger las credenciales del agente mediante la aplicación de mTLS y la vinculación de tokens DPoP. Este enfoque garantiza que los tokens vinculados a certificados no se puedan reproducir fuera de su entorno de ejecución de confianza.
  • Integración de IAM: Compatibilidad con políticas de permisos y denegación de IAM estándar.
  • Límite de acceso de la entidad (PAB): Un PAB limita los recursos a los que puede acceder un agente, independientemente de otros permisos.
  • Controles del servicio de VPC: Compatibilidad con la protección perimetral y el uso de la principal:
    • Protección perimetral: Puedes agregar la API de Agent Identity (agentidentity.googleapis.com) y la API de Agent Identity Credentials (agentidentitycredentials.googleapis.com) a un perímetro de servicio para ayudar a controlar el acceso a estas APIs. Para usar estas APIs dentro de un perímetro de servicio, los clientes deben enrutar las solicitudes a través de la VIP restringida (restricted.googleapis.com).
    • Reglas de entrada y salida: Compatibilidad para usar identidades de agentes como principales en reglas de entrada y salida para permitir el acceso a recursos protegidos por un perímetro de servicio.

Cómo funciona Agent Identity

Agent Identity autentica y autoriza las acciones del agente a través de un flujo de trabajo diseñado para ayudar a mejorar la seguridad:

  1. Asignación de identidad: Cuando implementas un agente, Google Cloud le asigna una identidad SPIFFE única y un certificado X.509. Cada certificado X.509 es válido por 24 horas y Google Cloud lo mantiene actualizado automáticamente para mantener la seguridad.
  2. Adquisición de credenciales: El método que usan los agentes para adquirir credenciales depende de a qué intentan acceder. Estos son algunos ejemplos:
    • Acceder Google Cloud a servicios: El agente solicita un token de acceso vinculado. Este token está vinculado de forma criptográfica al certificado X.509 único del agente para ayudar a evitar el robo de tokens. Para obtener más información, consulta Seguridad y administración.
    • Acceder a herramientas externas: El agente usa el administrador de autenticación de Agent Identity para recuperar las credenciales necesarias (como claves de API o tokens de OAuth) de un proveedor de autenticación. El administrador de Auth admite tanto la autoridad delegada por el usuario como la autoridad propia del agente.

Beneficios de Agent Identity

Agent Identity mejora la seguridad de las cuentas de servicio estándar.

  • Aislamiento sólido: A diferencia de las cuentas de servicio, las identidades de los agentes no se comparten con varias cargas de trabajo de forma predeterminada, no se pueden suplantar y no permiten que los desarrolladores generen claves de cuenta de servicio de larga duración.
  • Seguridad de las credenciales: Las políticas predeterminadas de Acceso adaptado al contexto hacen que los tokens vinculados no se puedan reproducir, lo que ayuda a proteger contra el robo de tokens y la apropiación de cuentas. Cuando se usa Agent Identity con Agent Gateway y Gemini Enterprise, el administrador de autenticación encripta las credenciales del usuario final, como las que proporcionan los conectores de Gemini Enterprise, y la puerta de enlace las desencripta, lo que garantiza que el agente nunca pueda acceder a la credencial sin procesar.
  • Enfoque de privilegio mínimo: Proporciona identidades por agente en lugar de cuentas de servicio compartidas para eliminar los agentes con exceso de permisos.
  • Reducción de la fricción: Automatiza flujos de OAuth complejos y administra claves de API para una integración de herramientas más simple.
  • Observabilidad mejorada: Proporciona registros de auditoría claros. Cuando un agente actúa en nombre de un usuario, los registros muestran las identidades del agente y del usuario.

Limitaciones

  • Funciones heredadas de bucket de Cloud Storage: No puedes otorgar identidades de agentes a funciones heredadas de bucket (por ejemplo, storage.legacyBucketReader).

¿Qué sigue?