Configuration

La UiPath CLI est configurée via des variables d'environnement et des indicateurs par commande. Il n'y a pas de fichier de configuration à usage général: définissez les variables d'environnement dans l'environnement du runtime et transmettez les indicateurs aux commandes.

Sources de configuration

Par ordre de priorité, du plus spécifique au plus général:

1. Indicateur de ligne de commande — --tenant, --authority, --client-id, --output, --log-level, etc. Les indicateurs ont priorité sur toutes les autres sources.
2. Variable d'environnement — variables lues par la CLI au moment du runtime (voir Variables d'environnement). La CLI lit chaque variable uniquement aux points documentés; il n'y a pas de règle implicite « chaque indicateur a une homologue env-var».
3. Valeurs par défaut codées en dur — https://cloud.uipath.com pour l'autorité, json pour le format de sortie, info pour le niveau du journal, taille de page de 50 sur les verbes de la liste.

Variables de l'environnement

Les variables d'environnement sont le principal mécanisme de configuration de la CLI dans les runtimes CI, les conteneurs et les configurations de développeur par shell. Définissez-les dans l'environnement de l'exécuteur (ou dans un fichier .env utilisé par votre exécuteur) et la CLI les lira aux points documentés ci-dessous.

Variable	Lire par	Objectif
UIPATH_URL	uip login, chaque commande authentifiée	Remplacer l’URL de base de l’autorité d’identité. La valeur par défaut est https://cloud.uipath.com.
UIPATH_CLI_ENABLE_ENV_AUTH	Chaque commande authentifiée	Définissez sur true pour faire passer la CLI du flux d’informations d’identification basé sur fichier vers l’authentification variable d’environnement. Lorsque cette passerelle est activée, la CLI lit le jeton d'accès + le locataire + l'organisation à partir des variables ci-dessous et contourne entièrement le dossier d'informations d'identification ~/.uipath/ . Voir Authentification — Flux 3.
UIPATH_CLI_AUTH_TOKEN	env-var flux d'authentification uniquement	Jeton d’accès JWT. L'URL du serveur est dérivée de la revendication iss du jeton.
UIPATH_CLI_ORGANIZATION_NAME	env-var flux d'authentification uniquement	Champ de données dynamique de l’organisation.
UIPATH_CLI_ORGANIZATION_ID	env-var flux d'authentification uniquement	UUID de l’organisation.
UIPATH_CLI_TENANT_NAME	env-var flux d'authentification uniquement	Champ de données dynamique du locataire.
UIPATH_CLI_TENANT_ID	env-var flux d'authentification uniquement	UUID du locataire.
UIPATH_TELEMETRY_DISABLED	Initialisation de la télémétrie	Définissez sur 1 ou true pour refuser la télémétrie d'utilisation anonyme.
UIPATH_AI_CONNECTION_STRING	Initialisation de la télémétrie	Remplacez la chaîne de connexion Application Insights.
HTTP_PROXY / http_proxy	Couche réseau	Proxy HTTP pour les demandes sortantes (hôte et outils).
HTTPS_PROXY / https_proxy	Couche réseau	Proxy HTTPS.
NO_PROXY / no_proxy	Couche réseau	Liste de contournement du proxy.

Pour les valeurs non secrètes qui varient d’un déploiement à l’autre (locataire, organisation, nom de dossier), transmettez-les en tant que variables dans votre exécuteur CI et référencez-les dans les commandes uip :

env:
  UIPATH_TENANT: Production
  UIPATH_FOLDER: Shared
script:
  - uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET --tenant "$UIPATH_TENANT"
  - uip or folders list --all --path "$UIPATH_FOLDER"

Avertissement :

Aucune lecture implicite de UIPATH_CLient_ID /UIPATH_CLient_SECRET

La définition UIPATH_CLIENT_ID et UIPATH_CLIENT_SECRET dans l'environnement seul n'authentifie pas la CLI. Les versions antérieures à 1.0 les lisent implicitement; ce comportement a été supprimé. Transmettez-les explicitement à l’aide du préfixe env.VAR_NAME sur --client-id / --client-secret, ou utilisez le flux d’authentification env-var ci-dessus pour l’authentification basée sur jeton. Voir Authentification.

Où chaque paramètre peut être actif

Paramètre	Drapeau	Var d'environnement	Default
Autorité / URL de base	--authority <url>	UIPATH_URL	https://cloud.uipath.com
ID client de l'application externe	--client-id <id>	— (défini via un indicateur avec le préfixe env.VAR_NAME)	aucun
Clé secrète du client de l’application externe	--client-secret <secret>	— (défini via un indicateur avec le préfixe env.VAR_NAME)	aucun
Locataire	--tenant <name> (ou session)	—	depuis la session
Dossier	--folder-path / --folder-key par commande	—	aucun
Format de sortie	--output <format>	—	json
Filtre de sortie	--output-filter <jmespath>	—	aucun
Niveau de journalisation	--log-level <level>	—	info
Fichier journal (Log File)	--log-file <path>	—	aucun
registre npm pour les outils	—	—	.npmrc @uipath:registry (si défini), sinon npm par défaut
Télémétrie	—	UIPATH_TELEMETRY_DISABLED=1	enabled

Les paramètres sans colonne env-var ne peuvent être définis que par commande via des indicateurs.

Exemples de configurations

Exécuteur CI minimum (tout via env)

env:
  UIPATH_URL: https://cloud.uipath.com
  UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
  UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}
  UIPATH_TENANT: Production
  UIPATH_TELEMETRY_DISABLED: "1"

steps:
  - run: npm install -g @uipath/cli
  - run: uip tools install @uipath/orchestrator-tool @uipath/solution-tool
  - run: |
      uip login \
        --client-id env.UIPATH_CLIENT_ID \
        --client-secret env.UIPATH_CLIENT_SECRET \
        --tenant "$UIPATH_TENANT"
  - run: uip or folders list

Conteneur avec un jeton pré-émis (flux d’authentification env-var)

export UIPATH_CLI_ENABLE_ENV_AUTH=true
export UIPATH_CLI_AUTH_TOKEN="$BUILD_TOKEN"
export UIPATH_CLI_ORGANIZATION_NAME=contoso
export UIPATH_CLI_ORGANIZATION_ID="$ORG_UUID"
export UIPATH_CLI_TENANT_NAME=Default
export UIPATH_CLI_TENANT_ID="$TENANT_UUID"

uip or folders list

Aucune étape uip login , aucun fichier écrit. Chaque commande s'authentifie à partir des variables d'environnement.

Voir également

• Authentification — les trois flux d'authentification et les variables d'environnement que chacun lit.
• Installation de la UiPath CLI — variables proxy, refus de la télémétrie et modèles d'installation CI.
• Sessions et informations d'identification — le dossier .uipath/ Credentials écrit par uip login.
• Options globales — indicateurs qui remplacent les variables d'environnement par invocation.