Papéis e permissões

Os papéis e as permissões do Identity and Access Management (IAM) permitem controlar quem pode visualizar, registrar e gerenciar agentes, servidores MCP, ferramentas, habilidades independentes, endpoints e vinculações no Agent Registry.

Para conceder papéis do IAM do Agent Registry a usuários ou grupos no projeto de governança ou no projeto de gerenciamento, use a página do IAM no console do Google Cloud ou a Google Cloud CLI. Para mais detalhes, consulte Controle de acesso com o IAM e Gerenciar o acesso a projetos, pastas e organizações.

Papéis do Agent Registry

A tabela a seguir descreve os papéis do IAM do Agent Registry e as responsabilidades típicas deles:

Atenção: conceda os papéis de administrador da API Agent Registry (roles/agentregistry.admin) ou editor da API Agent Registry (roles/agentregistry.editor) apenas a administradores confiáveis que gerenciam o registro. Evite conceder esses papéis diretamente aos agentes. Esses papéis contêm permissões para criar, excluir e atualizar serviços, incluindo a modificação de metadados críticos de agentes e anotações de ferramentas, como readOnlyHint ou destructiveHint. Alterações maliciosas em metadados e anotações podem causar consequências não intencionais e destrutivas quando um orquestrador usa a ferramenta modificada. Além disso, um agente com essas permissões pode registrar explicitamente um agente externo malicioso no registro.

Papel	Descrição	Purpose
Administrador da API Agent Registry (roles/agentregistry.admin)	Acesso total a todos os recursos do Agent Registry, incluindo agentes, servidores MCP, ferramentas, endpoints, habilidades independentes, revisões de habilidades, vinculações e políticas de IAM de habilidades.	Registre e gerencie agentes, servidores MCP, ferramentas e endpoints. Criar, atualizar e excluir habilidades independentes e revisões de habilidades. Criar e gerenciar vinculações e políticas de IAM de habilidades.
Editor da API Agent Registry (roles/agentregistry.editor)	Acesso de edição aos recursos do Agent Registry, incluindo agentes, servidores MCP, ferramentas, endpoints, habilidades independentes e revisões de habilidades.	Registre e gerencie agentes e servidores MCP. Atualize as definições e os endpoints das ferramentas. Criar, atualizar e excluir habilidades independentes e revisões de habilidades.
Leitor da API Agent Registry (roles/agentregistry.viewer)	Acesso somente leitura para visualizar e pesquisar agentes, servidores MCP, ferramentas, habilidades independentes, revisões de habilidades, editores, endpoints e vinculações.	Descubra agentes, servidores MCP e ferramentas disponíveis. Ver habilidades de A2A, habilidades independentes, revisões de habilidades, editores, endpoints e vinculações para integração.
Usuário do registro de agentes (roles/agentregistry.user)	Acesso somente leitura aos recursos do Registro de Agentes, além de acesso para criar, atualizar e excluir habilidades independentes e revisões de habilidades.	Criar, atualizar e excluir habilidades independentes e revisões de habilidades sem acesso de edição a agentes, servidores MCP ou endpoints. Mantenha o controle de versões para revisões de habilidades e gerencie centralmente os estados ativos das habilidades.

Permissões do Agent Registry

A tabela a seguir lista as permissões de cada papel do IAM do Agent Registry:

Administrador da API Agent Registry Editor da API Agent Registry Leitor da API Agent Registry Usuário do Agent Registry Limpar tudo

Administrador da API Agent Registry ^Beta (roles/agentregistry.admin) Acesso total aos recursos da API Agent Registry.	agentregistry.* agentregistry.agents.get agentregistry.agents.list agentregistry.agents.search 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
Editor da API Agent Registry ^Beta (roles/agentregistry.editor) Acesso de edição aos recursos da API Agent Registry.	agentregistry.agents.* agentregistry.agents.get agentregistry.agents.list agentregistry.agents.search 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
Leitor da API Agent Registry ^Beta (roles/agentregistry.viewer) Acesso somente leitura aos recursos da API Agent Registry.	agentregistry.agents.* agentregistry.agents.get agentregistry.agents.list agentregistry.agents.search 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
Usuário do Agent Registry ^Beta (roles/agentregistry.user) Criar, atualizar e excluir habilidades e revisões de habilidades.	agentregistry.agents.* agentregistry.agents.get agentregistry.agents.list agentregistry.agents.search 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

Para mais informações sobre as permissões do IAM, consulte Encontrar os papéis predefinidos certos e Índice de papéis e permissões do IAM.

Papéis para limites de gerenciamento entre projetos

Ao configurar um limite de gerenciamento para seus componentes agênticos no Agent Registry, é necessário conceder papéis do IAM a usuários ou serviços nos seguintes níveis:

• Projeto de gerenciamento: conceda papéis do Agent Registry no projeto de gerenciamento a usuários ou serviços que descobrem e gerenciam agentes em todo o limite. Os usuários com acesso de visualização no projeto de gerenciamento podem descobrir e pesquisar agentes e servidores MCP de todos os projetos membros em todos os limites anexados a esse projeto de gerenciamento, sem precisar de permissões de visualização explícitas concedidas em cada projeto membro individual. Se uma equipe não puder visualizar recursos de outros limites, atribua esse limite a um projeto de gerenciamento e recurso CapabilityConfig separado.
• Projetos de membros: conceda papéis do Agent Registry em projetos de membros específicos para desenvolvedores que criam, registram ou mantêm agentes e ferramentas nesses projetos específicos.
• Configuração de limite: a criação e o gerenciamento de recursos de configuração de limite exigem papéis administrativos na pasta ou organização que os contém. Para mais informações, consulte os papéis necessários em Configurar limites de gerenciamento na documentação do Resource Manager.

Restringir registros locais em projetos de membros

Como os recursos Service e Binding registrados manualmente criados em um projeto de membro não são acumulados no projeto de gerenciamento, os administradores de segurança podem aplicar o registro centralizado no projeto de gerenciamento de uma das seguintes maneiras:

• Bloquear agentregistry.googleapis.com em projetos de membros: quando os desenvolvedores não precisam consultar o Agent Registry diretamente em um projeto de membro, aplique a constraints/gcp.restrictServiceUsage restrição de política da organização na pasta ou organização pai para negar agentregistry.googleapis.com e substituir a política no projeto de gerenciamento. Bloquear agentregistry.googleapis.com em projetos de membros não afeta a descoberta automática de cargas de trabalho de ambiente de execução de projetos de membros no projeto de gerenciamento.

• Permitir a descoberta somente leitura em projetos de membros e negar gravações locais: para manter o agentregistry.googleapis.com ativado em projetos de membros para descoberta local somente leitura, exigindo que todos os recursos Service e Binding sejam registrados no projeto de gerenciamento, conceda aos desenvolvedores o papel de Leitor da API Agent Registry (roles/agentregistry.viewer) no projeto de membro e anexe uma política de negação do IAM que nega as seguintes permissões de gravação em projetos de membros:

  • 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

Controle de acesso para recursos registrados

Os papéis do Agent Registry controlam quem pode gerenciar e descobrir recursos no próprio registro. Para controlar quais agentes podem se comunicar com serviços, endpoints e servidores MCP registrados pelo Gateway de Agente, use as políticas de saída do Identity-Aware Proxy (IAP):

• Permissões de acesso de saída: para autorizar um agente a rotear o tráfego para um agente registrado, servidor MCP ou endpoint, conceda o papel Saída protegida pelo IAP (roles/iap.egressor) ao principal do agente no recurso de destino.
• Permissões de administração de políticas: para configurar políticas do IAM da Web do IAP em recursos registrados, é necessário receber o papel de Administrador de políticas do IAP (roles/iap.admin) no projeto de governança que hospeda o registro.

Para instruções detalhadas sobre como configurar políticas de saída do IAP, consulte Configurar políticas de agente do IAM.