Descripción general de las políticas de acceso unificado de IAM

Puedes crear políticas de acceso unificadas (UAP) de Identity and Access Management (IAM) para ayudar a controlar de forma segura la comunicación entre los principales de agentes y los recursos de destino, como los agentes de destino, los servidores de MCP y los extremos. Estas políticas están vinculadas al proyecto que contiene tus instancias de Agent Gateway.

Agent Gateway usa Identity-Aware Proxy (IAP) para evaluar y aplicar las UAP.

IAP también se integra en el acceso adaptado al contexto para proporcionar autenticación y autorización de identidad del agente de extremo a extremo.

Para configurar UAPs para Agent Gateway, consulta Configura UAPs de IAM.

También puedes crear un límite de acceso de la entidad (PAB) en la identidad del agente. Agent Gateway puede usar IAP para aplicar políticas de límite de acceso de las entidades.

Habilita Agent Gateway

Para usar políticas de comunicación basadas en agentes, debes configurar Agent Gateway.

Te recomendamos que configures Agent Gateway en el modo de ejecución de prueba (DRY_RUN) en un entorno de etapa de pruebas para verificar que tus políticas funcionen según lo previsto.

Cuando confirmes que las políticas funcionan correctamente, puedes actualizar la configuración de Agent Gateway para establecer el modo de aplicación forzosa en ENFORCE. En este modo, no se permiten las comunicaciones basadas en agentes que incumplan la política y se bloquea la comunicación con el recurso.

Descripción general de las UAP

Los UAP controlan si uno o más principales del agente pueden acceder a uno o más recursos de destino. Las UAP extienden el modelo de políticas de IAM, ya que admiten varias reglas en una sola política. A diferencia de las políticas de permisos y de denegación de IAM, cada regla de una UAP puede tener un efecto de permiso y un efecto de denegación. Obtén más información sobre los tipos de políticas de IAM.

Las reglas también contienen condiciones que se expresan en Common Expression Language (CEL). Las condiciones actúan como el mecanismo principal para controlar el acceso a los recursos posteriores a la puerta de enlace. La aplicación de las UAP con Agent Gateway y la IAP ofrece un control estricto del comportamiento de los agentes implementados en toda tu empresa. Puedes representar casos de uso de gobernanza de agentes detallados y del mundo real en una sola política.

Una política típica contiene al menos dos reglas distintas:

• Regla de permiso: Las reglas de permiso tienen un efecto de permiso que permite que los principales del agente accedan a operaciones específicas y seguras, como realizar una operación de lectura en una herramienta para recuperar datos de seguimiento o ver entradas de registro.
• Regla de denegación: Las reglas de denegación tienen un efecto de denegación que impide que el agente ejecute acciones no deseadas, como realizar una operación de actualización o eliminación no solicitada en un recurso crítico.

Por ejemplo, considera un agente de asistencia al cliente automatizado que necesita interactuar con herramientas internas que tienen acceso privilegiado a una base de datos de clientes. El administrador configura una puerta de enlace del agente con IAP para aplicar los UAP de IAM. El administrador puede configurar una UAP con una regla de permiso que autorice al principal del agente a leer tickets de asistencia y una regla de denegación que impida que el principal del agente borre o actualice registros de la base de datos.

Con el uso de UAP que contienen reglas de permiso y de denegación, las organizaciones pueden implementar una sola política de cumplimiento corporativo directamente en la infraestructura de nube subyacente para restringir el comportamiento del agente.

Prácticas recomendadas

Sigue estas prácticas recomendadas cuando configures las políticas de salida del agente:

• Usa el modo de ejecución de prueba: Primero, implementa las políticas nuevas o modificadas en el modo de ejecución de prueba para asegurarte de que funcionen según lo previsto, sin bloquear el tráfico de agentes activos.
• Aplica el principio de privilegio mínimo: Otorga solo los permisos necesarios. Usa nombres o rutas de herramientas específicos en las condiciones de CEL en lugar de comodines.
• Usa reglas de denegación para las barreras de seguridad: Usa reglas de denegación explícitas para implementar barreras de seguridad críticas, como bloquear herramientas destructivas en los extremos de producción. El uso de reglas de denegación para las protecciones es eficaz porque estas anulan las reglas de permiso.
• Realiza auditorías periódicas: Revisa periódicamente los registros de Registros de auditoría de Cloud y las configuraciones de políticas para verificar que cumplan con las políticas de seguridad de tu organización.

Componentes de la UAP

Las UAP contienen una o más reglas. Las reglas tienen los siguientes componentes:

Principales del agente

En tus UAP de IAM, defines una o más entidades principales del agente. Las principales del agente son los miembros a los que les otorgas acceso. Especificas los agentes por su identidad, que es la identidad del agente que inicia la comunicación con un recurso. Para obtener más información sobre cómo los diferentes tipos de agentes reciben identidades, consulta Identidad del agente. Las identidades del agente se representan con identificadores principales que contienen la identidad del agente con formato SPIFFE (por ejemplo, principal://agents.global.org-...).

Puedes especificar un array de identidades de agentes individuales o un array de conjuntos de principales.

Las identidades de agentes integradas se aprovisionan en todos los servicios de Cloud de Confiance , como Agent Runtime (Reasoning Engine), Gemini Enterprise (Discovery Engine) y los servicios de Cloud Run configurados con la identidad del agente. Estos principales del agente tienen la forma principal://TRUST_DOMAIN/AGENT_UNIQUE_IDENTIFIER, en la que el identificador representa la ruta de acceso del recurso del agente en su servicio de hosting. También puedes especificar agentes con identificadores principales de la federación de identidades para cargas de trabajo.

Efecto de la regla

El efecto de la regla define si la regla permite o rechaza que las entidades principales del agente accedan a un recurso.

Recursos de destino

Las UAP de IAM administran el acceso de los principales de agentes a los recursos de destino. Los recursos de destino son los recursos a los que los principales del agente intentan acceder. Los recursos de destino se especifican en las condiciones de la regla. Los recursos de destino pueden ser recursos registrados o recursos no registrados.

Recursos registrados

Los recursos registrados son aquellos que se registran en un registro de Agent Registry.

Los recursos registrados incluyen los siguientes:

• Registros: Registros de agentes completos dentro de un proyecto.
• Servidores de MCP: Son servidores de MCP registrados en un registro de agentes.
• Agentes: Son los agentes que están registrados en un registro de agentes. Los agentes individuales se pueden especificar de forma individual por su identidad de agente. Se puede especificar un grupo de agentes con un identificador de conjunto de entidades.
• Endpoints: Son los endpoints que se registran en un registro de agentes.

Los servicios individuales se pueden registrar en Agent Registry. Si regionalizas los registros de tu agente y tu regla administra el acceso a los recursos registrados, tus UAP se aplicarán solo a los recursos que se encuentren en la región del registro.

Recursos no registrados

Los recursos no registrados son aquellos que no están registrados en un registro de agentes. Para otorgar o denegar el acceso a recursos no registrados en tus reglas de la UAP, debes especificar los recursos no registrados en las condiciones de tus reglas con expresiones de Common Expression Language (CEL) que contengan atributos de host y ruta no registrados.

Condiciones

En las reglas de UAP, usas expresiones de Common Expression Language (CEL) en el bloque conditions para definir tanto el alcance del recurso objetivo como los criterios de acceso detallados:

• Alcance del recurso de destino: Identifica qué recursos de destino rige la regla. En los archivos de políticas con formato JSON, se especifican atributos de destino, como destination.agent_registry.mcp_server.name o destination.unregistered.host. En la consola de Cloud de Confiance , si seleccionas destinos en Recursos objetivo, se agregarán automáticamente estos criterios de recursos a la expresión de condición de la regla.

• Criterios de acceso: Usa una expresión booleana para determinar cuándo y bajo qué restricciones se aplica el efecto de la regla. Por ejemplo, puedes restringir el acceso según los nombres de las herramientas, el estado de solo lectura, los métodos HTTP o los prefijos de ruta de acceso con los atributos de CEL de la UAP. El efecto de la regla (permitir o rechazar) solo se aplica cuando toda la expresión CEL se evalúa como true.

En gcloud CLI y la API de REST, especificas estas expresiones de CEL en el campo conditions de la definición de la regla.

En la consola de Cloud de Confiance , puedes configurar reglas estándar con el Creador de condiciones o escribir expresiones CEL personalizadas directamente en el Editor de condiciones.

Permisos

En IAP V2 con UAP de IAM, el permiso iap.googleapis.com/resources.egressViaIAP siempre se otorga en el recurso de destino. En gcloud CLI y la API de REST, especificas el permiso en el campo operation.permissions de tu archivo de política.

Opciones de creación de políticas

En la página Políticas de la consola de Cloud de Confiance , puedes crear UAP de IAM. Te recomendamos que solo crees UAPs (políticas de IAM v3).

Tanto en gcloud CLI como en la API de REST, puedes configurar UAP de IAM. Para ello, primero debes crear un archivo con formato JSON. Te recomendamos que solo crees UAPs.

Autenticación y autorización de extremo a extremo

IAP y el acceso adaptado al contexto proporcionan autenticación y autorización de identidad de agente de extremo a extremo predeterminadas con los siguientes protocolos:

• TLS mutua (mTLS)
• Cómo demostrar la prueba de posesión (DPoP)

Las identidades de los agentes se aprovisionan con un certificado X.509 y un token vinculado al certificado. IAP exige que las identidades de agente usen TLS mutua (mTLS) para autenticarse en Agent Gateway. Cuando la puerta de enlace permite que el agente salga y acceda a las APIs Cloud de Confiance , los servidores de MCP, otros agentes y extremos, el agente intenta acceder fuera del límite de mTLS. Para ayudar a proteger la comunicación, el acceso adaptado al contexto aplica una política de acceso adaptado al contexto administrada por Google. La política requiere que DPoP valide el token vinculado al certificado que está vinculado a la identidad del agente. Para obtener más información sobre cómo el Acceso adaptado al contexto usa mTLS y DPoP, consulta Seguridad del agente de Acceso adaptado al contexto.

Atributos de CEL de UAP

En tus UAP, puedes definir condiciones con expresiones condicionales. Las expresiones pueden contener varias subexpresiones. El tipo de recurso de destino que usas en cada subcondición relacional determina qué atributos puedes usar.

Por ejemplo, en la siguiente condición, en la subexpresión destination.unregistered.path.startsWith('/v1/statements'), el tipo de recurso es un destino no registrado, el atributo es destination.unregistered.path y startsWith() es la función CEL.

destination.unregistered.host == 'finance.example.com' &&
destination.unregistered.path.startsWith('/v1/statements')

Los atributos que se describen en la siguiente tabla están disponibles para cada tipo de recurso:

¿Qué sigue?

• Atributos de CEL para los UAP
• Crea UAP de IAM
• Administrar UAP de IAM
• Soluciona problemas de las UAP de IAM