Panoramica delle policy IAM

Puoi creare policy di autorizzazione e 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à dell'agente end-to-end.

Per creare una policy IAM per Agent Gateway, consulta Creare 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à.

Attiva Agent Gateway

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

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

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

Componenti delle policy

Le policy hanno i 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 come i diversi tipi di agenti ricevono le identità, consulta Identità dell'agente. Le identità dell'agente sono rappresentate da identificatori dell'entità che contengono l'identità dell'agente in formato SPIFFE, ad esempio, principal://agents.global.org-.... Tieni presente che gli identificatori dell'agente in formato URN (ad esempio urn:agent:...) vengono utilizzati esclusivamente per la ricerca di inventari e cataloghi e non vengono utilizzati nelle associazioni di 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 su cui stai concedendo o negando l'accesso. Nelle policy di autorizzazione e negazione IAM, i servizi Agent Registry sono indicati come 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 un criterio IAM. Questa registrazione viene convalidata al momento del binding (quando viene creato o aggiornato il binding della policy). Se fai riferimento a un servizio non registrato, la creazione delle norme non va a buon fine immediatamente e viene visualizzato l'errore Entità richiesta non trovata (NOT_FOUND).

  Quando configuri i criteri utilizzando gcloud CLI o Terraform, le risorse di destinazione vengono specificate dai relativi percorsi o ID creati dal registro (utilizzando flag come --agent, --endpoint o --mcp-server), anziché dai relativi identificatori URN logici. In fase di runtime, il gateway di sicurezza corrisponde alle destinazioni del traffico in base al nome host esatto anziché utilizzando 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 del servizio.

• Condizione: puoi configurare facoltativamente una condizione nella policy di autorizzazione IAM per limitare ulteriormente l'accesso dell'agente. Nella Cloud de Confiance console, 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 seguente tabella 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 es. 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	Il nome del prompt in uso. 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	Enumerazione che indica il protocollo (ad es. "MCP").

Crea criteri

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

Nella gcloud CLI, puoi configurare sia le policy di autorizzazione IAM sia quelle di negazione IAM che Agent Gateway utilizza per regolare le comunicazioni degli agenti.

Criteri nella console Cloud de Confiance

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

Norme in gcloud CLI

Per creare criteri IAM utilizzando gcloud CLI, consulta Configurare i criteri IAM.

Autenticazione e autorizzazione end-to-end

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

• mutual TLS (mTLS)
• Dimostrazione della prova di possesso (DPoP)

Le identità degli agenti vengono sottoposte al provisioning con un certificato X.509 e un token associato al certificato. IAP impone che le identità dell'agente utilizzino mutual TLS (mTLS) per l'autenticazione all'Agent Gateway. Quando il gateway consente all'agente di uscire e accedere alle API Cloud de Confiance , ai server MCP, ad altri agenti e ad altri endpoint, l'agente tenta di accedere al di fuori del limite mTLS. Per contribuire a proteggere la comunicazione, l'accesso sensibile al contesto applica un criterio di accesso sensibile al contesto gestito da Google. Il criterio richiede a DPoP di convalidare 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, vedi Sicurezza dell'agente di accesso sensibile al contesto.

Passaggi successivi