Fichiers de configuration

Configuration files for UiPath Robot, including UiPath.config and proxy.json, system environment variables, and instructions for restarting components after changes.

Redémarrage des composants du Robot

Une fois que vous avez modifié les fichiers de configuration, vous devez redémarrer les composants de robot pertinents pour que les modifications prennent effet. La liste suivante résume comment redémarrer plusieurs composants en fonction du mode d'installation du robot.

N’oubliez pas d’enregistrer votre travail en cours avant de redémarrer pour éviter de perdre votre progression.

• Service de robots
  • Installation en mode service
    1. Ouvrez le Gestionnaire des tâches > Services.
    2. Look for the UiRobotSvc service, named UiPath Robot.
    3. Ouvrez le menu contextuel du service et sélectionnez Redémarrer.
  • Installation en mode utilisateur - Quittez, puis redémarrez Assistant ou:
    1. Ouvrez le Gestionnaire des tâches > Détails.
    2. Sélectionnez le processus UiPath.Service.UserHost.exe.
    3. Sélectionnez Terminer la tâche.
• UiPath RobotJS ServiceHost - Service Mode installations with the JavaScript add-on
  1. Ouvrez le Gestionnaire des tâches > Services.
  2. Recherchez le service UiPath RobotJS Service.
  3. Ouvrez le menu contextuel du service et sélectionnez Redémarrer.
• Assistant UiPath
  1. Dans l’Assistant, sélectionnez Préférences, puis Quitter.
  2. Relancez l’Assistant.
• Widgets - Redémarrez l'Assistant ou :
  1. Ouvrez le menu contextuel de l'icône Assistant dans la barre des tâches.
  2. Sélectionner Recharger les widgets

uipath.config

Le fichier UiPath.config contient les paramètres de configuration essentiels du Robot. En tant qu’administrateur, vous pouvez personnaliser le comportement de vos robots en modifiant la liste des paramètres dans le fichier de configuration.

Remarque :

Chaque environnement peut nécessiter des avis spécifiques. UiPath vous permet ainsi d’appliquer différentes configurations en fonction de l’environnement actuel du robot (Développement, Organisation ou Production. Faites toujours preuve de prudence lorsque vous modifiez ce fichier, car une configuration inexacte peut entraîner des problèmes au niveau de l’application.

Important :

À partir de Robot 2025.10, les paramètres du proxy sont configurés dans proxy.json, et non dans UiPath.config. Pour plus de détails, consultez proxy.json.

Accès au fichier

When you install your Robot, the system creates the UiPath.config file in the Robot installation folder.

To access it, navigate to %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. On update, the UiPath Platform Installer copies your UiPath.config and NuGet.config to the new version folder, so your edits are kept. It then resets Telemetry.Enabled, SkipHttpConfigurationSources and DisableSecureXaml in UiPath.config (and DefaultServiceUrl when SERVICE_URL is set) to the values of its installation parameters, so set those through the installer parameters. It also sets signatureValidationMode in NuGet.config from ENFORCE_SIGNED_EXECUTION and removes the trustedSigners node unless ENFORCE_SIGNED_EXECUTION is true.

Paramètres personnalisables

Le fichier UiPath.config comprend les paramètres suivants :

• Dans la section connectionSettingsconfig

  • DefaultServiceUrl (string) - Définit l'adresse par défaut que le robot utilise pour se connecter à Orchestrator.

    Exemple :

    string DefaultServiceUrl = "https://cloud.uipath.com"
    

  • AutoSignIn (bool) - Active la fonctionnalité de connexion automatique pour Assistant.La valeur par défaut est false.

    Exemple :

    bool AutoSignIn = true.
    

  • EnforceDefaultServiceUrl (bool) - Enforces the address provided as DefaultServiceUrl to all users. Default value is false. Has no effect in Service Mode.

    Exemple :

    bool EnforceDefaultServiceUrl = true.
    

• Dans la section communicationSettingsconfig

  • MaxMessageSizeInMegabytes (byte) - Définit la taille maximale d'un message que le système peut envoyer ou recevoir en Mo.La valeur par défaut est 10.

    Cela permet d’éviter les surcharges ou les plantages de processus dus au traitement de messages trop volumineux.

    Exemple :

    byte MaxMessageSizeInMegabytes = 10;
    

  • InstallPackageTimeout (TimeSpan) - Définit la limite de temps pour les installations de package.La valeur par défaut est 20 minutes.

    Si l’installation d’un package prend plus de temps que défini, le système abandonne l’installation.

    Exemple :

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
    

  • RequestTimeout (TimeSpan) - Définit combien de temps le système attend une réponse de communication.La valeur par défaut est de 40 secondes.

    Si le système ne reçoit pas de réponse dans la période définie, il s'arrête et avance.Cela évite les blocages du système.

    Exemple :

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
    

• Dans la section packageSettingsconfig

  • PackagesInstallationFolder (string) - Sets the default directory where packages are installed. Default value is %UserProfile%\.nuget\packages. In Service Mode, the path is expanded for the user that runs each job.

  • SkipHttpConfigurationSources (bool) - Enables the system to ignore package sources configured with an HTTP or HTTPS URL, such as NuGet feeds. Default value is false.

    Cela signifie que le système ne récupère pas les packages à partir de ces sources, ce qui est utile lorsque les sources ne sont pas fiables ou sécurisées.

  • DisableSecureXaml (bool) - Permet au robot d'exécuter des workflows potentiellement dangereux.La valeur par défaut est false.

  • DirectDownload (bool) - Stops the Robot from writing downloaded packages to the shared NuGet http-cache disk cache. The Robot still reads files that are already in the cache, and downloads the others every time it needs them. Default value is false.

  • NoCache (bool) - Stops the Robot from reading or writing the shared NuGet http-cache. The Robot uses a temporary folder that it discards instead. Unlike DirectDownload, the in-memory download cache still applies, so each package is downloaded once per restore. Default value is false.

  • PackageSaveWithoutNupkg (bool) - Permet d'enregistrer les packages sans le fichier .nupkg.La valeur par défaut est false.

    Cela permet de réduire la taille du téléchargement.

• Dans la section analyticsSettingsconfig
  • Telemetry.Enabled (bool) - Allows UiPath to collect and send usage data for analysis. Default value is true. The UiPath Platform Installer sets it from its own telemetry setting when it installs or updates the Robot.
• Dans la section robotCacheSettingsconfig

  • SessionCacheDuration (TimeSpan) - Définit pendant combien de temps les données d'une session spécifique doivent être conservées dans le cache avant d'être éliminées.La valeur par défaut est 30 secondes.

    Cela est utile pour réutiliser des données telles que les valeurs de variable ou les détails d'opérations au lieu de les recréer ou de les réviser.

    Exemple :

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
    

  • GetResourceUrlCacheDuration (TimeSpan) - Définit pendant combien de temps les URL des ressources, telles que les API ou les pages Web, sont stockées dans le cache. La valeur par défaut est une (1) heure.

    Ceci est utile pour optimiser les performances dans les scénarios où vos robots doivent accéder régulièrement à certaines ressources.

    Exemple :

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
    

• Dans la section robotJsSettingsconfig

  • ListenerPort (int) - Définit le numéro de port sur lequel Robot.js écoute les connexions entrantes. La valeur par défaut est 2323.

    Cela permet au service de robot UiPath d’interagir avec les applications Web exécutées sur des serveurs locaux ou distants.

    Exemple :

    int ListenerPort = 2323;
    

  • TokenExpiryInDays (int) - Sets the validity period, in days, of the token that the robot service issues to a web application after the user gives consent. Default value is 30 days.

    Exemple :

    int TokenExpiryInDays = 30;
    

  • AllowUrlList (string) - Sets the web origins (the browser Origin header) whose RobotJS consent dialog the Robot accepts automatically. Separate entries with semicolons. The default list is https://cloud.uipath.com, https://staging.uipath.com, https://alpha.uipath.com, https://govcloud.uipath.us and https://alpha.gov.uipath-dev.com. Setting this key replaces the default list. To add origins without replacing it, use the UIPATH_ROBOTJS_ALLOWLIST system variable.

    Exemple :

    string AllowUrlList = "https://cloud.uipath.com;https://mydomain.com";
    

Important :

• Back up the original UiPath.config file before you change it, so you can restore the original settings.
• Pour appliquer les mises à jour apportées au fichier UiPath.config, redémarrez le service UiPath ou le système.
• Les paramètres locaux du fichier UiPath.config sont prioritaires sur les paramètres configurés dans Orchestrator.

You can encrypt sensitive data in the UiPath.config file for additional security.

Variables système UiPath Robot

D’autres comportements personnalisés peuvent être configurés via des variables d’environnement système.

Important :

Après avoir modifié l’une des variables système, redémarrez le service de robot.

La liste suivante résume les cas d’utilisation les plus courants :

• UIPATH_SESSION_TIMEOUT - Modifie le délai d'attente par défaut de 60 secondes pour la création d'une session interactive. Ajustez cette valeur pour adapter le comportement du robot en fonction des performances et des temps de chargement du système avec lequel il interagit.

  Exemple :

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - Modifie le délai d'attente par défaut de 180 secondes pour le démarrage d'un processus dans une session de robot.

  Exemple :

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - Sets the language the Robot operates in. The value is a culture code, not the language name. The supported codes are en, fr, de, es, es-MX, pt, pt-BR, ja, ko, ru, tr, ro, zh-CN and zh-TW. The Robot ignores an unsupported value, such as French, and falls back to the next source. The order of precedence is:

  1. UIPATH_LANGUAGE user environment variable
  2. UIPATH_LANGUAGE machine environment variable
  3. UIPATH_LANGUAGE process environment variable
  4. Current thread UI culture, if supported
  5. Langue UiPath par défaut (anglais)

  Exemple :

  UIPATH_LANGUAGE=fr
  

• UIPATH_HEADLESS_WITH_USER - Utilise les identifiants d'un utilisateur spécifique, qui ont été précédemment configurés dans Orchestrator.

  Exemple :

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR - Par défaut, un exécuteur pré-chargé est lancé lorsque le robot démarre.Pour modifier ce comportement et lancer l’exécuteur préchargé uniquement lorsque le premier processus s’exécute, définissez cette variable sur None.

  Exemple :

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR - Désactive la fonctionnalité de l'exécuteur pré-chargé.

  Exemple :

  UIPATH_DISABLE_PRE_LOADED_EXECUTOR=True
  

• UIPATH_ROBOTJS_ALLOWLIST - Accepte automatiquement la boîte de dialogue de consentement du robot lors de l'établissement de la connexion entre le SDK Robot JS et l'exécuteur Robot.

  The value is a list of origins separated by semicolons. Each origin includes the scheme, for example https://myapp.contoso.com. Add the port only if it is not the default (80 or 443). The Robot also accepts the origins in the AllowUrlList key of the robotJsSettings section of UiPath.config.

  Exemple :

  UIPATH_ROBOTJS_ALLOWLIST=https://cloud.uipath.com;https://mydomain.com
  

• UIPATH_DNS_MACHINENAME - Permet d'utiliser le nom d'hôte DNS pour Localhost lors de la création de sessions RDP. Pour exécuter des tâches Unattended dans des environnements avec l’authentification Kerberos pour RDP, définissez cette valeur sur Vrai.

  Exemple :

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES - Configure les chemins vers les dossiers des paquets de secours. Utilisez des points-virgules pour séparer plusieurs chemins.

  En l’absence de cette variable, le robot recherche les dossiers de packages de secours dans le fichier Nuget.config.

• NUGET_SCRATCH - Permet à plusieurs robots en mode utilisateur sur la même machine de partager un chemin local pour le stockage des packages.

  La valeur doit être un chemin d’accès différent vers le dossier d’installation de NuGet, qui fait office de dossier temporaire pour NuGet.

  Remarque :

  Seule la variable NUGET_SCRATCH doit utiliser le dossier temporaire configuré.

  Exemple :

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE - Préserve la casse d'origine des informations d'identification de journalisation (domaine\username).

  Exemple :

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR - Configure le comportement de la restauration de la session après la fin d'une tâche. Les options suivantes sont disponibles :

  • TryReuseAndRestoreSession : l’option par défaut. Tente de réutiliser la session et de la restaurer à son état précédent après la fin d’une tâche. S’il n’y a aucune session initiale à réutiliser au moment de la restauration, la session est déconnectée.
  • ForceNew : crée une session complètement nouvelle, indépendamment de l’état de la session précédente. La session est toujours déconnectée au moment de la restauration.
  • LeaveSessionActive : empêche la restauration de l’état initial de la session.
  • LeaveSessionDisconnected : déconnecte toujours la session au moment de la restauration.

  Exemple :

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

• UIPATH_HTTP_CONNECTION_LIFETIME - Définit pendant combien de temps la connexion à Orchestrator reste ouverte avant qu'elle ne soit fermée et actualisée. La durée par défaut est de 30 minutes, mais pour ajuster cette valeur, utilisez une valeur exprimée en secondes.

  Exemple :

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600
  

• UIPATH_FILE_LOG_LEVEL - Définit le niveau du journal d'exécution utilisé dans le fichier local. Cela est différent du niveau de journal utilisé pour Orchestrator.Les options suivantes sont disponibles :

  • Détaillé (Verbose)
  • Traçage (Trace)
  • Information
  • Avertissement
  • Erreur
  • Critique (Critical)
  • Désactivé (Off)

  Exemple :

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose
  

• UIPATH_EXECUTOR_STARTUP_DELAY - Définit le temps d'attente en secondes entre la création de la session et le démarrage de l'exécuteur. Cela est utilisé lorsque votre infrastructure doit charger certains services (VPN, sécurité) avant que l'exécution de votre automatisation ne commence.

  Exemple :

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5
  

• UIPATH_MEDIUMPLUS_EXECUTOR - Lance l'exécuteur Robot au niveau d'intégrité Medium+ afin que les automatisations puissent interagir avec les fenêtres qui nécessitent des privilèges plus élevés, telles que la boîte de dialogue Windows CredentialBroker pendant la saisie des identifiants RDP. Définissez-le sur 1 pour l'activer. Nécessite Windows avec le contrôle de compte utilisateur (UAC) activé. Pour plus d’informations, consultez Élévation de l’intégrité Medium+.

  Exemple :

  UIPATH_MEDIUMPLUS_EXECUTOR=1
  

• UIPATH_MEDIUMPLUS_INVOKE - Permet aux activités Invoke Workflow File et Invoke Process de s'exécuter au niveau d'intégrité Medium+ par invocation. Les deux conditions sont requises pour l'élévation : cette variable doit être activée et l'activité doit demander l'élévation (son option d'élévation activée) ; la variable seule n'a aucun effet. Définissez cette variable d'environnement machine (système) sur 1 pour l'activer. Nécessite Windows avec le contrôle de compte utilisateur (UAC) activé. Pour plus d’informations, consultez Élévation de l’intégrité Medium+.

  Exemple :

  UIPATH_MEDIUMPLUS_INVOKE=1
  

• UIPATH_APPLY_SERVICE_PROXY - Indique que les processus Robot prennent leur proxy dans le fichier proxy.json au niveau de la machine au lieu de la configuration du proxy du compte qui les exécute. Destiné aux Unattended Robots dont le compte de service n'a aucun profil d'utilisateur pour maintenir une configuration de proxy. Les informations d’identification du proxy par utilisateur ne sont pas lues, donc proxy.json doit les contenir si votre proxy nécessite une authentification de base. Le service de robot n’est pas affecté, car il applique toujours proxy.json. Pour plus d'informations, consultez Utilisation du proxy au niveau de la machine pour tous les processus Robot.

  Exemple :

  UIPATH_APPLY_SERVICE_PROXY=True
  

• UIPATH_VERBOSE_LOG_LIMIT - Limite le nombre de journaux Verbose par processus Executor. La valeur par défaut est 10000. Une fois la limite atteinte, le Robot consigne un avertissement et supprime les futurs journaux détaillés. Les valeurs 0 ou inférieures sont ignorées et la valeur par défaut est utilisée à la place.

  Seuls les journaux que le Robot produit lors de l'exécution des activités sont pris en compte dans la limite; messages indiquant que les journaux d'automatisation ne sont pas affectés. Un workflow invoqué de manière isolée s'exécute dans son propre processus Exécuteur, il a donc sa propre limite.

  Exemple :

  UIPATH_VERBOSE_LOG_LIMIT=5000
  

proxy.json

The proxy.json file stores proxy configuration for the Robot Service when running in service mode. Available starting with Robot 2025.10, it replaces proxy settings that were previously maintained in UiPath.config.

Important :

À partir de Robot 2025.10, les paramètres du proxy sont configurés dans proxy.json.

Accès au fichier

Emplacement du fichier : %ProgramData%\UiPath\Shared\proxy.json

Remarque :

Si vous effectuez la mise à niveau à partir d'une version antérieure et que vous avez déjà configuré les paramètres de proxy, le système migre automatiquement vos paramètres existants vers proxy.json.

Après la modification proxy.json, redémarrez le service de robot UiPath ou l'appareil pour que les modifications prennent effet.

Remarque :

The Robot ignores a proxy.json file that is not owned by the built-in Administrators group or the local system account. The Robot Service moves such a file aside as proxy.json.old.

Paramètres

Les paramètres suivants sont pris en charge. Si ScriptAddress et ProxyAddress apparaissent tous les deux dans le même fichier, c'est ScriptAddress qui prévaut.

Paramètre	Saisie de texte	Description
ScriptAddress	Chaîne de caractères (string)	URL du script d'auto-configuration du proxy (PAC). Lorsqu'il est présent, a la priorité sur ProxyAddress. Exemple : http://proxy.address/proxy.pac
ProxyAddress	Chaîne de caractères (string)	Adresse et port du serveur proxy. Exemple: http://proxy.address:1234/
BypassLocalAddresses	Booléen	Lorsque true, les adresses locales contournent le serveur proxy.
BypassList	Chaîne de caractères (string)	Liste séparée par un point-virgule des modèles d'expression régulière identifiant les hôtes qui contournent le proxy. Utilisez \\ pour échapper aux caractères regex spéciaux. Exemple : server\\.domain\\.local$;192\\.168\\.\\d{1,3}\\.\\d{1,3}
UserName	Chaîne de caractères (string)	Nom d’utilisateur pour l’authentification de base du proxy.
Password	Chaîne de caractères (string)	Mot de passe pour l’authentification de base du proxy.
Domain	Chaîne de caractères (string)	Domaine pour l'authentification de base du proxy.

Exemples de configurations

Pour obtenir des instructions de configuration étape par étape, consultez Redirection des robots via un serveur proxy.

Script PAC

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

Adresse proxy avec authentification de base

{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "<your-password>",
  "Domain": "myDomain"
}