Zum Inhalt springen

Proxy-Server für Jitterbit private Agenten

Einführung

Sie können einen privaten Agenten so konfigurieren, dass er über einen Proxy-Server kommuniziert. Wie Sie dies tun, hängt von der Plattform Ihres Agenten ab und davon, ob der Agent bereits installiert und aktiv ist. In jedem Fall müssen Sie die Details des Proxy-Servers (Hostname, Portnummer, Anmeldeinformationen) kennen. Diese werden in den folgenden Abschnitten durch die Platzhalter-Keywords dargestellt, die Sie durch die Werte für Ihren Proxy-Server ersetzen sollten:

Keyword Wert
HOSTNAME Hostname oder IP-Adresse.
PORT (Optional.) Portnummer. Standard: 0.
USERNAME/PASSWORD (Optional.) Benutzername und Passwort für Server, die eine Authentifizierung erfordern.
NTLM_DOMAIN (Optional.) NTLM-Domain für die NTLM-Authentifizierung.

Tipp

Für einen HTTPS-Proxy müssen Sie ein Zertifikat zum Java-Keystore hinzufügen.

Hinweis

Bei Agenten 12.7 und später verwendet der Observability-Metriken Dienst des Agenten diese Proxy-Konfiguration automatisch.

Konfigurieren eines Proxys während der Agenteneinrichtung

Um einen Proxy während der Einrichtung eines Agenten zu konfigurieren, befolgen Sie diese Schritte:

  1. Auf der Seite Anmeldeinformationen des Standard-Installers klicken Sie auf Proxy aktivieren.

  2. Auf der Seite Proxy-Informationen geben Sie die Informationen Ihres Proxy-Servers ein, wählen die gewünschten Optionen aus und klicken dann auf die Schaltfläche Ok:

    Proxy konfigurieren

  3. Starten Sie den Agenten neu.

Sie können einen Proxy-Server vor der Einrichtung des Agenten nicht konfigurieren und müssen die Befehlszeile oder das Konfigurationstool nach der Einrichtung des Agenten verwenden.

  1. Fügen Sie im Konfigurieren Schritt die unten gezeigten Argumente zum jitterbit-config Befehl hinzu, bevor Sie ihn ausführen:

    jitterbit-config --proxy-host HOSTNAME[:PORT] \
--proxy-user USERNAME \
--proxy-password PASSWORD \
--proxy-ntlm-domain NTLM_DOMAIN

  2. Starten Sie den Agenten neu.

  1. Richten Sie einen Reverse-Proxy ein.

  2. Konfigurieren Sie Docker, um einen Proxy-Server zu verwenden.

  3. Setzen Sie Werte für die folgenden Umgebungsvariablen, die an die Umgebung Ihres Containers übergeben werden sollen (übergeben mit den Optionen -e/--env oder --env-file):

    Umgebungsvariable Wert
    PROXY_SERVER_HOSTNAME HOSTNAME
    PROXY_SERVER_USERNAME USERNAME
    PROXY_SERVER_PASSWORD PASSWORD
    PROXY_SERVER_PORT PORT
    http_proxy http://host.docker.internal:8888
    https_proxy https://host.docker.internal:8888

  4. Starten Sie den Container mit manueller Registrierung und Umgebungsvariablen.

Nach der Agenten-Einrichtung konfigurieren

Um einen Proxy nach der Einrichtung eines Agenten zu verwenden, befolgen Sie diese Schritte:

Sie können einen Proxy über die Befehlszeile oder mit dem Konfigurationstool konfigurieren:

  1. Führen Sie in einer Eingabeaufforderung oder PowerShell den JitterbitUtils.exe Befehl aus:

    JitterbitUtils.exe --set-http-proxy-host HOSTNAME[:PORT] `
--set-http-proxy-username USERNAME `
--set-http-proxy-pwd PASSWORD `
--set-http-proxy-domain NTLM_DOMAIN

  2. Starten Sie den Agenten neu.

  1. Wählen Sie Start > Jitterbit Agent > Jitterbit konfigurieren. Das Jitterbit Agent Konfigurationstool öffnet sich.

  2. Geben Sie die Informationen Ihres Proxy-Servers ein, wählen Sie die gewünschten Optionen aus und klicken Sie dann auf die Schaltfläche OK:

    Jitterbit konfigurieren

  3. Agent neu starten.

  1. Führen Sie den jitterbit-utils Befehl aus:

    jitterbit-utils --set-http-proxy-host HOSTNAME[:PORT] \
--set-http-proxy-username USERNAME \
--set-http-proxy-pwd PASSWORD \
--set-http-proxy-domain NTLM_DOMAIN

  2. Agent neu starten.

Kommunikation über einen Proxy mit einem privaten API-Gateway

Wenn Sie ein privates API-Gateway mit einer Agenten-Proxy-Konfiguration verwenden, müssen Sie die IP-Adresse des Gateway-Hosts im Feld Ausnahmen oder mit der Befehlszeilenoption --set-http-proxy-exceptions des jitterbit-utils Befehls angeben.

Proxy deaktivieren

Um zu verhindern, dass ein privater Agent den konfigurierten Proxy-Server verwendet, befolgen Sie diese Schritte:

  1. Führen Sie diesen Befehl aus:

    JitterbitUtils.exe --disable-http-proxy

  2. Starten Sie den Agenten neu.

Hinweis

Dies deaktiviert keinen NTLM-Proxy. Verwenden Sie dazu das Konfigurationstool.

  1. Wählen Sie Start > Jitterbit Agent > Jitterbit konfigurieren.

  2. Wenn das Jitterbit Agent Konfigurationstool geöffnet wird, klicken Sie auf die Schaltfläche Löschen und dann auf die Schaltfläche OK.

  3. Agent neu starten.

  1. Führen Sie diesen Befehl aus:

    jitterbit-utils --disable-http-proxy

  2. Agent neu starten.