Rediriger les Robots vers un serveur proxy

Chaque fois que votre infrastructure utilise un proxy pour permettre aux machines/utilisateurs de se connecter à Internet, vous devrez également configurer le robot pour qu'il l'utilise.

Deux configurations possibles sont basées sur le mode d'installation du robot :

1. Attended Robot – Installation en mode utilisateur
2. Unattended Robot – Installation en mode service

Configurer le proxy pour les robots assistés (mode utilisateur)

Les robots assistés héritent des paramètres du proxy configurés pour votre navigateur Web.

Si votre proxy nécessite une authentification de base, Assistant vous demandera d'entrer vos identifiants lorsque vous tenterez pour la première fois de connecter le robot à Orchestrator.

Vous pouvez configurer le proxy à l'aide de l'ancienne méthode décrite dans Configuration à l'aide du navigateur Web ou à l'aide des paramètres du proxy Windows

Configurer le proxy pour les robots non assistés (mode service)

Pour configurer correctement les robots en mode Service afin qu'ils utilisent le proxy, vous devez modifier à la fois le proxy.json fichier et les paramètres Windows correspondants du ou des comptes utilisateurs qui exécuteront les automatisations.

Pour configurer le proxy dans proxy.json, suivez la section Configurer les paramètres du proxy

Pour configurer le proxy pour le ou les comptes d'utilisateur qui exécuteront les automatisations, suivez la section Configurer le proxy pour les robots assistés

Configurer le proxy à l'aide du navigateur Web

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

Configurer le proxy à l'aide des paramètres Windows

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 du proxy à l'aide du fichier proxy.json

À partir de la version 2025.10, pour configurer le proxy pour le Unattended Robot (mode service), vous devez modifier le proxy.json fichier. Si vous effectuez une mise à jour à partir d'une version antérieure et que vous disposez déjà d'une configuration de proxy, celle-ci est automatiquement migrée vers le nouveau fichier.

1. Accédez à : %ProgramData%\UiPath\Shared.

2. Recherchez le fichier proxy.json et ouvrez-le à l'aide d'un éditeur de texte disposant des privilèges d'administrateur, tel que Notepad++.

   Le fichier proxy.json prend en charge plusieurs configurations, mais pas toutes en même temps. Si ScriptAddress et ProxyAddress sont tous les deux présents, ScriptAddress a la priorité.

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

   Remarque :

   La liste de contournement doit contenir un Array de chaînes d'expressions régulières qui contiennent les URI des serveurs à contourner.Lorsque vous souhaitez échapper un caractère dans un regex, vous devez utiliser \\ (par exemple : . est échappé en \\.).

   1. Pour utiliser un script proxy, fournissez le json suivant :

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

   2. Pour fournir une adresse proxy, fournissez le json suivant :

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

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

Pour ajouter les paramètres de proxy lors de l'installation des robots non assistés (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=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=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.