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 das des Orchestrators, ist die Kommunikation zwischen den beiden UiPath-Produkten nicht möglich. Um diese Kommunikation zu ermöglichen, können Sie einen Proxy-Server mit Ihrem Roboter verwenden.

Um den Roboter über einen Proxy-Server weiterzuleiten, müssen Sie einige Konfigurationsschritte auf der Roboter-Maschine vornehmen. Im Einzelnen:

• Konfigurieren Sie Ihren bevorzugten Webbrowser, um sicherzustellen, dass der Roboter-Computer über den angegebenen Proxy-Server auf den Orchestrator zugreifen kann.

• Bearbeiten Sie die Datei uipath.config, um sicherzustellen, dass die Verbindung zwischen dem Roboter und dem Orchestrator über den angegebenen Proxy-Server geführt wird, und dass die Aktivitäten und die 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.

  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:

  The settings in the uipath.config file only apply to the robot service process when installed in service-mode. Proxy settings for user-level Windows processes, including the executor (for both user-mode and service-mode installations), are not configurable through uipath.config.

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. In Internet Explorer, click Tools > Internet Options. The Internet Options window is displayed.

   

2. In the Connections tab, click LAN Settings. The Local Area Network (LAN) Settings window is displayed. Depending on your setup, you can configure a proxy configuration script or a proxy server.

   

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.

   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>
      

      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.

4. Speichern Sie die uipath.config‑Datei und starten Sie den UiPath-Roboterdienst neu, damit die Änderungen wirksam werden.

Beispiele für Umgehungsliste

Nachfolgend finden Sie einige Beispiele für das Format der Umgehungsliste.

www.myget.org -> ((www|WWW).){1}?(myget+(.org))
.vo.msecnd.net -> (([a-zA-Z0-9]).)+((vo+)+(.msecnd+)+(.net))
www.nuget.org -> ((www|WWW).){1}?(nuget+(.org))
gallery.uipath.com -> (([a-zA-Z0-9]).)*((gallery+)+(.uipath+)+(.com))

Um die Formatierung für komplexe Konfigurationen zu testen, können Sie einen Regex-Validator/Generator verwenden.

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.

Wichtig:

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.

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.

Beispiel: UIPATH_PROXY_USE_DEFAULT_CREDENTIALS mit Wert true

Konfigurieren der Windows Credentials Proxy-Authentifizierung mit PowerShell

1. Öffnen Sie PowerShell als Administrator.

2. Führen Sie den folgenden Befehl aus:

   [Environment]::SetEnvironmentVariable("UIPATH_PROXY_USE_DEFAULT_CREDENTIALS", "true", "Machine")
   

3. Starten Sie die Robotermaschine neu.

Validieren des Skripts

Um zu bestätigen, dass die Systemumgebungsvariable erfolgreich festgelegt wurde, führen Sie das folgende Skript in PowerShell aus.

$Env:UIPATH_PROXY_USE_DEFAULT_CREDENTIALS

Dies gibt den Wert der Systemumgebungsvariablen zurück. Wenn der Wert true ist, ist die Konfiguration jetzt vorhanden.

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.

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.