Weiterleitung von Robotern über einen Proxy-Server

Immer wenn Ihre Infrastruktur einen Proxy verwendet, damit Maschinen oder Benutzer eine Verbindung mit dem Internet herstellen können, müssen Sie auch den Roboter dafür konfigurieren.

Es gibt zwei mögliche Konfigurationen, abhängig vom Installationsmodus des Robot:

1. Attended Robot – Installation im Benutzermodus
2. Unattended Robot – Installation im Servicemodus

Konfigurieren des Proxys für Attended Robots (Benutzermodus)

Attended Robots übernehmen die Proxy-Einstellungen, die für Ihren Webbrowser konfiguriert sind.

Wenn Ihr Proxy eine Basisauthentifizierung erfordert, fordert Assistant Sie beim ersten Verbindungsversuch des Roboters mit Orchestrator auf, Ihre Anmeldeinformationen einzugeben.

Sie können den Proxy auf die herkömmliche Weise einrichten, wie unter Konfigurieren über den Webbrowserbeschrieben, oder über die Windows-Proxyeinstellungen.

Konfigurieren des Proxys für Unattended Robots (Servicemodus)

Um die Roboter im Servicemodus für die Verwendung des Proxys korrekt zu konfigurieren, müssen Sie sowohl die proxy.json Datei als auch die entsprechenden Windows-Einstellungen der Benutzerkonten ändern, die Automatisierungen ausführen.

Zur Konfiguration der Proxyeinstellungen in proxy.json folgen Sie der Anleitung unter Konfigurieren der Proxyeinstellungen

Zur Konfiguration der Proxeinstellungen für die Benutzerkonten, die Automatisierungen ausführen, folgen Sie der Anleitung Konfigurieren des Proxys für Attended Robots

Konfigurieren des Proxys über den Webbrowser

1. Öffnen Sie das Fenster Internet-Eigenschaften.
2. Wählen Sie auf der Registerkarte Verbindungen die Option LAN-Einstellungen aus. Das Fenster Einstellungen für lokales Netzwerk (LAN) wird geöffnet. Je nach Einrichtung können Sie ein Proxykonfigurationsskript oder einen Proxyserver festlegen.
   
   1. Um ein Proxyskript zu verwenden, wählen Sie Automatisches Konfigurationsskript verwenden aus und geben Sie die Adresse für das Skript an.
   2. Um den Proxyserver manuell einzurichten, wählen Sie Proxyserver verwenden für Ihr LAN aus und geben Sie dann die Adresse des Proxyservers und den Port an.
3. Um Ihre Einstellungen zu speichern, wählen Sie OK aus.
4. Testen Sie die Verbindung in Ihrem Webbrowser, indem Sie auf die Orchestrator-URL zugreifen.

Konfigurieren des Proxys über die Windows-Einstellungen

1. Öffnen Sie das Fenster Proxyeinstellungen.
2. Um ein Proxyskript zu verwenden, schalten Sie unter Automatisches Proxy-Setup die Option Setup-Skript verwenden ein. Geben Sie die Adresse für das Skript an.
3. Um den Proxyserver manuell einzurichten, aktivieren Sie unter Manuelle Proxyeinrichtung die Option Proxyserver verwenden. Geben Sie die Adresse des Proxyservers und den Port an.
   Wichtig:

   Das Hinzufügen des Präfixes http:// zur Proxyserveradresse verhindert, dass Robot HTTPS-Aufrufe tätigt. Um sicherzustellen, dass der Proxy wie erwartet funktioniert, entfernen Sie das Präfix http:// vollständig oder fügen Sie die Proxyadresse mit den beiden Präfixen http:// und https:// hinzu.

   Zum Beispiel:

   • Falsch –http://proxyaddress
   • Korrekt – https://proxyaddresshttp://proxyaddress; https://proxyaddress
4. Um Ihre Einstellungen zu speichern, wählen Sie Speichern aus.

Konfigurieren des Proxys über die proxy.json Datei

Ab Version 2025.10 müssen Sie zur Konfiguration des Proxys für den Unattended Robot (Servicemodus) die proxy.json Datei ändern. Wenn Sie von einer älteren Version aktualisieren und bereits eine Proxykonfiguration eingerichtet haben, wird diese automatisch in die neue Datei migriert.

1. Navigieren Sie zu: %ProgramData%\UiPath\Shared.
2. Suchen Sie die proxy.jsonDatei und öffnen Sie sie mit einem Texteditor mit Administratorberechtigungen, z. B. Notepad++.
   Die proxy.json Datei unterstützt mehrere Konfigurationen, aber nicht alle gleichzeitig. Wenn sowohl ScriptAddress als auch ProxyAddress vorhanden sind, hat ScriptAddress Vorrang.

   {
     "ScriptAddress": "http://localhost/proxy.pac",
     "ProxyAddress": "http://1.1.1.1:1234/",
     "BypassLocalAddresses": true,
     "BypassList": "server\\.domain\\.local$;www.google.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
     "UserName": "myUser",
     "Password": "myPassword",
     "Domain": "myDomain"
   }

   Note: The bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass. When you want to escape a character in a regex, you will need to use \\ (eg: . is escaped as \\.).
   1. Um ein Proxyskript zu verwenden, geben Sie das folgende JSON an:

      {
      "ScriptAddress" : "http://proxy.address/proxy.pac"
      }

   2. Um eine Proxyadresse bereitzustellen, geben Sie das folgende JSON an:

      {
        "ProxyAddress": "http://proxy.address:1234/",
        "BypassLocalAddresses": true,
        "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
        "UserName": "myUser", #used for basic auth
        "Password": "myPassword", #used for basic auth
        "Domain": "myDomain"
      }

3. Speichern Sie die Datei proxy.json.
4. Starten Sie den Roboterdienst oder das Gerät neu.

Konfigurieren der Proxyeinstellungen während der Roboterinstallation

Um die Proxyeinstellungen während der Installation von Unattended Robots (Servicemodus) hinzuzufügen, verwenden Sie die entsprechenden Befehlszeilenparameter in Ihrem Installationsbefehl.

Beispielsweise installiert der folgende Befehl den Roboter im Dienstmodus und verwendet ein Skript zum Konfigurieren des Proxys:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_SCRIPT_ADDRESS=http://localhost/proxy.pac

Der folgende Befehl installiert den Roboter im Dienstmodus und richtet die Standardauthentifizierung für Proxyeinstellungen ein:

UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService PROXY_ADDRESS=http://my.proxy.net:8008 PROXY_USERNAME="myUser" PROXY_PASSWORD="myUser" PROXY_DOMAIN="myUser"

Prüfen der Proxy-Server-Verbindung

1. Verbinden des Roboters mit dem Orchestrator
2. Stellen Sie einige Pakete in einer Umgebung bereit, die den zuvor konfigurierten Roboter enthält.
3. Navigieren Sie zum Ordner %userprofile%\.nuget\ und prüfen Sie, ob der entsprechende Prozess und die Aktivitätspakete heruntergeladen wurden.
4. Führen Sie den entsprechenden Job aus, um zu prüfen, ob er erfolgreich ausgeführt wird.