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 :

• Configuring the web browser

• Configuring the Windows proxy settings

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

• Editing the uipath.config file

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.

Le processus de mise à jour automatique pour les configurations de proxy

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 :

Pour les installations Unattended, l'agent de mise à jour est absent. Les configurations du proxy sont gérées manuellement en modifiant le fichier UiPath.config . Le service de Robot et le service de mise à jour s'exécutent à l'aide d'un service Windows, indépendamment d'un utilisateur.

Pour les installations Attended, les configurations du proxy sont également gérées manuellement en modifiant le fichier UiPath.config . Cependant, l'utilisateur démarre à la fois le service de robot UiPath et l'agent de mise à jour. Le service de mise à jour s'exécute à l'aide d'un service Windows.

Pour les installations rapides, les configurations du proxy sont héritées des paramètres utilisateur existants. L'utilisateur lance tous les services : Service de robot (Robot Service), Agent de mise à jour (Update Agent) et Service de mise à jour (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>

Flux en direct et contrôle à distance dans une configuration proxy

Avertissement :

Les fonctionnalités de flux en direct et de contrôle à distance ne fonctionnent pas dans une configuration proxy pour les versions de Robot antérieures à 2024.10.5. Mettez à niveau votre Robot vers les versions 2024.10.5 et ultérieures pour accéder à ces fonctionnalités dans une configuration proxy.

Configuring the web browser

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.

Configuring the Windows proxy settings

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

Editing the uipath.config file

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

Checking the proxy server connection

1. Connect the Robot to 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.