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
( |
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. |
|
|
Agent Registry API Editor
( |
Bearbeitungszugriff auf Agent Registry-Ressourcen, einschließlich KI-Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills und Skill-Versionen. |
|
|
Agent Registry API Viewer
( |
Lesezugriff zum Aufrufen und Suchen von KI-Agenten, MCP-Servern, Tools, eigenständigen Skills, Skill-Versionen, Publishern, Endpunkten und Bindungen. |
|
|
Agent Registry-Nutzer
( |
Lesezugriff auf Agent Registry-Ressourcen sowie Zugriff zum Erstellen, Aktualisieren und Löschen von eigenständigen Skills, Skill-Versionen und Scaneinstellungen. |
|
Agent Registry-Berechtigungen
In der folgenden Tabelle sind die Berechtigungen der einzelnen IAM-Rollen für die Agent Registry aufgeführt:
Agent Registry API Admin( Vollständiger Zugriff auf Agent Registry API-Ressourcen. |
|
Agent Registry API Editor( Bearbeitungszugriff auf Agent Registry API-Ressourcen. |
|
Agent Registry API Viewer( Lesezugriff auf Agent Registry API-Ressourcen. |
|
Agent Registry User( Skills und Skill-Versionen erstellen, aktualisieren und löschen. |
|
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.comin Mitgliedsprojekten blockieren: Wenn Entwickler die Agent Registry in einem Mitgliedsprojekt nicht direkt abfragen müssen, wenden Sie die Organisationsrichtlinien-Einschränkungconstraints/gcp.restrictServiceUsageauf den übergeordneten Ordner oder die übergeordnete Organisation an, umagentregistry.googleapis.comabzulehnen, und überschreiben Sie die Richtlinie im Verwaltungsprojekt. Das Blockieren vonagentregistry.googleapis.comfü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.comin Mitgliedsprojekten für die lokale Erkennung mit Lesezugriff aktiviert lassen möchten, aber alleService- undBinding-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.createagentregistry.googleapis.com/services.updateagentregistry.googleapis.com/services.deleteagentregistry.googleapis.com/bindings.createagentregistry.googleapis.com/bindings.updateagentregistry.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:
- Integrierte Google-Agenten, die von Google Cloud -APIs bereitgestellt werden: Gewähren Sie die IAM-Rolle, die für den Ziel-API-Dienst erforderlich ist, der den Agenten bereitstellt. Eine Liste der vordefinierten Rollen nach Dienst finden Sie im Index der IAM-Rollen und -Berechtigungen.
- Benutzerdefinierte A2A-Agenten, die auf Google Cloud -Laufzeiten oder -Gateways gehostet werden: Gewähren Sie die Rolle, die für die Laufzeit oder das Gateway erforderlich ist, auf der bzw. dem der Agent gehostet wird, z. B.:
- Agent Runtime auf der Gemini Enterprise Agent Platform: Weitere Informationen finden Sie unter Zugriff für die A2A-Delegierung gewähren, Agenten freigeben und Rollen und Berechtigungen für die Gemini Enterprise Agent Platform.
- Cloud Run: Weitere Informationen finden Sie unter KI-Agenten authentifizieren und IAM-Rollen und -Berechtigungen für Cloud Run.
- Agent Gateway und Identity-Aware Proxy (IAP): Weitere Informationen finden Sie unter IAM Unified Access Policies (UAPs) erstellen und IAP-Rollen und -Berechtigungen.
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:
- IAM-Ablehnungsrichtlinien: Hängen Sie IAM-Ablehnungsrichtlinien an Projekte, Ordner oder Ihre Organisation an. Verwenden Sie dazu einen Agenten-Prinzipal (
principal://oderprincipalSet://) oder ein Dienstkonto als abgelehnten Prinzipal. Sie können Berechtigungen zum Aufrufen von Agents oder Berechtigungen für nachgelagerte Ressourcen blockieren, die unter In Ablehnungsrichtlinien unterstützte Berechtigungen aufgeführt sind. - Inhaltssicherheit mit Model Armor: Unterstützte A2A-Prompt- und Antwortnutzlasten prüfen, um Prompt Injection und die Offenlegung sensibler Daten zu erkennen. Dazu die Model Armor-Integration mit Agent Gateway und Diensterweiterungsbindungen konfigurieren.