Remote-Agent mit Workload Identity-Föderation authentifizieren
In diesem Dokument wird beschrieben, wie Sie die schlüssellose Authentifizierung für Google SecOps Remote Agents mithilfe der Workload Identity-Föderation (WIF) konfigurieren. Mit der Workload Identity-Föderation müssen Sie keine langlebigen JSON-Schlüsseldateien für Dienstkonten mehr auf Remote-Agent-Hostumgebungen herunterladen, verwalten und speichern.
Mit der Workload Identity-Föderation verwenden Remote-Agents, die auf externen Cloud-Anbietern, lokaler Infrastruktur, Kubernetes-Clustern oder CI/CD-Pipelines ausgeführt werden, kurzlebige föderierte Google Cloud -Zugriffstokens, die von ihrem externen Identitätsanbieter abgeleitet werden.
Hinweis
Prüfen Sie vor der Konfiguration der Workload Identity-Föderation die folgenden Voraussetzungen:
- Remote-Agent-Version 2.6.2 oder höher.
- Der Nutzer, der die Workload Identity-Föderation konfiguriert, muss die erforderlichen IAM-Berechtigungen in Google Cloud haben, um Workload Identity-Pools (
roles/iam.workloadIdentityPoolAdmin) und Dienstkonten (roles/iam.serviceAccountAdmin) zu erstellen und zu verwalten. - Ein dediziertes Dienstkonto, das in Google Cloud mit der Rolle Chronicle SOAR Remote Agent (
roles/chronicle.soarRemoteAgent) erstellt wurde. Eine Anleitung zum Erstellen eines Dienstkontos finden Sie unter Dienstkonto erstellen. - Zugriff auf Ihren externen Identitätsanbieter (AWS, Azure, Active Directory/ADFS, Kubernetes, CI/CD-Pipeline, X.509-Zertifizierungsstelle oder benutzerdefinierter OIDC-/SAML-Anbieter).
- Ihre Firewall muss ausgehenden HTTPS-Traffic (TCP-Port
443) vom Remote-Agent-Host zusts.googleapis.com,iamcredentials.googleapis.comund Ihrem Chronicle API-Standortendpunkt (REGION-chronicle.googleapis.com, konfiguriert inONE_PLATFORM_URL_DOMAIN) zulassen. Eine vollständige Zulassungsliste und Details zu Private Service Connect finden Sie unter Anforderungen für Netzwerk und Private Service Connect und Netzwerk- und Firewallanforderungen.
Schritt 1: Workload Identity-Pool und -Anbieter erstellen
In Google Cloudverwalten Workload Identity-Pools externe Identitäten, während Workload Identity-Anbieter die Verbindungsparameter zwischen Ihrem externen IdP und Google Clouddefinieren.
- Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf. Zu Workload Identity-Pools
- Klicken Sie auf Pool erstellen.
- Geben Sie einen Namen und eine Beschreibung für den Pool ein (z. B.
soar-remote-agent-pool). - Klicken Sie auf Weiter.
- Wählen Sie im Abschnitt Anbieter zum Pool hinzufügen den Anbietertyp aus und geben Sie die Verbindungsdetails des Anbieters (z. B. AWS-Konto-ID oder OIDC-Aussteller und Zielgruppe) aus dem Leitfaden Ihres Anbieters ein.
- Ordnen Sie im Abschnitt Attributzuordnungen konfigurieren Anforderungen aus Ihrem externen Token (z. B.
google.subject=assertion.sub) Google Cloud IAM-Attributen zu, wie in der Anleitung Ihres Anbieters beschrieben. - Klicken Sie auf Speichern.
Schritt 2: Berechtigungen für die Identitätsübernahme des Dienstkontos gewähren
Erlauben Sie externen Identitäten in Ihrem Workload Identity-Pool, die Identität Ihres Remote-Agent-Dienstkontos zu übernehmen.
- Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
- Wählen Sie Ihr Remote-Agent-Dienstkonto aus.
- Klicken Sie auf den Tab Hauptkonten mit Zugriff.
- Klicken Sie auf Zugriff erlauben.
- Geben Sie im Feld Neue Hauptkonten die Hauptkonto-ID ein, die Ihrem Workload Identity-Pool entspricht:
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
- Wählen Sie in der Liste Rolle auswählen die Option Workload Identity-Nutzer (
roles/iam.workloadIdentityUser) aus. - Klicken Sie auf Speichern.
Schritt 3: Anmeldedaten für externe Konten (agent-key.json) herunterladen oder generieren
Rufen Sie auf dem Hostcomputer des Remote-Agents mit einer der folgenden Optionen eine Konfigurationsdatei für externe Kontoanmeldedaten mit dem Namen agent-key.json ab.
Option A: Aus der Google Cloud Console herunterladen (empfohlen)
- Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Wählen Sie Ihren Workload Identity-Pool aus und klicken Sie auf Zugriff gewähren.
- Wählen Sie im Bereich Zugriff gewähren die Option Zugriff mit Identitätsübernahme des Dienstkontos gewähren aus.
- Wählen Sie in der Liste Dienstkonto auswählen das Dienstkonto für den Remote-Agent aus.
- Geben Sie im Abschnitt Hauptkonten auswählen (Identitäten, die auf das Dienstkonto zugreifen können) an, welche Identitäten auf das Dienstkonto zugreifen können (z. B. durch Auswahl eines Attributnamens und -werts).
- Klicken Sie auf Speichern.
- Im Fenster Anwendung konfigurieren:
- Wählen Sie Ihren Workload Identity-Anbieter aus.
- Geben Sie im Feld OIDC-ID-Token-Pfad den genauen Pfad ein, in dem Ihr externes Token bereitgestellt oder gespeichert ist. Bei projizierten Kubernetes-Tokens muss dieser mit dem in Ihrem Pod-Manifest definierten
mountPath+pathübereinstimmen, z. B./var/run/secrets/tokens/gcp-kms-token. - Legen Sie für Formattyp die Option Text (unformatierter JWT-String) fest. Wählen Sie JSON nicht für Standard-Tokendateien aus.
- Klicken Sie auf Konfiguration herunterladen und speichern Sie die Datei als
agent-key.json(oder benennen Sie die heruntergeladene Datei inagent-key.jsonum).
- Übertragen Sie die Datei
agent-key.jsonauf den Hostcomputer des Remote-Agents.
Option B: Mit der gcloud CLI generieren
Führen Sie den Befehl gcloud iam workload-identity-pools create-cred-config aus, um die Konfigurationsdatei für die Anmeldedaten zu generieren:
gcloud iam workload-identity-pools create-cred-config \ projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \ --service-account=SERVICE_ACCOUNT_EMAIL \ --output-file=agent-key.json \ --credential-source-file=/var/run/secrets/tokens/gcp-kms-token
Referenz für Beispielkonfigurationsdatei
Die generierte agent-key.json-Datei hat eine Struktur, die in etwa so aussieht:
{ "type": "external_account", "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:jwt", "token_url": "https://sts.googleapis.com/v1/token", "credential_source": { "file": "/var/run/secrets/tokens/gcp-kms-token" }, "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken" }
Schritt 4: Dienstkonto in Google SecOps zuordnen
Bevor Sie den Remote-Agent bereitstellen, müssen Sie die E-Mail-Adresse des Dienstkontos in Google SecOps autorisieren:
- Gehen Sie zu Einstellungen > Zugriffsverwaltung > Gruppenzuordnung.
- Klicken Sie auf Hinzufügen Hinzufügen.
- Geben Sie im Dialogfeld Rolle hinzufügen die vollständige E-Mail-Adresse des Dienstkontos in das Feld IAM-Rolle / IdP-Gruppe ein.
- Wählen Sie die entsprechenden Umgebungen aus, die der Remote-Agent verwalten soll.
- Klicken Sie auf Hinzufügen.
Schritt 5: Remote-Agent-Authentifizierung bereitstellen oder aktualisieren
Podman
So konfigurieren Sie die Remote-Agent-Authentifizierung in Podman:
-
Listen Sie die ausgeführten Podman-Container auf:
podman ps -
Geben Sie die Container-ID Ihres KI-Agenten ein:
CONTAINER_ID
-
Verwenden Sie den folgenden Befehl, um die Konfigurationsdatei für Anmeldedaten in den dedizierten Pfad im Container zu kopieren:
podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
Verwenden Sie den folgenden Befehl, um den Inhaber der Konfigurationsdatei für Anmeldedaten im Container zu ändern:
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Führen Sie den folgenden Befehl aus, um die Änderungen anzuwenden:
podman restart CONTAINER_ID
Docker
So konfigurieren Sie die Remote-Agent-Authentifizierung in Docker:
-
Listen Sie die ausgeführten Docker-Container auf:
docker ps -
Geben Sie die Container-ID Ihres KI-Agenten ein:
CONTAINER_ID
-
Verwenden Sie den folgenden Befehl, um die Konfigurationsdatei für Anmeldedaten in den dedizierten Pfad im Container zu kopieren:
docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
Verwenden Sie den folgenden Befehl, um den Inhaber der Konfigurationsdatei für Anmeldedaten im Container zu ändern:
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Führen Sie den folgenden Befehl aus, um die Änderungen anzuwenden:
docker restart CONTAINER_ID
Person, die die App installiert hat
So konfigurieren Sie die Remote-Agent-Authentifizierung unter CentOS/RHEL:
-
Verschieben Sie die Konfigurationsdatei für Anmeldedaten in den erwarteten Pfad:
mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
-
Verwenden Sie den folgenden Befehl, um den Inhaber der Konfigurationsdatei für Anmeldedaten zu ändern:
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Führen Sie den folgenden Befehl aus, um den Agent-Dienst neu zu starten:
supervisorctl restart siemplify_agent
Weitere Dokumentation
- Authentifizierungsinfrastruktur für Remote-Agenten migrieren
- Sicherheit für Remote-Mitarbeiter – Übersicht
- Fehlerbehebung bei Remote-Agenten
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten