Rediriger les Robots vers un serveur proxy

Whenever your infrastructure uses a proxy for machines/users to connect to the internet, you will also need to configure the Robot to use it.

There are two possible configurations based on the Robot installation mode:

1. Attended Robot - user-mode installation
2. Unattended Robot - service-mode installation

Configuring the proxy for Attended robots (user-mode)

Attended robots inherit the proxy settings configured for your web browser.

If your proxy needs basic authentication, Assistant will prompt you to input your credentials when you first try to connect the Robot to Orchestrator.

You can setup the proxy by using the old way described at Configuring using the web browser or using the Windows proxy settings

Configuring the proxy for Unattended robots (service-mode)

To correctly configure the Service Mode robots to use the proxy, you need to modify both the proxy.json file and the corresponding Windows Settings of the user account(s) that will run automations.

For configuring the proxy in proxy.json follow the Configuring the proxy settings

For configuring the proxy for the user account(s) that will run automations, follow the Configuring the proxy for Attended Robots

Configuring the proxy using the proxy.json file

Starting with 2025.10, to configure the proxy for the Unattended Robot (service-mode), you need to modify the proxy.json file. If you are updating from an older version and you already have a proxy setup in place, it is automatically migrated to the new file.

1. Navigate to: %ProgramData%\UiPath\Shared.
2. Search proxy.jsonfile and open it using a text editor with administrator privileges, such as Notepad++.
   The proxy.json file supports multiple configurations, but not all at the same time. If both ScriptAddress and ProxyAddress are present, ScriptAddress takes precedence.

   {
     "ScriptAddress": "http://localhost/proxy.pac",
     "ProxyAddress": "http://1.1.1.1:1234/",
     "BypassLocalAddresses": true,
     "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
     "UserName": "myUser",
     "Password": "myPassword",
     "Domain": "myDomain"
   }

   1. To use a proxy script, provide the following json:

      {
      "ScriptAddress" : "http://proxy.address/proxy.pac"
      }

   2. To provide a proxy address, provide the following json:

      {
        "ProxyAddress": "http://proxy.address:1234/",
        "BypassLocalAddresses": true,
        "BypassList": "server\.domain\.local$;www.google.com;192\.168\.\d{1,3}\.\d{1,3}",
        "UserName": "myUser", #used for basic auth
        "Password": "myPassword", #used for basic auth
        "Domain": "myDomain"
      }

3. Enregistrez le fichier proxy.json.
4. Redémarrez le service de robot UiPath ou l'appareil.

Configuring the proxy using the web browser

1. Ouvrez la fenêtre Propriétés Internet.
2. Dans l’onglet Connexions, sélectionnez Paramètres LAN. La fenêtre Paramètres du réseau local (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 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 proxy using Windows settings

1. Ouvrez la fenêtre de paramètres du proxy.
2. Pour utiliser un script proxy, sous Configuration proxy automatique, activez Utiliser le script de configuration. Indiquez l’adresse du script.
3. Pour configurer manuellement le serveur proxy, sous Configuration manuelle du proxy, activez l’option Utiliser un serveur proxy. 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
   • Correction - https://proxyaddress, http://proxyaddress; https://proxyaddress
4. Pour enregistrer vos paramètres, sélectionnez Enregistrer.

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

To add the proxy settings while installing Unattended robots (service-mode), use the dedicated command line parameters in your installation command.

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. Établissez une connexion entre le Robot et 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.