Weiterleitung von Robotern über einen Proxy-Server

Damit ein Roboter eine direkte Kommunikation mit Orchestrator herstellen kann, muss er sich im selben Netzwerk befinden oder ein offenes verwenden. Andernfalls müssen Sie einen Proxyserver einrichten, um die Kommunikation zu erleichtern.

Richten Sie einen Proxy ein, indem Sie entweder ein Proxy-Skript verwenden oder die Proxyserveradresse mit einer Liste von zu umgehenden Adressen angeben. Es kann nur eine Methode verwendet werden. Wenn beides konfiguriert ist, hat das Proxy-Skript Vorrang.

Die folgenden Konfigurationsoptionen sind verfügbar:

• Konfigurieren des Webbrowsers

• Konfigurieren der Windows-Proxyeinstellungen

• Konfigurieren der Proxyeinstellung über Befehlszeilenparameter

• Bearbeiten der Datei uipath.config

Wichtig: Beim Aktualisieren von Versionen vor v2021.4 werden Proxy-Konfigurationen von der proxy.config ‑Datei in die uipath.config migriert, um dem neuen Format zu entsprechen.

Proxy für Roboter im Verwendungsmodus

Roboter im Benutzermodus übernehmen die Proxyeinstellungen, die für Ihren Webbrowser konfiguriert sind.

Speichern Sie bei Proxyeinstellungen, die eine einfache Nicht-Windows-Authentifizierung erfordern, die erforderlichen Anmeldeinformationen in der Anmeldeinformationsverwaltung der Maschine.

Wichtig:

Um Proxyeinstellungen auf Benutzermodusroboter anzuwenden, müssen Sie den Benutzerhostdienst neu starten. Dazu müssen Sie sich von der Windows-Benutzersitzung abmelden und dann wieder anmelden.

Proxy für Dienstmodusroboter

Um die Proxy-Einstellungen für Dienstmodusroboter mit den Funktionen Interaktive Anmeldung und Livestreaming korrekt zu verwenden, müssen Sie sowohl die uipath.config -Datei als auch die entsprechenden Windows-Einstellungen des Benutzerkontos ändern, auf dem der Roboter ausgeführt wird.

The auto-update process for proxy configurations

Sie können den Prozess der automatischen Aktualisierung für Roboter konfigurieren, die hinter einem Proxy arbeiten, abhängig vom Typ der Roboter-Installation:

For unattended installations, the Update Agent is absent. Configurations for proxy are manually handled by modifying the UiPath.config file. Both the Robot Service and the Update Service run using a Windows Service, independent of a user.

For attended installations, configurations for proxy are also manually handled by modifying the UiPath.config file. However, the user starts both the Robot Service and the Update Agent. The Update Service runs using a Windows Service.

For quick installations, configurations for the proxy are inherited from the existing user settings. The user initiates all services: Robot Service, Update Agent, and Update Service.

Proxyauthentifizierung über Windows-Anmeldeinformationen

Der Proxyserver benötigt möglicherweise Anmeldeinformationen, um den Datenverkehr zuzulassen. Sie können den Proxy so konfigurieren, dass er sich mit den Anmeldeinformationen des angemeldeten Windows-Benutzers authentifiziert.

Um diese Funktion zu aktivieren, fügen Sie die Systemumgebungsvariable UIPATH_PROXY_USE_DEFAULT_CREDENTIALS auf der Maschine hinzu, auf der der Roboter ausgeführt wird, und legen Sie ihren Wert auf true fest. Dadurch wird dem Roboter mitgeteilt, die Windows-Anmeldeinformationen des aktuellen Benutzers für die Proxy-Authentifizierung zu verwenden.

Einfache Authentifizierung

Ab Version 2021.10 unterstützt der Roboterdienst Proxyserver mit Standardauthentifizierungsprotokollen.

Benutzermodusroboter – Mit der einfachen Authentifizierung identifiziert der Assistant, ob eine Proxykonfiguration auf der Maschine implementiert ist, und fordert den Benutzer zur Eingabe seiner Anmeldeinformationen auf.

Dienstmodusroboter – Der Roboter-Executor unterstützt keine einfachen Authentifizierungsmethoden für Proxykonfigurationen. Sie können die Standardauthentifizierung für die Verbindung mit dem Orchestrator und das Herunterladen von Paketen verwenden, aber Sie können sie nicht innerhalb der eigentlichen Workflowausführung verwenden. Um die Standardauthentifizierung für Dienstmodusroboter zu aktivieren, aktualisieren Sie die UiPath.config -Datei mit den folgenden Proxyparametern:

<webProxySettings>
<add key="ProxyAddress" value="http://my.proxy.net:8008" />
<add key="UserName" value="myUser" />
<add key="Password" value="myPassword" />
<add key="Domain" value="myDomain" />
</webProxySettings>

Live streaming and remote control in a proxy setup

Warnung:

Live streaming and remote control features do not work in a proxy setup for Robot versions older than 2024.10.5. Upgrade your Robot to versions 2024.10.5+ to access these features in a proxy setup.

Konfigurieren des Webbrowsers

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 der Windows-Proxyeinstellungen

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
   • Richtig – http=proxyaddress;https=proxyaddress
   • Richtig – http://proxyaddress;https://proxyaddress
4. Um Ihre Einstellungen zu speichern, wählen Sie Speichern aus.

Bearbeiten der Datei uipath.config

1. Navigieren Sie zum Installationsordner %ProgramFiles%\UiPath\Studio.
2. Suchen Sie nach der Datei uipath.config und öffnen Sie diese mtihilfe eines Texteditors, beispielsweise Notepad++.
3. Fügen Sie das <webProxySettings>‑Tag hinzu und legen Sie die Werte basierend auf Ihrer Proxy-Umgebung fest.
   1. Um ein Proxyskript zu verwenden, geben Sie das folgende Schlüssel-Wert-Paar an:

      <webProxySettings>
          <add key="ScriptAddress" value="http://localhost/proxy.pac" />
      </webProxySettings>

   2. Um eine Proxyadresse anzugeben, geben Sie die folgenden Schlüssel-Wert-Paare an:

      <webProxySettings>
          <add key="ProxyAddress" value="http://1.1.1.1:1234/" />
          <add key="BypassLocalAddresses" value="True" />
          <add key="BypassList" value="server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}" />
      </webProxySettings>

4. Speichern Sie die Datei uipath.config.
5. Starten Sie den UiPath-Roboterdienst erneut.

Konfigurieren der Proxyeinstellungen während der Roboterinstallation

Um die Proxyeinstellungen während der Installation von Dienstmodusrobotern hinzuzufügen, verwenden Sie die speziellen 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"

Überprüfen der Proxyserververbindung

1. Verbinden Sie den Roboter 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.