Ruoli e autorizzazioni

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 (roles/agentregistry.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.

  • Registra e gestisci agenti, server MCP, strumenti ed endpoint.
  • Crea, aggiorna ed elimina competenze autonome e revisioni delle competenze.
  • Visualizzare ed elencare i risultati relativi alla sicurezza per le revisioni delle competenze.
  • Creare e gestire le associazioni e le policy IAM delle skill.

Agent Registry API Editor (roles/agentregistry.editor)

Accesso in modifica alle risorse di Agent Registry, inclusi agenti, server MCP, strumenti, endpoint, skill autonome e revisioni delle skill.

  • Registra e gestisci agenti e server MCP.
  • Aggiorna le definizioni e gli endpoint degli strumenti.
  • Crea, aggiorna ed elimina competenze autonome e revisioni delle competenze.

Agent Registry API Viewer (roles/agentregistry.viewer)

Accesso di sola lettura per visualizzare e cercare agenti, server MCP, strumenti, skill autonome, revisioni delle skill, publisher, endpoint e associazioni.

  • Scopri gli agenti, i server MCP e gli strumenti disponibili.
  • Visualizza skill A2A, skill autonome, revisioni delle skill, publisher, endpoint e associazioni per l'integrazione.

Utente Agent Registry (roles/agentregistry.user)

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.

  • Crea, aggiorna ed elimina skill autonome e revisioni delle skill senza accesso in modifica ad agenti, server MCP o endpoint.
  • Mantieni il controllo della versione per le revisioni delle skill, configura la scansione di sicurezza automatizzata e gestisci centralmente gli stati attivi delle skill.

Autorizzazioni di Agent Registry

La tabella seguente elenca le autorizzazioni di ciascun ruolo IAM di Agent Registry:

(roles/agentregistry.admin)

Accesso completo alle risorse dell'API Agent Registry.

agentregistry.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search
  • agentregistry.aiApplications.createPolicyBinding
  • agentregistry.aiApplications.deletePolicyBinding
  • agentregistry.aiApplications.get
  • agentregistry.aiApplications.getIamPolicy
  • agentregistry.aiApplications.list
  • agentregistry.aiApplications.searchPolicyBindings
  • agentregistry.aiApplications.setIamPolicy
  • agentregistry.aiApplications.updatePolicyBinding
  • agentregistry.bindings.create
  • agentregistry.bindings.delete
  • agentregistry.bindings.fetchAvailable
  • agentregistry.bindings.get
  • agentregistry.bindings.list
  • agentregistry.bindings.update
  • agentregistry.endpoints.get
  • agentregistry.endpoints.list
  • agentregistry.locations.get
  • agentregistry.locations.list
  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search
  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list
  • agentregistry.publishers.get
  • agentregistry.publishers.list
  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update
  • agentregistry.skillRevisions.create
  • agentregistry.skillRevisions.delete
  • agentregistry.skillRevisions.get
  • agentregistry.skillRevisions.list
  • agentregistry.skills.create
  • agentregistry.skills.delete
  • agentregistry.skills.get
  • agentregistry.skills.getIamPolicy
  • agentregistry.skills.list
  • agentregistry.skills.search
  • agentregistry.skills.setIamPolicy
  • agentregistry.skills.update

(roles/agentregistry.editor)

Accesso in modifica alle risorse dell'API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.aiApplications.get

agentregistry.aiApplications.list

agentregistry.aiApplications.searchPolicyBindings

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.*

  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list

agentregistry.publishers.*

  • agentregistry.publishers.get
  • agentregistry.publishers.list

agentregistry.services.*

  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

agentregistry.skillRevisions.*

  • agentregistry.skillRevisions.create
  • agentregistry.skillRevisions.delete
  • agentregistry.skillRevisions.get
  • agentregistry.skillRevisions.list

agentregistry.skills.create

agentregistry.skills.delete

agentregistry.skills.get

agentregistry.skills.list

agentregistry.skills.search

agentregistry.skills.update

(roles/agentregistry.viewer)

Accesso di sola lettura alle risorse dell'API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.aiApplications.get

agentregistry.aiApplications.list

agentregistry.aiApplications.searchPolicyBindings

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.get

agentregistry.operations.list

agentregistry.publishers.*

  • agentregistry.publishers.get
  • agentregistry.publishers.list

agentregistry.services.get

agentregistry.services.list

agentregistry.skillRevisions.get

agentregistry.skillRevisions.list

agentregistry.skills.get

agentregistry.skills.list

agentregistry.skills.search

(roles/agentregistry.user)

Crea, aggiorna ed elimina competenze e revisioni delle competenze.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.aiApplications.get

agentregistry.aiApplications.list

agentregistry.aiApplications.searchPolicyBindings

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.get

agentregistry.operations.list

agentregistry.publishers.*

  • agentregistry.publishers.get
  • agentregistry.publishers.list

agentregistry.services.get

agentregistry.services.list

agentregistry.skillRevisions.*

  • agentregistry.skillRevisions.create
  • agentregistry.skillRevisions.delete
  • agentregistry.skillRevisions.get
  • agentregistry.skillRevisions.list

agentregistry.skills.create

agentregistry.skills.delete

agentregistry.skills.get

agentregistry.skills.list

agentregistry.skills.search

agentregistry.skills.update

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 CapabilityConfig separato.
  • 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.com nei 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'organizzazione constraints/gcp.restrictServiceUsage sulla cartella o sull'organizzazione principale per negare agentregistry.googleapis.com e sostituisci la policy sul progetto di gestione. Il blocco di agentregistry.googleapis.com sui 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.com abilitato nei progetti membri per il discovery di sola lettura locale, richiedendo al contempo la registrazione di tutte le risorse Service e Binding nel 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.create
    • agentregistry.googleapis.com/services.update
    • agentregistry.googleapis.com/services.delete
    • agentregistry.googleapis.com/bindings.create
    • agentregistry.googleapis.com/bindings.update
    • agentregistry.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:

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: