IAM-Richtlinien – Übersicht

Sie können IAM-Zulassungs- und ‑Ablehnungsrichtlinien erstellen, die von Agent Gateway verwendet werden, um die Kommunikation zwischen Ihren KI-Agenten und anderen Diensten, einschließlich anderer KI-Agenten, MCP-Server und Endpunkte, sicher zu verwalten. Agent Gateway verwendet Identity-Aware Proxy (IAP), um die Richtlinien zu erzwingen. IAP erzwingt auch die End-to-End-Authentifizierung und Autorisierung der Agentenidentität.

Informationen zum Erstellen einer IAM-Richtlinie für Agent Gateway finden Sie unter IAM-Richtlinien erstellen.

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. Im Probelaufmodus protokolliert IAP nicht zulässige agentische Kommunikation in Cloud-Audit-Logs, blockiert sie aber nicht.

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.

Richtlinienkomponenten

Richtlinien haben die folgenden Komponenten:

• Agents: In Ihren IAM-Zulassungsrichtlinien werden Quell-Agents durch ihre Agent-Identität definiert (die Identität des Agents, der die Kommunikation mit einem Dienst initiiert). Informationen dazu, wie verschiedene Arten von KI-Agenten Identitäten erhalten, finden Sie unter Identität von KI-Agenten. Agentenidentitäten werden durch Prinzipal-IDs dargestellt, die die SPIFFE-formatierte Identität des Agenten enthalten, z. B. principal://agents.global.org-.... Hinweis: Agent-Kennungen im URN-Format (z. B. urn:agent:...) werden nur für die Bestands- und Katalogsuche verwendet und nicht in IAM-Richtlinienbindungen. Wenn Sie die gcloud CLI zum Konfigurieren der IAM-Richtlinie verwenden, ist der Agent-Principal das Mitglied, dem Sie Zugriff gewähren.

  Gemini Enterprise-KI-Agenten und Agent Runtime-Instanzen wird automatisch eine Agent-Identität zugewiesen und sie werden in der Agent Registry registriert.

• Agent Registry-Ressource: Der Agent Registry-Dienst, für den Sie den Zugriff zulassen oder verweigern. In IAM-Zulassungs- und ‑Ablehnungsrichtlinien werden Agent Registry-Dienste als Ressourcen bezeichnet. Die Ressource kann eine gesamte Registry in einem Projekt oder ein einzelner Dienst sein, z. B. ein MCP-Server, ein KI-Agent oder ein Endpunkt.

  Einzelne Dienste müssen in der Agent Registry registriert werden, bevor in einer IAM-Richtlinie auf sie verwiesen werden kann. Diese Registrierung wird zur Bindungszeit (wenn die Richtlinienbindung erstellt oder aktualisiert wird) validiert. Wenn Sie auf einen Dienst verweisen, der nicht registriert ist, schlägt die Richtlinienerstellung sofort mit dem Fehler „Angeforderte Entität nicht gefunden“ (NOT_FOUND) fehl.

  Wenn Sie Richtlinien mit der gcloud CLI oder Terraform konfigurieren, werden Zielressourcen anhand ihrer vom Registry generierten Pfade oder IDs (mit Flags wie --agent, --endpoint oder --mcp-server) und nicht anhand ihrer logischen URN-Kennungen angegeben. Zur Laufzeit gleicht das sichere Gateway Trafficziele anhand des genauen Hostnamens ab, anstatt URNs zu verwenden.

  Wenn Sie Ihre Agent-Registrierungen regionalisieren, gilt Ihre IAM-Zulassungsrichtlinie nur für die Ressourcen in der Region der Registrierung.

• Rolle: Bei Richtlinien für die Kommunikation mit KI-Agenten wird immer die Rolle IAP-secured Egressor (roles/iap.egressor) für die Dienstressource gewährt.

• Bedingung: Optional können Sie eine Bedingung für die IAM-Zulassungsrichtlinie konfigurieren, um den Zugriff des Agents weiter einzuschränken. In derCloud de Confiance -Konsole können Sie mit dem Tool zur Bedingungserstellung eine Bedingung erstellen, indem Sie UI-Elemente auswählen. Alternativ können Sie den Bedingungseditor verwenden, um komplexere Bedingungen als Common Expression Language (CEL)-Ausdrücke einzugeben.

  In der folgenden Tabelle sind die Attributnamen aufgeführt, die Sie zum Erstellen von CEL-Ausdrücken verwenden können. Da der direkte Feldzugriff (z. B. request.mcp.toolName) nicht unterstützt wird, müssen Sie die Funktion api.getAttribute() verwenden, um den Wert jedes Attributs abzurufen.

  Weitere Informationen zum Konfigurieren von Zulassungsrichtlinien mit Bedingungen finden Sie unter IAM-Agent-Richtlinien konfigurieren.

  Attributname	Beschreibung und CEL-Beispiel
  mcp.toolName	Name des aufgerufenen Tools. Beispiel: request.mcp.toolName == 'GetCalendarEvents'
  iap.googleapis.com/mcp.resourceName	Name der Ressource, auf die zugegriffen wird. Beispiel: api.getAttribute('iap.googleapis.com/mcp.resourceName', '') == 'my-resource'
  iap.googleapis.com/mcp.promptName	Der Name des verwendeten Prompts. Beispiel: api.getAttribute('iap.googleapis.com/mcp.promptName', '') == 'my-prompt'
  mcp.method	Der spezifische MCP-Vorgang (z.B. „tools/call“, „resources/read“).
  iap.googleapis.com/mcp.tool.isReadOnly iap.googleapis.com/mcp.tool.isDestructive iap.googleapis.com/mcp.tool.isIdempotent iap.googleapis.com/mcp.tool.isOpenWorld	Boolesche Flags, die den Vorgangstyp angeben. Beispiel: api.getAttribute('iap.googleapis.com/mcp.tool.isReadOnly', false) == true
  request.auth.type	Enum, das das Protokoll angibt (z.B. „MCP“).

Richtlinien erstellen

Auf der Seite Policies (Richtlinien) in der Cloud de Confiance Console erstellen Sie IAM-Zulassungs- und ‑Ablehnungsrichtlinien, die von Agent Gateway zur Steuerung von Agent-Kommunikationen verwendet werden.

In der gcloud CLI können Sie sowohl IAM-Zulassungs- als auch IAM-Ablehnungsrichtlinien konfigurieren, die von Agent Gateway zur Steuerung von Agent-Kommunikationen verwendet werden.

Richtlinien in der Cloud de Confiance -Konsole

Informationen zum Erstellen von IAM-Richtlinien mit der Cloud de Confiance Console finden Sie unter IAM-Richtlinien konfigurieren.

Richtlinien in der gcloud CLI

Informationen zum Erstellen von IAM-Richtlinien mit der gcloud CLI finden Sie unter IAM-Richtlinien konfigurieren.

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 dazu, wie der kontextsensitiven Zugriff End-to-End-Sicherheit mit mTLS und DPoP bietet, finden Sie unter Sicherheit des Agents für kontextsensitiven Zugriff.

Nächste Schritte