Panoramica delle policy IAM

Puoi creare policy di autorizzazione e di negazione IAM che Agent Gateway utilizza per gestire in modo sicuro la comunicazione tra i tuoi agenti e altri servizi, inclusi altri agenti, server MCP ed endpoint. Agent Gateway utilizza Identity-Aware Proxy (IAP) per applicare le policy. IAP applica anche la sicurezza di autenticazione e autorizzazione dell'identità degli agenti end-to-end.

Per creare una policy IAM per Agent Gateway, consulta Crea policy IAM.

Puoi anche creare un confine di accesso dell'entità (PAB) sull'identità dell'agente. Agent Gateway può utilizzare IAP per applicare le policy sul confine di accesso dell'entità.

Abilita Agent Gateway

Per utilizzare le policy di comunicazione degli agenti, devi configurare Agent Gateway.

Ti consigliamo di configurare Agent Gateway in modalità dry run (DRY_RUN) in un ambiente di gestione temporanea per verificare che le policy funzionino come previsto. In modalità dry run, IAP registra le comunicazioni degli agenti non consentite in Cloud Audit Logs, ma non le blocca.

Quando hai la certezza che le policy funzionino correttamente, puoi aggiornare la configurazione di Agent Gateway per impostare la modalità di applicazione forzata su ENFORCE. In questa modalità, le comunicazioni degli agenti che violano la policy non sono consentite e le comunicazioni alla risorsa vengono bloccate.

Componenti delle policy

Le policy sono costituite dai seguenti componenti:

• Agenti: nelle policy di autorizzazione IAM, gli agenti di origine sono definiti dalla loro identità (l'identità dell'agente che avvia la comunicazione con un servizio). Per scoprire in che modo i diversi tipi di agenti ricevono le identità, consulta Identità dell'agente. Le identità degli agenti sono rappresentate da identificatori delle entità che contengono l'identità dell'agente formattata in SPIFFE, ad esempio principal://agents.global.org-.... Tieni presente che gli identificatori degli agenti in formato URN (come urn:agent:...) vengono utilizzati esclusivamente per la ricerca nell'inventario e nel catalogo e non vengono utilizzati nelle associazioni delle policy IAM. Quando utilizzi gcloud CLI per configurare la policy IAM, l'entità dell'agente è il membro a cui concedi l'accesso.

  Agli agenti Gemini Enterprise e alle istanze di Agent Runtime viene assegnata automaticamente un'identità agente e vengono registrati in Agent Registry.

• Risorsa Agent Registry: il servizio Agent Registry per cui concedi o neghi l'accesso. Nelle policy di autorizzazione e di negazione IAM, i servizi Agent Registry sono definiti risorse. La risorsa può essere un intero registry all'interno di un progetto o un singolo servizio, che può essere un server MCP, un agente o un endpoint.

  I singoli servizi devono essere registrati nel registro degli agenti prima di poter essere referenziati in una policy IAM. Questa registrazione viene convalidata al momento dell'associazione (quando l'associazione della policy viene creata o aggiornata). Se fai riferimento a un servizio non registrato, la creazione della policy non va a buon fine immediatamente e viene visualizzato l'errore Entità richiesta non trovata (NOT_FOUND).

  Quando configuri le policy utilizzando gcloud CLI o Terraform, le risorse di destinazione vengono specificate dai relativi ID o percorsi generati dal registry (utilizzando flag come --agent, --endpoint o --mcp-server), anziché dai relativi identificatori URN logici. In fase di runtime, il gateway sicuro associa le destinazioni del traffico in base al nome host esatto anziché utilizzare gli URN.

  Se regionalizzi i registri degli agenti, la policy di autorizzazione IAM si applica solo alle risorse che si trovano nella regione del registro.

• Ruolo: le policy di comunicazione degli agenti concedono sempre il ruolo IAP-secured Egressor (roles/iap.egressor) sulla risorsa di servizio.

• Condizione: facoltativamente, puoi configurare una condizione nella policy di autorizzazione IAM per limitare ulteriormente gli elementi a cui l'agente può accedere. Nella consoleCloud de Confiance , puoi utilizzare il generatore di condizioni per creare una condizione selezionando gli elementi UI. In alternativa, puoi utilizzare l'editor delle condizioni per inserire condizioni più complesse come espressioni Common Expression Language (CEL).

  La tabella seguente elenca i nomi degli attributi che puoi utilizzare per creare espressioni CEL. Poiché lo stile di accesso diretto ai campi (ad esempio request.mcp.toolName) non è supportato, devi utilizzare la funzione api.getAttribute() per recuperare il valore di ogni attributo.

  Per saperne di più su come configurare le policy di autorizzazione con condizioni, consulta Configura le policy dell'agente IAM.

  Nome attributo	Descrizione ed esempio di CEL
  mcp.toolName	Nome dello strumento specifico chiamato. Ad esempio: request.mcp.toolName == 'GetCalendarEvents'
  iap.googleapis.com/mcp.resourceName	Nome della risorsa a cui viene eseguito l'accesso. Ad esempio: api.getAttribute('iap.googleapis.com/mcp.resourceName', '') == 'my-resource'
  iap.googleapis.com/mcp.promptName	Nome del prompt utilizzato. Ad esempio: api.getAttribute('iap.googleapis.com/mcp.promptName', '') == 'my-prompt'
  mcp.method	L'operazione MCP specifica (ad es. tools/call, resources/read).
  iap.googleapis.com/mcp.tool.isReadOnly iap.googleapis.com/mcp.tool.isDestructive iap.googleapis.com/mcp.tool.isIdempotent iap.googleapis.com/mcp.tool.isOpenWorld	Flag booleani che indicano il tipo di operazione. Ad esempio: api.getAttribute('iap.googleapis.com/mcp.tool.isReadOnly', false) == true
  request.auth.type	Enum che indica il protocollo (ad es. "MCP").

Crea policy

Nella pagina Policy della console Cloud de Confiance , crei policy di autorizzazione e di negazione IAM che Agent Gateway utilizza per gestire le comunicazioni degli agenti.

In gcloud CLI, puoi configurare sia le policy di autorizzazione IAM sia le policy di negazione IAM utilizzate da Agent Gateway per gestire le comunicazioni degli agenti.

Policy nella console Cloud de Confiance

Per creare policy IAM utilizzando la console Cloud de Confiance , consulta Configura le policy IAM.

Policy in gcloud CLI

Per creare policy IAM utilizzando gcloud CLI, consulta Configura le policy IAM.

Autenticazione e autorizzazione end-to-end

IAP e l'accesso sensibile al contesto forniscono l'autenticazione e l'autorizzazione predefinite dell'identità dell'agente end-to-end utilizzando i seguenti protocolli:

• Mutual TLS (mTLS)
• Demonstrating Proof of Possession (DPoP)

Le identità degli agenti vengono sottoposte a provisioning con un certificato X.509 e un token associato al certificato. IAP impone alle identità degli agenti di utilizzare mutual TLS (mTLS) per l'autenticazione con Agent Gateway. Quando il gateway consente all'agente di uscire e accedere alle API Cloud de Confiance , ai server MCP, ad altri agenti ed endpoint, l'agente tenta di accedere al di fuori del confine mTLS. Per contribuire a proteggere le comunicazioni, l'accesso sensibile al contesto applica una policy di accesso sensibile al contesto gestita da Google. La policy richiede che DPoP convalidi il token associato al certificato, che è associato all'identità dell'agente. Per scoprire di più su come l'accesso sensibile al contesto fornisce la sicurezza mTLS e DPoP end-to-end, consulta Sicurezza dell'agente di accesso sensibile al contesto.

Passaggi successivi