Infrastruktur für die Authentifizierung von Remote-Agents migrieren

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie Ihre Remote Agents-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.

Hinweis

Sie benötigen Folgendes:

  • Erforderliche Berechtigungen zum Erstellen von Dienstkonten in Google Cloud.
  • Erforderliche Rollen zum Erstellen von Dienstkontoschlüsseln.
  • Mindestanforderung: Remote Agent-Version 2.6.2 und höher.

Dienstkonto erstellen

Ein Dienstkonto ist eine spezielle Art von Google-Konto, das von einer Anwendung für autorisierte API-Aufrufe verwendet wird.

So erstellen Sie ein Dienstkonto:

  1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
    2. 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 Bereich Nutzern Zugriff auf dieses Dienstkonto erteilen auf Fertig.

Dienstkontoschlüssel erstellen

Der Dienstkontoschlüssel ist erforderlich, um den Remote-Agenten zu authentifizieren. So erstellen Sie diesen Schlüssel:

  1. Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
    2. 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.

Podman

  1. Suchen Sie auf Ihrem Computer nach der heruntergeladenen JSON-Datei.
  2. Speichern Sie die Datei an einem sicheren Ort auf dem Hostcomputer, auf den der Agentprozess zugreifen kann.
  3. Geben Sie den vollständigen Pfad zum Dienstkontoschlüssel des 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 Agentprozess zugreifen kann.
  3. Geben Sie den vollständigen Pfad zum Dienstkontoschlüssel des Agents auf dem Hostcomputer ein. 
    AGENT_SERVICE_ACCOUNT_PATH

Person, die die App installiert hat

  1. Suchen Sie auf Ihrem Computer nach der heruntergeladenen JSON-Datei.
  2. Speichern Sie die Datei am folgenden Speicherort: 
    AGENT_SERVICE_ACCOUNT_PATH
  3. Notieren Sie sich den vollständigen Pfad zu dieser Datei, da er bei der Konfiguration des Remote-Agents erforderlich ist.

Dienstkonto des 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 Google SecOps Dienstkonto-Zugriff oder Workload Identity Federation-Zugriff gewähren möchten, müssen Sie die Identität den Zugriffskontrollparametern 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. Gehen Sie zu SOAR-Einstellungen> „Erweitert“ > „Gruppenzuordnung“.
  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 einen der folgenden Werte 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 bei Bedarf 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 in 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 Artikel Agenten mit Podman bereitstellen.

Wenn Sie ein Agent-Upgrade durchführen, lesen Sie den Abschnitt Agent mit Podman aktualisieren.

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 Agent mit Docker aktualisieren.

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 Agent-Upgrade durchführen, lesen Sie entweder Agent mit CentOS aktualisieren oder Agent mit RHEL aktualisieren .

Umgebungsvariablen für vorhandenen Agent migrieren

Gehen Sie zu SOAR-Einstellungen > Erweitert > Remote-Agents  und klicken Sie beim gewünschten Remote-Agent auf Mehr anzeigen.

Kopieren Sie die folgenden Werte aus dem Feld Docker Command (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. Laufende Podman-Container auflisten 
    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 in den 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. Laufende Podman-Container auflisten 
    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. Dienstkonto in den erwarteten Pfad verschieben

    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