Remote-Agent mit Workload Identity-Föderation authentifizieren

Unterstützt in:

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 zu sts.googleapis.com, iamcredentials.googleapis.com und Ihrem Chronicle API-Standortendpunkt (REGION-chronicle.googleapis.com, konfiguriert in ONE_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.

  1. Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf. Zu Workload Identity-Pools
  2. Klicken Sie auf Pool erstellen.
  3. Geben Sie einen Namen und eine Beschreibung für den Pool ein (z. B. soar-remote-agent-pool).
  4. Klicken Sie auf Weiter.
  5. 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.
  6. 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.
  7. 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.

  1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
  2. Wählen Sie Ihr Remote-Agent-Dienstkonto aus.
  3. Klicken Sie auf den Tab Hauptkonten mit Zugriff.
  4. Klicken Sie auf Zugriff erlauben.
  5. 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/*
  6. Wählen Sie in der Liste Rolle auswählen die Option Workload Identity-Nutzer (roles/iam.workloadIdentityUser) aus.
  7. 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)

  1. Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
  2. Wählen Sie Ihren Workload Identity-Pool aus und klicken Sie auf Zugriff gewähren.
  3. Wählen Sie im Bereich Zugriff gewähren die Option Zugriff mit Identitätsübernahme des Dienstkontos gewähren aus.
  4. Wählen Sie in der Liste Dienstkonto auswählen das Dienstkonto für den Remote-Agent aus.
  5. 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).
  6. Klicken Sie auf Speichern.
  7. 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 in agent-key.json um).
  8. Übertragen Sie die Datei agent-key.json auf 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:

  1. Gehen Sie zu Einstellungen > Zugriffsverwaltung > Gruppenzuordnung.
  2. Klicken Sie auf Hinzufügen Hinzufügen.
  3. Geben Sie im Dialogfeld Rolle hinzufügen die vollständige E-Mail-Adresse des Dienstkontos in das Feld IAM-Rolle / IdP-Gruppe ein.
  4. Wählen Sie die entsprechenden Umgebungen aus, die der Remote-Agent verwalten soll.
  5. Klicken Sie auf Hinzufügen.

Schritt 5: Remote-Agent-Authentifizierung bereitstellen oder aktualisieren

Podman

So konfigurieren Sie die Remote-Agent-Authentifizierung in Podman:

  1. Listen Sie die ausgeführten Podman-Container auf:
    podman ps
  2. Geben Sie die Container-ID Ihres KI-Agenten ein:
    CONTAINER_ID
  3. 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
  4. 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
  5. 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:

  1. Listen Sie die ausgeführten Docker-Container auf:
    docker ps
  2. Geben Sie die Container-ID Ihres KI-Agenten ein:
    CONTAINER_ID
  3. 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
  4. 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
  5. 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:

  1. Verschieben Sie die Konfigurationsdatei für Anmeldedaten in den erwarteten Pfad:

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. 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
  3. Führen Sie den folgenden Befehl aus, um den Agent-Dienst neu zu starten:
    supervisorctl restart siemplify_agent

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten