IAM Unified Access Policies – Übersicht

Sie können Unified Access Policies (UAPs) für Identity and Access Management (IAM) erstellen, um die Kommunikation zwischen Agenten-Prinzipalen und Zielressourcen wie Ziel-Agents, MCP-Servern und Endpunkten sicher zu verwalten. Diese Richtlinien sind an das Projekt gebunden, das Ihre Agent Gateway-Instanzen enthält.

Agent Gateway verwendet Identity-Aware Proxy (IAP), um die UAPs auszuwerten und zu erzwingen.

IAP ist auch in den kontextsensitiven Zugriff eingebunden, um eine End-to-End-Authentifizierung und ‑Autorisierung der Agentenidentität zu ermöglichen.

Informationen zum Einrichten von UAPs für Agent Gateway finden Sie unter IAM-UAPs konfigurieren.

Sie können auch eine Principal Access Boundary (PAB) für die Identität des Agents erstellen. Agent Gateway kann IAP verwenden, um Principal Access Boundary-Richtlinien zu erzwingen.

KI-Agenten-Gateway aktivieren

Wenn Sie Richtlinien für die Kommunikation mit KI-Agenten verwenden möchten, müssen Sie Agent Gateway einrichten.

Wir empfehlen, Agent Gateway im Probebetriebsmodus (DRY_RUN) in einer Staging-Umgebung zu konfigurieren, um zu prüfen, ob Ihre Richtlinien wie erwartet funktionieren.

Wenn Sie sicher sind, dass die Richtlinien korrekt funktionieren, können Sie die Agent Gateway-Konfiguration aktualisieren, um den erzwungenen Modus auf ENFORCE zu setzen. In diesem Modus sind agentenbasierte Mitteilungen, die gegen die Richtlinie verstoßen, nicht zulässig und die Kommunikation mit der Ressource wird blockiert.

UAPs – Übersicht

Mit UAPs wird gesteuert, ob ein oder mehrere Agenten-Prinzipale auf ein oder mehrere Zielressourcen zugreifen können. UAPs erweitern das IAM-Richtlinienmodell, indem sie mehrere Regeln in einer einzelnen Richtlinie unterstützen. Im Gegensatz zu IAM-Zulassungs- und ‑Ablehnungsrichtlinien kann jede Regel in einer UAP sowohl eine Zulassungs- als auch eine Ablehnungswirkung haben. Weitere Informationen zu IAM-Richtlinientypen

Regeln enthalten auch Bedingungen, die in der Common Expression Language (CEL) ausgedrückt werden. Bedingungen sind der primäre Mechanismus, um den Zugriff auf Ressourcen nach dem Gateway zu steuern. Durch die Durchsetzung von UAPs mit Agent Gateway und IAP wird eine strenge Verhaltenskontrolle über Agenten ermöglicht, die in Ihrem Unternehmen bereitgestellt werden. Sie können detaillierte Anwendungsfälle für die Agent-Governance in der Praxis in einer einzigen Richtlinie darstellen.

Eine typische Richtlinie enthält mindestens zwei unterschiedliche Regeln:

• Regel zum Zulassen:Regeln zum Zulassen haben einen Zulassungseffekt, der es Agent-Hauptkonten ermöglicht, auf bestimmte sichere Vorgänge zuzugreifen, z. B. einen Lesevorgang für ein Tool auszuführen, um Tracking-Daten abzurufen oder Registrierungseinträge anzusehen.
• Ablehnungsregel:Ablehnungsregeln haben eine Ablehnungswirkung, die verhindert, dass der Agent unerwünschte Aktionen ausführt, z. B. einen nicht angeforderten Lösch- oder Aktualisierungsvorgang für eine kritische Ressource.

Ein Beispiel: Ein automatisierter Kundensupport-Agent muss mit internen Tools interagieren, die privilegierten Zugriff auf eine Kundendatenbank haben. Der Administrator konfiguriert ein Agent Gateway mit IAP, um IAM-UAPs zu erzwingen. Der Administrator kann eine UAP mit einer Zulassungsregel konfigurieren, die dem Agenten-Prinzipal das Lesen von Support-Tickets erlaubt, und einer Ablehnungsregel, die dem Agenten-Prinzipal das Löschen oder Aktualisieren von Datenbankdatensätzen untersagt.

Durch die Verwendung von UAPs, die sowohl Zulassungs- als auch Ablehnungsregeln enthalten, können Unternehmen eine einzelne Unternehmensrichtlinie zur Compliance direkt in der zugrunde liegenden Cloud-Infrastruktur bereitstellen, um das Verhalten von Agents einzuschränken.

Best Practices

Beachten Sie beim Konfigurieren von Agent-Egress-Richtlinien die folgenden Best Practices:

• Probelaufmodus verwenden:Stellen Sie neue oder geänderte Richtlinien zuerst im Probelaufmodus bereit, um sicherzustellen, dass sie wie erwartet funktionieren, ohne den aktiven Agent-Traffic zu blockieren.
• Prinzip der geringsten Berechtigung anwenden:Gewähren Sie nur die erforderlichen Berechtigungen. Verwenden Sie in CEL-Bedingungen bestimmte Toolnamen oder ‑pfade anstelle von Platzhaltern.
• Ablehnungsregeln für Sicherheitsvorkehrungen verwenden:Verwenden Sie explizite Ablehnungsregeln, um wichtige Sicherheitsvorkehrungen zu implementieren, z. B. das Blockieren destruktiver Tools auf Produktionsendpunkten. Die Verwendung von Ablehnungsregeln für Guardrails ist effektiv, da Ablehnungsregeln Vorrang vor Zulassungsregeln haben.
• Regelmäßige Prüfungen durchführen:Überprüfen Sie regelmäßig Cloud-Audit-Logs und Richtlinienkonfigurationen, um sicherzustellen, dass sie den Sicherheitsrichtlinien Ihrer Organisation entsprechen.

UAP-Komponenten

UAPs enthalten eine oder mehrere Regeln. Regeln bestehen aus folgenden Komponenten:

Agenten-Principals

In Ihren IAM-UAPs definieren Sie einen oder mehrere Agenten-Prinzipale. Agenten-Prinzipale sind die Mitglieder, denen Sie Zugriff gewähren. Sie geben Agents anhand ihrer Agent-Identität an, der Identität des Agents, der die Kommunikation mit einer Ressource initiiert. Weitere Informationen dazu, wie verschiedene Arten von Agents Identitäten erhalten, finden Sie unter Agent-Identität. KI-Agentenidentitäten werden durch Prinzipal-IDs dargestellt, die die SPIFFE-formatierte Identität des KI-Agenten enthalten (z. B. principal://agents.global.org-...).

Sie können ein Array mit einzelnen Agent-Identitäten oder ein Array mit Prinzipalgruppen angeben.

Integrierte Agent-Identitäten werden für Cloud de Confiance Dienste wie Agent Runtime (Reasoning Engine), Gemini Enterprise (Discovery Engine) und Cloud Run-Dienste, die mit einer Agent-Identität konfiguriert sind, bereitgestellt. Diese Agent-Principals haben das Format principal://TRUST_DOMAIN/AGENT_UNIQUE_IDENTIFIER, wobei die Kennung den Ressourcenpfad des Agents auf dem Hostingdienst darstellt. Sie können Agents auch mit Hauptkonto-IDs für die Identitätsföderation von Arbeitslasten angeben.

Regelauswirkung

Die Regelwirkung definiert, ob die Regel es Agent-Hauptkonten erlaubt oder verbietet, auf eine Ressource zuzugreifen.

Zielressourcen

IAM-UAPs verwalten den Zugriff von Agenten-Prinzipalen auf Zielressourcen. Zielressourcen sind die Ressourcen, auf die Agent-Hauptkonten zugreifen möchten. Zielressourcen werden in den Bedingungen der Regel angegeben. Zielressourcen können entweder registrierte Ressourcen oder nicht registrierte Ressourcen sein.

Registrierte Ressourcen

Registrierte Ressourcen sind Ressourcen, die in einem Agent Registry-Register registriert sind.

Registrierte Ressourcen umfassen Folgendes:

• Registries: Ganze Agent-Registries in einem Projekt.
• MCP-Server: MCP-Server, die in einer Agent Registry registriert sind.
• KI‑Agenten: KI‑Agenten, die in einer Agent Registry registriert sind. Einzelne Agents können anhand ihrer Agent-Identität angegeben werden. Eine Gruppe von Agents kann durch eine Prinzipalgruppen-ID angegeben werden.
• Endpunkte: Endpunkte, die in einer Agent Registry registriert sind.

Einzelne Dienste können in der Agent Registry registriert werden. Wenn Sie Ihre Agent-Registrierungen regionalisieren und Ihre Regel den Zugriff auf registrierte Ressourcen verwaltet, gelten Ihre UAPs nur für die Ressourcen in der Region der Registrierung.

Nicht registrierte Ressourcen

Nicht registrierte Ressourcen sind Ressourcen, die nicht in einer Agent-Registrierung registriert sind. Wenn Sie den Zugriff auf nicht registrierte Ressourcen in Ihren UAP-Regeln gewähren oder verweigern möchten, müssen Sie nicht registrierte Ressourcen in den Bedingungen Ihrer Regel angeben. Verwenden Sie dazu CEL-Ausdrücke (Common Expression Language), die Attribute für nicht registrierte Hosts und Pfade enthalten.

Conditions

In UAP-Regeln verwenden Sie Common Expression Language (CEL)-Ausdrücke im conditions-Block, um sowohl den Zielressourcenbereich als auch die detaillierten Zugriffskriterien zu definieren:

• Zielressourcenbereich: Gibt an, welche Zielressourcen von der Regel abgedeckt werden. In JSON-formatierten Richtliniendateien geben Sie Zielattribute wie destination.agent_registry.mcp_server.name oder destination.unregistered.host an. Wenn Sie in der Cloud de Confiance -Konsole unter Zielressourcen Ziele auswählen, werden diese Ressourcenkriterien automatisch dem Bedingungsausdruck der Regel hinzugefügt.

• Zugriffskriterien: Mit einem booleschen Ausdruck wird festgelegt, wann und unter welchen Einschränkungen die Regelwirkung eintritt. Sie können den Zugriff beispielsweise anhand von Toolnamen, Lesezugriff, HTTP-Methoden oder Pfadpräfixen mit UAP-CEL-Attributen einschränken. Die Regelwirkung (zulassen oder ablehnen) wird nur angewendet, wenn der gesamte CEL-Ausdruck als true ausgewertet wird.

In der gcloud CLI und der REST API geben Sie diese CEL-Ausdrücke im Feld conditions der Regeldefinition an.

In der Cloud de Confiance -Konsole können Sie Standardregeln mit dem Tool zur Bedingungserstellung konfigurieren oder benutzerdefinierte CEL-Ausdrücke direkt im Bedingungseditor schreiben.

Berechtigungen

In IAP V2 mit IAM-UAPs wird die Berechtigung iap.googleapis.com/resources.egressViaIAP immer für die Zielressource gewährt. In der gcloud CLI und der REST API geben Sie die Berechtigung im Feld operation.permissions Ihrer Richtliniendatei an.

Optionen zum Erstellen von Richtlinien

Auf der Seite Richtlinien in der Cloud de Confiance Console können Sie IAM-UAPs erstellen. Wir empfehlen, nur UAPs (IAM v3-Richtlinien) zu erstellen.

Sowohl in der gcloud CLI als auch in der REST API können Sie IAM-UAPs konfigurieren, indem Sie zuerst eine JSON-formatierte Datei erstellen. Wir empfehlen, nur UAPs zu erstellen.

End-to-End-Authentifizierung und ‑Autorisierung

IAP und kontextsensitiver Zugriff bieten standardmäßige End-to-End-Authentifizierung und ‑Autorisierung der Agentenidentität mithilfe der folgenden Protokolle:

• Gegenseitiges TLS (mTLS)
• Nachweis des Besitzes (Device Proof of Possession, DPoP)

Agentenidentitäten werden mit einem X.509-Zertifikat und einem zertifikatsgebundenen Token bereitgestellt. IAP erzwingt, dass Agentenidentitäten gegenseitiges TLS (mTLS) verwenden, um sich bei Agent Gateway zu authentifizieren. Wenn das Gateway dem Agent den Zugriff auf Cloud de Confiance -APIs, MCP-Server, andere Agents und Endpunkte erlaubt, versucht der Agent, außerhalb der mTLS-Grenze zuzugreifen. Um die Kommunikation zu schützen, wird durch den kontextsensitiven Zugriff eine von Google verwaltete Richtlinie für den kontextsensitiven Zugriff erzwungen. Gemäß den Richtlinienanforderungen muss DPoP das an die Agent Identity gebundene, zertifikatgebundene Token validieren. Weitere Informationen zur Verwendung von mTLS und DPoP durch den kontextsensitiven Zugriff finden Sie unter Sicherheit des Agents für den kontextsensitiven Zugriff.

UAP-CEL-Attribute

In Ihren UAPs können Sie Bedingungen mit bedingten Ausdrücken definieren. Die Ausdrücke können mehrere untergeordnete Ausdrücke enthalten. Der Zielressourcentyp, den Sie in jeder relationalen Unterbedingung verwenden, bestimmt, welche Attribute Sie verwenden können.

Im folgenden Beispiel ist im Teilausdruck destination.unregistered.path.startsWith('/v1/statements') der Ressourcentyp ein nicht registriertes Ziel, das Attribut ist destination.unregistered.path und startsWith() ist die CEL-Funktion.

destination.unregistered.host == 'finance.example.com' &&
destination.unregistered.path.startsWith('/v1/statements')

Die in der folgenden Tabelle beschriebenen Attribute sind für jeden Ressourcentyp verfügbar:

Nächste Schritte

• CEL-Attribute für UAPs
• IAM-UAPs erstellen
• IAM-UAPs verwalten
• Fehlerbehebung bei IAM-UAPs