I ruoli e le autorizzazioni di Identity and Access Management (IAM) ti consentono di controllare chi può visualizzare, registrare e gestire agenti, server Model Context Protocol (MCP), strumenti, skill autonome, endpoint e associazioni in Agent Registry.
Per concedere i ruoli IAM di Agent Registry a utenti o gruppi nel tuo progetto di governance o nel tuo progetto di gestione, utilizza la pagina IAM nella console Google Cloud o Google Cloud CLI. Per maggiori dettagli, consulta Controllo degli accessi con IAM e Gestisci l'accesso a progetti, cartelle e organizzazioni.
Ruoli di Agent Registry
La tabella seguente descrive i ruoli IAM di Agent Registry e le relative responsabilità tipiche:
Role |
Descrizione |
Purpose |
|---|---|---|
|
Agent Registry API Admin
( |
Accesso completo a tutte le risorse di Agent Registry, inclusi agenti, server MCP, strumenti, endpoint, skill autonome, revisioni delle skill, risultati di sicurezza, associazioni e policy IAM delle skill. |
|
|
Agent Registry API Editor
( |
Accesso in modifica alle risorse di Agent Registry, inclusi agenti, server MCP, strumenti, endpoint, skill autonome e revisioni delle skill. |
|
|
Agent Registry API Viewer
( |
Accesso di sola lettura per visualizzare e cercare agenti, server MCP, strumenti, skill autonome, revisioni delle skill, publisher, endpoint e associazioni. |
|
|
Utente Agent Registry
( |
Accesso di sola lettura alle risorse del registro degli agenti, oltre all'accesso per creare, aggiornare ed eliminare competenze autonome, revisioni delle competenze e impostazioni di scansione. |
|
Autorizzazioni di Agent Registry
La tabella seguente elenca le autorizzazioni di ciascun ruolo IAM di Agent Registry:
Agent Registry API Admin( Accesso completo alle risorse dell'API Agent Registry. |
|
Agent Registry API Editor( Accesso in modifica alle risorse dell'API Agent Registry. |
|
Agent Registry API Viewer( Accesso di sola lettura alle risorse dell'API Agent Registry. |
|
Agent Registry User( Crea, aggiorna ed elimina competenze e revisioni delle competenze. |
|
Per saperne di più sulle autorizzazioni IAM, consulta Trova i ruoli predefiniti giusti e Indice di ruoli e autorizzazioni IAM.
Ruoli per i confini di gestione tra progetti
Quando configuri un confine di gestione per i componenti degli agenti in Agent Registry, devi concedere i ruoli IAM agli utenti o ai servizi ai seguenti livelli:
- Progetto di gestione: concedi i ruoli di Agent Registry nel progetto di gestione agli utenti o ai servizi che rilevano e gestiscono gli agenti oltre il confine.
Gli utenti con accesso in visualizzazione al progetto di gestione possono scoprire e cercare agenti e server MCP da tutti i progetti membri in ogni confine collegato al progetto di gestione, senza bisogno di autorizzazioni di visualizzazione esplicite concesse in ogni singolo progetto membro. Se un team non deve visualizzare gli asset di altri perimetri, assegna quel perimetro a un progetto di gestione e risorse
CapabilityConfigseparato. - Progetti membri: concedi i ruoli di Agent Registry su progetti membri specifici agli sviluppatori che creano, registrano o gestiscono agenti e strumenti all'interno di questi progetti specifici.
- Configurazione dei confini: la creazione e la gestione delle risorse di configurazione dei confini richiedono ruoli di amministratore nella cartella o nell'organizzazione che li contiene. Per ulteriori informazioni, consulta i ruoli richiesti in Configura i confini di gestione nella documentazione di Resource Manager.
Limita le registrazioni locali nei progetti membri
Poiché le risorse Service e Binding registrate manualmente create in un progetto membro non vengono aggregate nel progetto di gestione, gli amministratori della sicurezza possono applicare la registrazione centralizzata nel progetto di gestione in uno dei seguenti modi:
- Blocca
agentregistry.googleapis.comnei progetti membri: se gli sviluppatori non hanno bisogno di eseguire query direttamente su Agent Registry in un progetto membro, applica il vincolo della policy dell'organizzazioneconstraints/gcp.restrictServiceUsagesulla cartella o sull'organizzazione principale per negareagentregistry.googleapis.come sostituisci la policy sul progetto di gestione. Il blocco diagentregistry.googleapis.comsui progetti membri non influisce sul rilevamento automatico dei workload di runtime dai progetti membri al progetto di gestione. Consenti il discovery di sola lettura nei progetti membri e nega le scritture locali: per mantenere
agentregistry.googleapis.comabilitato nei progetti membri per il discovery di sola lettura locale, richiedendo al contempo la registrazione di tutte le risorseServiceeBindingnel progetto di gestione, concedi agli sviluppatori il ruolo Visualizzatore API Agent Registry (roles/agentregistry.viewer) nel progetto membro e allega una policy di negazione IAM che nega le seguenti autorizzazioni in scrittura nei progetti membri:agentregistry.googleapis.com/services.createagentregistry.googleapis.com/services.updateagentregistry.googleapis.com/services.deleteagentregistry.googleapis.com/bindings.createagentregistry.googleapis.com/bindings.updateagentregistry.googleapis.com/bindings.delete
Controllo dell'accesso per le risorse registrate
I ruoli di Agent Registry regolano chi può gestire e rilevare le risorse nel registry stesso. Per controllare chi può visualizzare o aggiornare una skill autonoma senza concedere l'accesso a livello di progetto, configura una policy IAM a livello di risorsa sulla risorsa Skill o utilizza le condizioni IAM sulle associazioni a livello di progetto. Per le istruzioni, consulta Gestisci l'accesso a una competenza.
I ruoli di Agent Registry non concedono l'autorizzazione per chiamare l'endpoint di runtime di un agente. Quando un agente o un client orchestratore chiama un agente Agent2Agent (A2A), un server MCP o un endpoint rilevato, l'autorizzazione avviene sul servizio o sul gateway di destinazione.
Autorizzazioni per chiamare gli agenti A2A
Concedi all'utente, al account di servizio o all'entità dell'agente chiamante (principal:// o principalSet://) il ruolo richiesto per chiamare l'API, il runtime o il gateway di destinazione:
- Agenti Google integrati esposti dalle API Google Cloud : concedi il ruolo IAM richiesto dal servizio API di destinazione che espone l'agente. Per un elenco dei ruoli predefiniti per servizio, consulta l'indice dei ruoli e delle autorizzazioni IAM.
- Agenti A2A personalizzati ospitati su Google Cloud runtime o gateway:
concedi il ruolo richiesto dal runtime o dal gateway che ospita l'agente, ad
esempio:
- Agent Runtime su Gemini Enterprise Agent Platform: consulta Concedi l'accesso per la delega A2A, Condividi un agente e Ruoli e autorizzazioni di Gemini Enterprise Agent Platform.
- Cloud Run: consulta Autentica gli agenti AI e Ruoli e autorizzazioni IAM di Cloud Run.
- Agent Gateway e Identity-Aware Proxy (IAP): consulta Crea policy di accesso unificato (UAP) IAM e Ruoli e autorizzazioni IAP.
Nelle condizioni del Common Expression Language (CEL) di UAP per Agent Gateway, scegli come target un agente registrato utilizzando il suo nome della risorsa anziché l'identificatore del registry. Per i passaggi di configurazione dei ruoli amministrativi e delle policy, consulta Crea policy di accesso degli utenti IAM.
Policy di negazione e sicurezza dei contenuti
Combina le policy di negazione basate sull'identità con i controlli di ispezione del payload per gestire la comunicazione A2A nella tua organizzazione:
- Policy di negazione IAM: collega le policy di negazione IAM a progetti, cartelle o alla tua organizzazione utilizzando un'entità dell'agente (
principal://oprincipalSet://) o un account di servizio come entità negata. Puoi bloccare le autorizzazioni per gli agenti di chiamata o le autorizzazioni delle risorse downstream visualizzate in Autorizzazioni supportate nelle policy di negazione. - Sicurezza dei contenuti con Model Armor: ispeziona i payload dei prompt e delle risposte A2A supportati per rilevare prompt injection ed esposizione di dati sensibili configurando l'integrazione di Model Armor con Agent Gateway e i binding delle estensioni dei servizi.