Installationsprogramm und Docker konfigurieren

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie einen Agent konfigurieren, einschließlich des Aufrufs und der Änderung von Konfigurationsoptionen. Außerdem wird erläutert, wie Sie Proxy-Einstellungen für die Kommunikation zwischen Agent und Publisher sowie für Integrationen konfigurieren.

Remote-Agent-Konfiguration verwalten

So nehmen Sie Änderungen an einem Agenten vor:

  1. Melden Sie sich über SSH auf dem Agent-Computer an.
  2. Wechseln Sie zum Verzeichnis /home/siemplify_agent/agent_source. Wenn Sie Docker verwenden, müssen Sie sich im Container befinden.
  3. Führen Sie den folgenden Befehl aus, um alle primären Konfigurationsoptionen für das Dienstprogramm cli aufzurufen: 
    python agent_cli.py -h

    Führen Sie den Befehl printenv aus, um die aktuellen Werte für die aktiv verwendeten Konfigurationen zu prüfen.

  4. Verwenden Sie das Format set_option, um den Wert einer einzelnen primären Konfigurationsoption zu ändern:

    5. python agent_cli.py set_verify_ssl_slave false
  5. Mit dem Befehl update_environment können Sie eine größere Anzahl von Konfigurationen ändern, die als Umgebungsvariablen gespeichert sind:
    1. Rufen Sie die Liste der Umgebungsvariablen auf, die geändert werden können:
      2. python agent_cli.py update_environment -h
    2. Ändern Sie den Wert einer der folgenden Konfigurationen:
      3. python agent_cli.py update_environment VARIABLE_NAME VALUE

      Beispiel:

      python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS  30

Umgebungsvariablen für Remote-Agenten

In der folgenden Tabelle finden Sie detaillierte Informationen zu den Umgebungsvariablen, die mit dem Befehl python agent_cli.py update_environment konfiguriert werden können:

Option Beschreibung Werte
TASK_TIMEOUT Legt das Zeitlimit (in Sekunden) für Aufgaben fest, die der Agent abgerufen, aber nicht ausgeführt hat. Zeit (in Sekunden)
SERVER_API_ROOT Die primäre Publisher API-Serveradresse. Definiert, woher der Agent Aufgaben abruft und wohin er Ergebnisse veröffentlicht. Wenn Ihre Firewallrichtlinie keine Platzhalter-Domain-Einträge zulässt, können Sie diesen mandantenspezifischen Publisher-Hostnamen in Ihren Zulassungslistenregeln für ausgehenden Traffic verwenden. Weitere Informationen finden Sie unter Netzwerk- und Firewallanforderungen. API-Adresse
SERVER_API_TOKEN Das Authentifizierungstoken, das für alle an den Publisher gesendeten Anfragen verwendet wird. Server-API-Token (String)
VERIFY_SSL Bestimmt, ob der Agent nur dann eine Verbindung zu einem Publisher herstellen darf, wenn dieser ein signiertes SSL-Zertifikat vorweist. Boolescher Wert (True oder False)
RETRANSMISSION_LOOP_INTERVAL_SECONDS Legt die Zeitverzögerung (in Sekunden) zwischen den Prüfungen fest, um zu bestätigen, dass der Publisher die CASE_ACK für ein Connector-Paket erhalten hat. Zeit (in Sekunden)
RETRANSMISSION_SAVE_PERIOD_DAYS Maximale Zeit (in Tagen), die ein Connector-Paket im Ordner für die erneute Übertragung verbleiben kann, bevor es gelöscht wird, sofern die CASE_ACK nicht empfangen wurde. Zeit (in Tagen)
RETRANSMISSION_FOLDER_MAX_SIZE_MB Die maximale Größe (in MB), die der Ordner für die erneute Übertragung erreichen kann, bevor der Agent die ältesten Connector-Pakete löscht, um die Grenze einzuhalten. Größe (MB)
VERIFY_SSL_SLAVE Wenn der Wert auf True gesetzt ist, muss der sekundäre Publisher ein signiertes SSL-Zertifikat haben, bevor der Agent eine Kommunikation herstellt. Boolescher Wert (True oder False)
PROXY_ADDRESS Die IP-Adresse des Proxyservers, den der Agent für die Kommunikation mit dem primären Publisher verwendet. Proxy-IP-Adresse
AGENT_KEY Ein verschlüsselter Schlüssel, mit dem der Agent Pakete entschlüsselt, die vom Publisher abgerufen wurden, und Ergebnisse verschlüsselt, bevor sie wieder veröffentlicht werden. Verschlüsselter Agent-Schlüssel
SERVER_API_ROOT_SLAVE Die sekundäre Publisher API-Serveradresse, von der der Agent Aufgaben abruft und an die er Ergebnisse veröffentlicht. API-Adresse
PROXY_ADDRESS_SLAVE Die IP-Adresse des Proxyservers, den der Agent für die Kommunikation mit dem sekundären Publisher verwendet. Proxy-IP-Adresse
DEPLOYMENT_TYPE Gibt die Installationsmethode an, die für den Agent verwendet wurde. Docker oder Installer (String)

Agent-Publisher-Proxy konfigurieren

Konfigurieren Sie einen Proxyserver, um die gesamte Kommunikation zwischen dem Remote-Agent-Dienst und dem Publisher zu verarbeiten. Diese Konfiguration gilt nur für den Kommunikationskanal zwischen Agent und Publisher.

So konfigurieren Sie einen Agent-Publisher-Proxy:

  1. Führen Sie den Befehl update_environment auf dem Agent-Computer aus, um einen Proxy für einen vorhandenen bereitgestellten Agenten zu konfigurieren:
    2. python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
  2. Laden Sie das Paket herunter und bearbeiten Sie die Datei .env, um die Proxy-Adresse hinzuzufügen:
    3. PROXY_ADDRESS=https://{proxy_host}
  3. Fügen Sie die Proxy-Adresse als Umgebungsvariable (`-e`) zum Docker-Befehl hinzu, bevor Sie die Bereitstellung ausführen:
    4. -e PROXY_ADDRESS=https://{proxy_host}.

Integrationsproxy konfigurieren

In diesem Verfahren werden die Proxy-Einstellungen für Integrationen definiert, die auf dem Remote-Agent ausgeführt werden. So wird sichergestellt, dass der Integrations-Traffic über den angegebenen Proxyserver weitergeleitet wird.

Wenn Sie einen Integrationsproxy konfigurieren möchten, fügen Sie der Umgebung des Agents die erforderlichen Variablen hinzu, bevor Sie den Docker-Befehl ausführen:

Variable Beschreibung Beispiel
HTTP_PROXY Proxy-Adresse für HTTP-Anfragen https://{HTTP_PROXY}
HTTPS_PROXY Proxy-Adresse für HTTPS-Anfragen https://{HTTPS_PROXY}
NO_PROXY Durch Kommas getrennte Liste von Hostnamen/IP-Adressen, für die das Proxy-Routing umgangen werden soll https://{NO_PROXY}

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