Weiterleitung von Robotern über einen Proxy-Server

Wenn Sie einen Roboter haben, der sich in einem geschlossenen Netzwerk befindet oder in einem anderen Netzwerk als dasjenige, das der Orchestrator verwendet, ist eine Kommunikation zwischen den beiden UiPath-Produkten nicht möglich. Um diese Kommunikation zu ermöglichen, können Sie daher einen Proxy-Server mit Ihrem Roboter verwenden.

Um den Roboter über einen Proxy-Server weiterzuleiten, müssen Sie mehrere Konfigurationsschritte auf dem Roboter-Computer vornehmen:

1. Konfigurieren Sie Ihren bevorzugten Webbrowser, um sicherzustellen, dass der Roboter-Computer über den angegebenen Proxy-Server auf den Orchestrator zugreifen kann.
2. Bearbeiten Sie die Datei UiPath.config, um sicherzustellen, dass die Verbindung zwischen dem Roboter und dem Orchestrator über den angegebenen Proxy-Server geleitet wird und dass die Aktivitätspakete und Automatisierungsprozesse über den angegebenen Proxy-Server heruntergeladen werden können.

Hinweis:

• The user mode robot inherits the Proxy Settings from the Internet Options, while the service mode robot requires specific configuration to be made in the uipath.config file from the Studio installation folder .

• When the robot is installed in service mode and you need to use the Interactive Sign In feature from the UiPath Assistant, you must configure the proxy settings in both the uipath.config file and Windows Settings for the user under which the robot runs.

• 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.

Wichtig:

Wenn der Roboter im Benutzermodus installiert ist und Proxy-Konfigurationen verwendet werden sollen, die eine einfache (nicht Windows-) Authentifizierung für die Prozessausführung erfordern, müssen die Anmeldeinformationen zur Anmeldeinformationsverwaltung der Maschine hinzugefügt werden, da die Einstellungen in der uipath.config-Datei nur für den Roboter im Dienstmodus gelten.

Konfigurieren der Proxyeinstellungen

Konfigurationen für das Proxy-Skript oder die Proxy-Adresse können entweder über den Abschnitt „Verbindungen“ in den Internetoptionen oder über das Menü „Proxy-Einstellungen“ in den Windows-Einstellungen festgelegt werden.

Konfigurieren des Webbrowsers

1. Im Internet Explorer klicken Sie Tools > Internetoptionen an. Das Fenster Internetoptionen wird angezeigt.

   

2. Klicken Sie auf der Registerkarte Verbindungen auf LAN-Einstellungen. Das Fenster Einstellungen des lokalen Netzwerks (LAN) wird angezeigt. Je nach Setup können Sie ein Proxy-Konfigurationsskript oder einen Proxy-Server festlegen.

   

3. Konfigurieren Sie den Proxy-Server oder die automatische Konfiguration (für das Proxy-Skript).

4. Klicken Sie OK (OK) an. Ihre Einstellungen werden gespeichert.

5. Geben Sie im Webbrowser die Orchestrator-URL ein, um die Verbindung zu testen.

Konfigurieren der Windows-Proxyeinstellungen

1. Öffnen Sie das Startmenü und suchen Sie nach Proxy-Einstellungen.

2. Konfigurieren Sie das automatische Proxy-Setup (für das Proxy-Skript) oder das manuelle Proxy-Setup (für den Proxy-Server).

3. Speichern Sie die Einstellungen.

4. Geben Sie im Webbrowser die Orchestrator-URL ein, um die Verbindung zu testen.

   

   Wichtig:

   When setting up or editing the proxy address, do not add the http:// prefix to the proxy address. This enables the proxy only for HTTP calls, and since most calls are HTTPS, the proxy configuration fails.

   To resolve this, make sure to either remove the http:// prefix altogether, or specifically add the proxy address with both http:// and https:// prefixes.

   Beispiel:

   • http://proxyaddress -> incorrect
   • https://proxyaddress -> correct
   • http://proxyaddress;https://proxyaddress -> correct

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.

   Hinweis:

   Starting with v2021.4 Robot, the bypass list should contain an array of regular expression strings that contain the URIs of the servers to bypass.

   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 uipath.config‑Datei und starten Sie den UiPath-Roboterdienst neu, damit die Änderungen wirksam werden.

Proxyauthentifizierung über Windows-Anmeldeinformationen

Ab v2021.4.4 funktioniert der Roboter mit Proxykonfigurationen, die die Authentifizierung über Windows-Anmeldeinformationen verwenden. Um diese Funktion zu aktivieren, fügen Sie die Systemumgebungsvariable UIPATH_PROXY_USE_DEFAULT_CREDENTIALS auf der Maschine hinzu und setzen sie den Wert auf true.

Hinweis:

Es sollte entweder die ScriptAddress oder die ProxyAddress festgelegt werden. Wenn beide festgelegt sind, hat die ScriptAddress Vorrang.

Die BypassList und die BypassLocalAddresses sollten nur dann festgelegt werden, wenn die ProxyAddress festgelegt ist.

Einfache Authentifizierung

Ab Version 2021.10 unterstützt der Roboter Proxy-Server mit Standard-Authentifizierungsprotokollen.

Dienstmodusroboter

Um diese Funktion zu aktivieren, wenn der Roboter im Dienstmodus installiert ist, müssen Sie den Abschnitt webProxySettings aus der Datei uipath.config bearbeiten und die folgenden Informationen hinzufügen:

<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>

Wichtig:

The Robot Executor does not support proxy configurations using Basic Authentication methods. This means you can use Basic Authentication to connect to Orchestrator and download packages, but not for the actual workflow.

Benutzermodusroboter

Wenn der Roboter im Benutzermodus installiert wird, erkennt UiPath Assistant automatisch, dass eine Proxykonfiguration mit Standardauthentifizierung auf der Maschine vorhanden ist, und fordert den Benutzer zur Eingabe eines Benutzernamens und eines Kennworts auf.

Prüfen der Proxy-Server-Verbindung

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.

   Hinweis:

   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.