Authentifizierungsinfrastruktur für Remote-Agenten migrieren

Unterstützt in:

Google SecOps SOAR

In diesem Dokument wird beschrieben, wie Sie Ihre Remote-Agent-Infrastruktur mit Google Cloud -Dienstkonten migrieren. Diese Migration betrifft nur die Authentifizierungsinfrastruktur. Sie müssen Ihre Remote-Agent-Instanzen oder -Hosts nicht migrieren oder ersetzen.

Schlüssellose Authentifizierung: Informationen zum Konfigurieren der schlüssellosen Authentifizierung für Remote-Agents, ohne JSON-Schlüsseldateien für Dienstkonten auf Hostcomputern zu speichern, finden Sie unter Remote-Agent mit Workload Identity-Föderation authentifizieren.

Hinweis

Sie benötigen Folgendes:

• Erforderliche Berechtigungen zum Erstellen von Dienstkonten in Google Cloud.
• Erforderliche Rollen zum Erstellen von Dienstkontoschlüsseln.
• Erforderliche Mindestversion des Remote-Agents: 2.6.2 und höher.

Netzwerk- und Private Service Connect-Anforderungen

Nach der Migration der Authentifizierungsinfrastruktur kommuniziert der Remote-Agent über Standard-Google APIs anstelle der Legacy-*.siemplify-soar.com-Endpunkte mit der Chronicle API.

Zulassungsliste für Endpunkte für ausgehenden Traffic

Prüfen Sie, ob Ihre Firewall ausgehenden HTTPS-Traffic über TCP-Port 443 vom Remote-Agent-Host zu den folgenden Endpunkten zulässt:

• Lassen Sie ausgehenden HTTPS-Traffic zu Ihrem Google Security Operations Chronicle API-Standortendpunkt (<var>REGION</var>-chronicle.googleapis.com, konfiguriert in ONE_PLATFORM_URL_DOMAIN, z. B. asia-southeast1-chronicle.googleapis.com) und Ihrem Mandanten-Publisher-Hostnamen (SERVER_API_ROOT) zu.
• Lassen Sie ausgehenden HTTPS-Traffic zu den Google Cloud -Authentifizierungsendpunkten zu: oauth2.googleapis.com (für den Austausch von Dienstkontotokens), sts.googleapis.com und iamcredentials.googleapis.com (für die schlüssellose Authentifizierung mit der Identitätsföderation von Arbeitslasten).
• Lassen Sie ausgehenden HTTPS-Traffic zu den Container-Registries zu, die für Podman- oder Docker-Bereitstellungen verwendet werden, z. B. *.pkg.dev (einschließlich us-docker.pkg.dev) und gcr.io für Artifact Registry oder docker.io.

Hinweis: Das regionale Endpunktformat (chronicle.<var>REGION</var>.rep.googleapis.com) wird für die Verbindung der Steuerungsebene des Remote-Agents nicht unterstützt.

Weitere Informationen finden Sie unter Netzwerk- und Firewallanforderungen.

Private Service Connect-Konfiguration

Wenn Ihr Remote-Agent privat mit Google APIs verbunden ist (z. B. von einem lokalen Netzwerk, Amazon Web Services (AWS) oder Microsoft Azure über Cloud Interconnect oder Cloud VPN), führen Sie die folgende Konfiguration durch:

1. Erstellen Sie in Ihrer Virtual Private Cloud einen Private Service Connect-Endpunkt für Google APIs (mit dem Bundle all-apis oder vpc-sc). Eine Anleitung finden Sie unter Private Service Connect für Google APIs konfigurieren.
2. Konfigurieren Sie privates DNS so, dass die erforderlichen Endpunkte in die IP-Adresse Ihres Private Service Connect-Endpunkts aufgelöst werden. Konfigurieren Sie in Google Cloudeine private Cloud DNS-Zone für googleapis.com. Außerhalb vonGoogle Cloudverwenden Sie die bedingte DNS-Weiterleitung oder eine private gehostete Zone (z. B. AWS Route 53).
3. Lassen Sie alle Legacy-SOAR-Private Service Connect-Verbindungen (ein Ersteller-Dienstanhang für <var>TENANT</var>.siemplify-soar.com) aktiv, bis Sie alle Remote-Agents migriert haben.

Dienstkonto erstellen

Ein Dienstkonto ist ein spezieller Google-Kontotyp, der von einer Anwendung für autorisierte API-Aufrufe verwendet wird.

Wichtig: Weisen Sie jedem Remote-Agenten ein eindeutiges Dienstkonto zu. Da für Dienstkonten individuelle API-Ratenbegrenzungen und -Kontingente gelten, kann die gemeinsame Nutzung eines Dienstkontos durch mehrere Agents zu einer Erschöpfung der Kontingente und zu Kommunikationsfehlern führen.

So erstellen Sie ein Dienstkonto:

1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
Zur Seite „Dienstkonten“
2. Klicken Sie auf Dienstkonto erstellen.
3. Führen Sie im Abschnitt Dienstkontodetails folgende Schritte aus:
   1. Geben Sie einen Namen für das Dienstkonto ein.
   2. Geben Sie eine Beschreibung für das Dienstkonto ein.
   3. Klicken Sie auf Erstellen und fortfahren.
4. Führen Sie im Abschnitt Berechtigungen folgende Schritte aus:
   1. Wählen Sie in der Liste Rolle auswählen die Rolle Chronicle SOAR Remote Agent aus.
   2. Klicken Sie auf Weiter.
5. Klicken Sie im Abschnitt Nutzern Zugriff auf dieses Dienstkonto erteilen auf Fertig.

Dienstkontoschlüssel erstellen

Der Dienstkontoschlüssel ist für die Authentifizierung des Remote-Agents erforderlich. So erstellen Sie diesen Schlüssel:

1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
Zur Seite „Dienstkonten“
2. Klicken Sie auf den Namen des Dienstkontos, das Sie erstellt haben.
3. Klicken Sie auf den Tab Schlüssel.
4. Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
5. Wählen Sie als Schlüsseltyp JSON aus und klicken Sie dann auf Erstellen.

   A JSON file containing the key is downloaded to your computer.
   

6. Klicken Sie auf Schließen.

Schlüsseldatei sicher speichern

Nachdem Sie den Dienstkontoschlüssel heruntergeladen haben, müssen Sie ihn auf den Hostcomputer verschieben, auf dem der Remote-Agent ausgeführt wird.

Warnung: Übertragen Sie diese Schlüsseldatei nicht in Ihr Quellcode-Repository. Behandle es wie ein vertrauliches Passwort.

Podman

1. Suchen Sie die heruntergeladene JSON-Datei auf Ihrem Computer.
2. Speichern Sie die Datei an einem sicheren Ort auf dem Hostcomputer, auf den der Agent-Prozess zugreifen kann.
3. Geben Sie den vollständigen Pfad des Dienstkontoschlüssels Ihres Agents auf dem Hostcomputer ein.

   AGENT_SERVICE_ACCOUNT_PATH

Docker

1. Suchen Sie die heruntergeladene JSON-Datei auf Ihrem Computer.
2. Speichern Sie die Datei an einem sicheren Ort auf dem Hostcomputer, auf den der Agent-Prozess zugreifen kann.
3. Geben Sie den vollständigen Pfad des Dienstkontoschlüssels Ihres Agents auf dem Hostcomputer ein.

   AGENT_SERVICE_ACCOUNT_PATH

Person, die die App installiert hat

1. Suchen Sie die heruntergeladene JSON-Datei auf Ihrem Computer.
2. Speichern Sie die Datei am folgenden Speicherort:

   AGENT_SERVICE_ACCOUNT_PATH

3. Notieren Sie sich den vollständigen Pfad zu dieser Datei, da Sie ihn beim Konfigurieren des Remote-Agents benötigen.

Dienstkonto für Remote-Agenten zuordnen

Nachdem Sie das Dienstkonto für Ihren Remote-Agent erstellt haben, müssen Sie es auf der Plattform autorisieren, damit es mit Google SecOps kommunizieren kann.

Wenn Sie einem Dienstkonto oder einer Workload Identity-Föderation Zugriff auf Google SecOps gewähren möchten, müssen Sie die Identität den Zugriffssteuerungsparametern der Plattform zuordnen. Diese Zuordnung ist ein obligatorischer Schritt, um der Identität den erforderlichen Zugriff auf SOC-Rollen und Umgebungen zu gewähren, die für die Ausführung automatisierter Aufgaben oder API-Vorgänge erforderlich sind.

1. Rufen Sie die SOAR-Einstellungen > Erweitert > Gruppenzuordnung auf.
2. Klicken Sie auf Hinzufügen Hinzufügen.

3. Füllen Sie die Felder im Dialogfeld Zuordnung hinzufügen aus, um die Identität den Parametern für die Zugriffssteuerung der Plattform zuzuordnen.

   1. Geben Sie im Feld IdP / Nutzergruppe eine der folgenden Optionen ein:
      • Die vollständige E-Mail-Adresse Ihres Dienstkontos, wenn die Identität mit Cloud Identity eingerichtet wurde.
      • Der Workload Identity-Hauptkontostring, wenn die Identität mit der Workforce Identity-Föderation eingerichtet wurde.

   2. Konfigurieren Sie die folgenden Felder für die Zugriffssteuerung:

      Feld	Beschreibung
      Berechtigungsgruppen	Wählen Sie die Berechtigungsgruppen aus, um festzulegen, auf welche Module und Untermodule die Identität zugreifen kann.
      SOC-Rollen	Wählen Sie die SOC-Rollen aus, um die Rolle der Identität zu definieren (z. B. Tier 1).
      Umgebungen	Wählen Sie die Umgebungen oder Umgebungsgruppen aus, auf die die Identität zugreifen kann (z. B. Alle Umgebungen).
      Gruppenmitglieder	Geben Sie gegebenenfalls die erforderlichen E‑Mail-Adressen der Nutzer ein. Drücken Sie nach jeder E‑Mail-Adresse die Eingabetaste.
      Eingeschränkte Aktionen	Wählen Sie die eingeschränkten Aktionen aus, um bestimmte Vorgänge innerhalb von Modulen einzuschränken.

4. Klicken Sie auf Hinzufügen.

Remote-Agent-Authentifizierung für Google Cloudkonfigurieren

Podman

Wenn Sie einen neuen Agenten bereitstellen, lesen Sie den Hilfeartikel Agenten mit Podman bereitstellen.

Wenn Sie ein Upgrade für einen Agent ausführen, lesen Sie den Abschnitt Upgrade für einen Agent mit Podman ausführen.

Docker

Wenn Sie einen neuen Agenten bereitstellen, lesen Sie den Abschnitt Agenten mit Docker bereitstellen.

Wenn Sie ein Upgrade für einen Agent durchführen, lesen Sie den Abschnitt Upgrade für einen Agent mit Docker durchführen.

Person, die die App installiert hat

Wenn Sie einen neuen Agenten bereitstellen, lesen Sie entweder Agent mit CentOS bereitstellen oder Agent mit RHEL bereitstellen.

Wenn Sie ein Upgrade für einen Agent durchführen, lesen Sie entweder Upgrade für einen Agent mit CentOS durchführen oder Upgrade für einen Agent mit RHEL durchführen .

Umgebungsvariablen für vorhandenen Agenten migrieren

Hinweis: Dieser Schritt kann für Remote-Agents übersprungen werden, die nach dem 10. Mai 2026 installiert wurden, da die Umgebungsvariablen in der Containerbefehls-/.env-Datei vorhanden sind.

Rufen Sie die SOAR-Einstellungen > Erweitert > Remote-Agenten auf und klicken Sie beim gewünschten Remote-Agenten auf Mehr anzeigen.

Kopieren Sie die folgenden Werte aus dem Feld Docker-Befehl und fügen Sie sie in die folgenden Befehle ein.
Sie benötigen sie für die Migration:

• ONE PLATFORM URL DOMAIN.

  ONE_PLATFORM_URL_DOMAIN

• ONE PLATFORM URL PROJECT.

  ONE_PLATFORM_URL_PROJECT

• ONE PLATFORM URL LOCATION.

  ONE_PLATFORM_URL_LOCATION

• ONE PLATFORM URL INSTANCE.

  ONE_PLATFORM_URL_INSTANCE

Podman

So migrieren Sie die Umgebungsvariablen des Remote-Agents:

1. Listen Sie die ausgeführten Podman-Container auf.

   podman ps

2. Geben Sie die Container-ID Ihres KI-Agenten ein:

   CONTAINER_ID

3. Fügen Sie die folgenden Umgebungsvariablen aus den vorherigen Verfahren ein und führen Sie diesen Befehl aus:

   podman exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Docker

So migrieren Sie die Umgebungsvariablen des Remote-Agents:

1. Listet laufende Docker-Container auf.

   docker ps

2. Geben Sie die Container-ID Ihres KI-Agenten ein:

   CONTAINER_ID

3. Fügen Sie die folgenden Umgebungsvariablen aus den vorherigen Verfahren ein und führen Sie diesen Befehl aus:

   docker exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Person, die die App installiert hat

So migrieren Sie die Umgebungsvariablen des Remote-Agents:

Fügen Sie die folgenden Umgebungsvariablen aus den vorherigen Verfahren ein und führen Sie diesen Befehl aus:

cat << EOF >> /home/siemplify_agent/.bash_profile
export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN
export ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT
export ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION
export ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE
export GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json
EOF

Dienstkonto zum Remote-Agenten migrieren

Sobald dieser Schritt abgeschlossen ist und alle Umgebungsvariablen im Remote-Agenten vorhanden sind, ist die Migration abgeschlossen und der Remote-Agent kommuniziert über Google Cloud .

Podman

So migrieren Sie die Authentifizierungsinfrastruktur für Remote-Agents:

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 den Dienstkontoschlüssel in einen dedizierten Pfad im Container zu kopieren.

   podman cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

4. Verwenden Sie den folgenden Befehl, um den Inhaber des Dienstkontoschlüssels 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 migrieren Sie die Authentifizierungsinfrastruktur für Remote-Agents:

1. Listet laufende Docker-Container auf.

   docker ps

2. Geben Sie die Container-ID Ihres KI-Agenten ein:

   CONTAINER_ID

3. Verwenden Sie den folgenden Befehl, um den Dienstkontoschlüssel in einen dedizierten Pfad im Container zu kopieren.

   docker cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

4. Verwenden Sie den folgenden Befehl, um den Inhaber des Dienstkontoschlüssels 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 migrieren Sie die Authentifizierungsinfrastruktur für Remote-Agents:

1. Verschieben Sie das Dienstkonto in den erwarteten Pfad.

   mv AGENT_SERVICE_ACCOUNT_PATH /opt/SiemplifyAgent/agent-key.json

2. Verwenden Sie den folgenden Befehl, um den Inhaber des Dienstkontoschlüssels im Container 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