Rollen und Berechtigungen

Mit Rollen und Berechtigungen von Identity and Access Management (IAM) können Sie steuern, wer Agenten, MCP-Server (Model Context Protocol), Tools, eigenständige Skills, Endpunkte und Bindungen in Agent Registry ansehen, registrieren und verwalten kann.

Wenn Sie Nutzern oder Gruppen in Ihrem Governance-Projekt oder Ihrem Verwaltungsprojekt IAM-Rollen für die Agent Registry zuweisen möchten, verwenden Sie die IAM-Seite in der Google Cloud Console oder die Google Cloud CLI. Weitere Informationen finden Sie unter Zugriffssteuerung mit IAM und Zugriff auf Projekte, Ordner und Organisationen verwalten.

Agent Registry-Rollen

In der folgenden Tabelle werden die IAM-Rollen für die Agent-Registry und ihre typischen Aufgaben beschrieben:

Rolle

Beschreibung

Purpose

Agent Registry API Admin (roles/agentregistry.admin)

Vollständiger Zugriff auf alle Agent Registry-Ressourcen, einschließlich KI-Agenten, MCP-Server, Tools, Endpunkte, eigenständige Skills, Skill-Versionen, Sicherheitsergebnisse, Bindungen und IAM-Richtlinien für Skills.

  • KI-Agenten, MCP-Server, Tools und Endpunkte registrieren und verwalten.
  • Eigenständige Skills und Skill-Versionen erstellen, aktualisieren und löschen.
  • Sicherheitsergebnisse für Skill-Versionen ansehen und auflisten.
  • Bindungen und IAM-Richtlinien für Skills erstellen und verwalten.

Agent Registry API Editor (roles/agentregistry.editor)

Bearbeitungszugriff auf Agent Registry-Ressourcen, einschließlich KI-Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills und Skill-Versionen.

  • KI-Agenten und MCP-Server registrieren und verwalten
  • Tooldefinitionen und Endpunkte aktualisieren.
  • Eigenständige Skills und Skill-Versionen erstellen, aktualisieren und löschen.

Agent Registry API Viewer (roles/agentregistry.viewer)

Lesezugriff zum Aufrufen und Suchen von KI-Agenten, MCP-Servern, Tools, eigenständigen Skills, Skill-Versionen, Publishern, Endpunkten und Bindungen.

  • Verfügbare KI-Agenten, MCP-Server und Tools finden
  • A2A-Skills, eigenständige Skills, Skill-Überarbeitungen, Publisher, Endpunkte und Bindungen für die Integration ansehen.

Agent Registry-Nutzer (roles/agentregistry.user)

Lesezugriff auf Agent Registry-Ressourcen sowie Zugriff zum Erstellen, Aktualisieren und Löschen von eigenständigen Skills, Skill-Versionen und Scaneinstellungen.

  • Eigenständige Skills und Skill-Versionen erstellen, aktualisieren und löschen, ohne Bearbeitungszugriff auf KI-Agenten, MCP-Server oder Endpunkte zu haben.
  • Versionsverwaltung für Skill-Überarbeitungen beibehalten, automatisierte Sicherheitsscans konfigurieren und aktive Skill-Zustände zentral verwalten.

Agent Registry-Berechtigungen

In der folgenden Tabelle sind die Berechtigungen der einzelnen IAM-Rollen für die Agent Registry aufgeführt:

(roles/agentregistry.admin)

Vollständiger Zugriff auf Agent Registry API-Ressourcen.

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)

Bearbeitungszugriff auf Agent Registry API-Ressourcen.

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)

Lesezugriff auf Agent Registry API-Ressourcen.

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)

Skills und Skill-Versionen erstellen, aktualisieren und löschen.

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

Weitere Informationen zu IAM-Berechtigungen finden Sie unter Die richtigen vordefinierten Rollen finden und im Index für IAM-Rollen und -Berechtigungen.

Rollen für projektübergreifende Verwaltungsgrenzen

Wenn Sie eine Verwaltungsgrenze für Ihre agentischen Komponenten in der Agent Registry konfigurieren, müssen Sie Nutzern oder Diensten auf den folgenden Ebenen IAM-Rollen zuweisen:

  • Verwaltungsprojekt: Gewähren Sie Nutzern oder Diensten, die Agenten über die Grenze hinweg erkennen und verwalten, Agent Registry-Rollen im Verwaltungsprojekt. Nutzer mit Lesezugriff auf das Verwaltungsprojekt können Agenten und MCP-Server aus allen Mitgliedsprojekten in allen Grenzen, die mit diesem Verwaltungsprojekt verknüpft sind, finden und durchsuchen, ohne dass ihnen explizite Leseberechtigungen in jedem einzelnen Mitgliedsprojekt gewährt werden müssen. Wenn ein Team keine Assets aus anderen Grenzen sehen darf, weisen Sie diese Grenze einem separaten CapabilityConfig-Ressourcen- und Verwaltungsprojekt zu.
  • Mitgliedsprojekte: Gewähren Sie Entwicklern, die KI-Agenten und Tools in bestimmten Mitgliedsprojekten erstellen, registrieren oder verwalten, Agent Registry-Rollen für diese Projekte.
  • Grenzkonfiguration: Zum Erstellen und Verwalten von Grenzkonfigurationsressourcen sind Administratorrollen für den übergeordneten Ordner oder die übergeordnete Organisation erforderlich. Weitere Informationen finden Sie in der Resource Manager-Dokumentation unter Verwaltungsgrenzen konfigurieren.

Lokale Registrierungen in Mitgliedsprojekten einschränken

Da manuell registrierte Service- und Binding-Ressourcen, die in einem Mitgliedsprojekt erstellt wurden, nicht im Verwaltungsprojekt zusammengefasst werden, können Sicherheitsadministratoren die zentrale Registrierung im Verwaltungsprojekt auf eine der folgenden Arten erzwingen:

  • agentregistry.googleapis.com in Mitgliedsprojekten blockieren: Wenn Entwickler die Agent Registry in einem Mitgliedsprojekt nicht direkt abfragen müssen, wenden Sie die Organisationsrichtlinien-Einschränkung constraints/gcp.restrictServiceUsage auf den übergeordneten Ordner oder die übergeordnete Organisation an, um agentregistry.googleapis.com abzulehnen, und überschreiben Sie die Richtlinie im Verwaltungsprojekt. Das Blockieren von agentregistry.googleapis.com für Mitgliedsprojekte hat keine Auswirkungen auf die automatische Erkennung von Laufzeitarbeitslasten aus Mitgliedsprojekten im Verwaltungsprojekt.
  • Lesezugriff für die Erkennung in Mitgliedsprojekten zulassen und lokale Schreibvorgänge ablehnen: Wenn Sie agentregistry.googleapis.com in Mitgliedsprojekten für die lokale Erkennung mit Lesezugriff aktiviert lassen möchten, aber alle Service- und Binding-Ressourcen im Verwaltungsprojekt registriert werden müssen, weisen Sie Entwicklern die Rolle Agent Registry API Viewer (roles/agentregistry.viewer) für das Mitgliedsprojekt zu und hängen Sie eine IAM-Ablehnungsrichtlinie an, die die folgenden Schreibberechtigungen in Mitgliedsprojekten ablehnt:

    • 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

Zugriffssteuerung für registrierte Ressourcen

Agent Registry-Rollen bestimmen, wer Ressourcen in der Registry selbst verwalten und erkennen kann. Wenn Sie steuern möchten, wer einen eigenständigen Skill ansehen oder aktualisieren kann, ohne projektweiten Zugriff zu gewähren, konfigurieren Sie eine IAM-Richtlinie auf Ressourcenebene für die Ressource Skill oder verwenden Sie IAM-Bedingungen für Bindungen auf Projektebene. Eine Anleitung finden Sie unter Zugriff auf einen Skill verwalten.

Agent Registry-Rollen gewähren keine Berechtigung zum Aufrufen des Laufzeitendpunkts eines KI-Agenten. Wenn ein Orchestrator-Agent oder -Client einen erkannten Agent2Agent (A2A)-Agenten, MCP-Server oder Endpunkt aufruft, erfolgt die Autorisierung im Zieldienst oder Gateway.

Berechtigungen zum Aufrufen von A2A-Agenten

Weisen Sie dem aufrufenden Nutzer, Dienstkonto oder Agenten-Prinzipal (principal:// oder principalSet://) die Rolle zu, die zum Aufrufen der Ziel-API, Laufzeit oder des Gateways erforderlich ist:

In UAP-CEL-Bedingungen (Common Expression Language) für Agent Gateway müssen Sie einen registrierten Agenten mit seinem Ressourcennamen und nicht mit seiner Registry-ID angeben. Informationen zu Administratorrollen und Schritten zur Richtlinienkonfiguration finden Sie unter IAM-UAPs erstellen.

Ablehnungsrichtlinien und Inhaltssicherheit

Kombinieren Sie identitätsbasierte Ablehnungsrichtlinien mit Kontrollen zur Nutzlastprüfung, um die A2A-Kommunikation in Ihrer Organisation zu steuern: