Rediriger les Robots vers un serveur proxy

Pour qu'un Robot puisse établir une communication directe avec Orchestrator, il doit se trouver sur le même réseau ou utiliser un réseau ouvert. Sinon, vous devez configurer un serveur proxy pour faciliter la communication.

Configurez un proxy en utilisant un script proxy ou en fournissant l’adresse du serveur proxy avec une liste d’adresses à contourner. Une seule méthode peut être utilisée. Si les deux sont configurés, le script proxy a priorité.

Les options de configuration suivantes sont disponibles :

• Configuration du navigateur web

• Configuration des paramètres proxy de Windows

• Configuration du paramètre proxy via les paramètres de ligne de commande

• Modification du fichier uipath.config

Attention : lors de la mise à jour des versions antérieures à v2021.4, les configurations proxy sont migrées du fichier proxy.config vers le fichier uipath.config afin de correspondre au nouveau format.

Proxy pour les robots en mode d'utilisation

Les robots en mode utilisateur héritent des paramètres de proxy configurés pour votre navigateur Web.

Pour les paramètres de proxy qui nécessitent une authentification de base non Windows, stockez les informations d’identification nécessaires dans le gestionnaire des informations d’identification de la machine.

Important :

Pour appliquer les paramètres du proxy aux robots en mode utilisateur, vous devez redémarrer le service hôte utilisateur. Vous pouvez le faire en vous déconnectant de la session utilisateur Windows, puis en vous reconnectant.

Proxy pour les robots en mode service

Pour utiliser correctement les paramètres de proxy des robots en mode service avec les fonctionnalités de connexion interactive et de flux en direct, vous devez modifier à la fois le fichier uipath.config et les paramètres Windows correspondants du compte utilisateur exécutant le Robot.

The auto-update process for proxy configurations

Vous pouvez configurer le processus de mise à jour automatique pour les Robots fonctionnant derrière un proxy, en fonction du type d'installation du Robot :

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.

Authentification du proxy des informations d'identification Windows

Le serveur proxy peut nécessiter des informations d’identification pour autoriser le trafic. Vous pouvez configurer le proxy pour qu'il s'authentifie à l'aide des informations d'identification de l'utilisateur Windows connecté.

Pour activer cette fonctionnalité, ajoutez la variable d'environnement système UIPATH_PROXY_USE_DEFAULT_CREDENTIALS à la machine exécutant le Robot et définissez sa valeur sur true. Cela indique au Robot d'utiliser les informations d'identification Windows de l'utilisateur actuel pour l'authentification du proxy.

Authentification de base

À partir de la version 2021.10, le service de robot UiPath prend en charge les serveurs proxy utilisant les protocoles d'authentification de base.

Robots en mode utilisateur : Avec l'authentification de base, l'Assistant identifie si une configuration de proxy est implémentée sur la machine et invite l'utilisateur à saisir ses informations d'identification.

Robots en mode de service (Service Mode robots ) : l'exécuteur Robot ne prend pas en charge les méthodes d'authentification de base pour les configurations de proxy. Bien que vous puissiez utiliser l'authentification de base pour vous connecter à Orchestrator et télécharger des packages, vous ne pouvez pas l'utiliser dans l'exécution réelle du workflow. Pour activer l'authentification de base pour les robots en mode service, mettez à jour le fichier UiPath.config avec les paramètres de proxy suivants :

<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

Avertissement :

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.

Configuration du navigateur web

1. Ouvrez la fenêtre Propriétés Internet .
2. Dans l'onglet Connexions (Connections), sélectionnez Paramètres LAN ( LAN settings). La fenêtre Paramètres du réseau local (Local Area Network, LAN) s’ouvre. Selon votre configuration, vous pouvez définir un script de configuration proxy ou un serveur proxy.
   
   1. Pour utiliser un script proxy, sélectionnez Utiliser le script de configuration automatique ( Use automatic configuration script) et fournissez l'adresse au script.
   2. Pour configurer manuellement le serveur proxy, sélectionnez Utiliser un serveur proxy pour votre réseau local, puis indiquez l’adresse du serveur proxy et le port.
3. Pour enregistrer vos paramètres, sélectionnez OK.
4. Dans votre navigateur Web, testez la connexion en accédant à l'URL Orchestrator.

Configuration des paramètres proxy de Windows

1. Ouvrez la fenêtre Paramètres du proxy ( Proxy settings).
2. Pour utiliser un script proxy, sous Configuration automatique du proxy ( Automatic proxy setup), activez Utiliser le script de configuration ( Use setup script). Indiquez l'adresse du script.
3. Pour configurer manuellement le serveur proxy, sous Configuration manuelle du proxy ( Manual proxy setup), activez l'option Utiliser un serveur proxy (Use a proxy server). Indiquez l'adresse du serveur proxy et le port.
   Important :

   L'ajout du préfixe http:// à l'adresse du serveur proxy empêche le Robot de passer des appels HTTPS. Pour vous assurer que le proxy fonctionne comme prévu, supprimez entièrement le préfixe http:// ou ajoutez l'adresse proxy avec les deux préfixes http:// et https:// .

   Par exemple :

   • Incorrect - http=proxyaddress
   • Corriger - http=proxyaddress;https=proxyaddress
   • Corriger - http://proxyaddress;https://proxyaddress
4. Pour enregistrer vos paramètres, sélectionnez Enregistrer ( Save).

Modification du fichier uipath.config

1. Accédez au dossier d'installation : %ProgramFiles%\UiPath\Studio.
2. Cherchez le fichier uipath.config et ouvrez-le à l'aide d'un éditeur de texte, comme par exemple Notepad++.
3. Ajoutez la balise <webProxySettings> et définissez les valeurs en fonction de votre environnement proxy.
   1. Pour utiliser un script de proxy, fournissez la paire clé-valeur suivante :

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

   2. Pour fournir une adresse proxy, fournissez les paires clé-valeur suivantes :

      <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. Enregistrez le fichier uipath.config.
5. Redémarrez le service de robot UiPath.

Configuration des paramètres de proxy lors de l'installation du Robot

Pour ajouter les paramètres de proxy lors de l'installation des robots en mode service, utilisez les paramètres de ligne de commande dédiés dans votre commande d'installation.

Par exemple, la commande suivante installe le Robot en mode service et utilise un script pour configurer le proxy :

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

La commande suivante installe le Robot en mode service et configure l'authentification de base pour les paramètres de proxy :

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

Vérification de la connexion au serveur proxy

1. Connecter le Robot à Orchestrator
2. Déployez des paquets sur un environnement contenant le Robot précédemment configuré.
3. Accéder au dossier %userprofile%\.nuget\ pour vérifier que les processus et paquets d'activités correspondants ont bien été téléchargés.
4. Exécutez la tâche correspondante pour vérifier son bon fonctionnement.