Authentification et étendues

Toutes les commandes de solution nécessitent une authentification via une application externe configurée dans Orchestrator. Contrairement aux tâches de projet autonomes, les solutions ne prennent pas en charge les méthodes d’authentification par machine ou interactives.

Exigences d’authentification

Les commandes Solutions s'authentifient exclusivement via OAuth2 avec des applications externes.

Vous devez configurer une application externe dans Orchestrator Admin avec les étendues appropriées avant d’exécuter des commandes CLI de solution.

Étendues OAuth requises

Les solutions utilisent un ensemble dédié d’étendues d’application qui diffèrent des étendues Orchestrator standard. Configurez votre application externe avec les étendues suivantes pour toutes les opérations de solution :

Format Copier-coller pour les clés secrètes CI/CD :

AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write

Ce format d’une seule ligne séparé par des espaces peut être directement utilisé dans :

• Groupes de variables Azure DevOps
• Clés secrètes du référentiel GitHub
• Magasin d'identifiants Jenkins

Remarque : les opérations suivantes ne nécessitent pas d’authentification, car elles s’exécutent localement :

• restore : restaure les dépendances localement
• analyze : valide les projets localement
• pack : crée des packages localement

Paramètres d’authentification communs

Toutes les commandes Solution qui interagissent avec Orchestrator nécessitent ces paramètres. Vous pouvez utiliser la forme courte ou la forme longue (alternative) pour chacun :

Formulaire court	Formulaire long (alternative)	Description	Exemple
-U	S/O	URL d'Orchestrator	Voir l’URL Orchestrator ci-dessous
-T	S/O	Nom du locataire Orchestrator	DefaultTenant
-A	--accountForApp	Nom de l'organisation (compte)	myorg
-I	--applicationId	ID d’application externe	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	--applicationSecret	Clé secrète d’application externe	**** (protéger)
--applicationScope	S/O	Liste des étendues (voir ci-dessus)	Au-dessus
--traceLevel	S/O	Niveau de journalisation	Information, Verbose, Warning

Exemple avec des paramètres de forme longue :

uipcli solution upload-package ./packages/MySolution.1.0.0.zip \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  --accountForApp myorg \
  --applicationId 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  --applicationSecret **** \
  --applicationScope "AutomationSolutions Solutions.Packages Solutions.Packages.Write"

URL d'Orchestrator

Utilisez l'URL de base uniquement pour l'instance Orchestrator. N'incluez pas les segments d'organisation, de locataire ou de chemin d'accès (par exemple, n'utilisez pas https://cloud.uipath.com/myorg/DefaultTenant/orchestrator_). L'organisation et le locataire sont transmis séparément avec -A et -T.

• UiPath Automation Cloud: utilisez l'URL de base du cloud (par exemple https://cloud.uipath.com/ ou https://staging.uipath.com/).
• Automation Suite (On-Premises ou Cloud privé): utilisez l'URL de base de votre instance Automation Suite (par exemple https://uipath.yourcompany.com/). L’URL est la même que pour les commandes de package. Seule l'adresse de base de votre Orchestrator (ou Automation Suite) diffère du cloud public.

Remarque :

Lorsque vous utilisez l’authentification d’application externe sans spécifier le paramètre --applicationScope , la CLI applique automatiquement les étendues requises pour les commandes de solution.

Configuration d'une application externe

Pour créer une application externe pour les solutions :

1. Connectez-vous à Orchestrator en tant qu’administrateur.
2. Accédez à Admin → Applications externes.
3. Cliquez sur Ajouter une application.
4. Indiquez un nom (par exemple, CI-CD-Solutions).
5. Sélectionnez Application confidentielle comme type d’application.
6. Ajoutez les étendues requises répertoriées ci-dessus.
7. Copiez l’ ID d’application et la clé secrète et stockez-les en toute sécurité dans votre gestionnaire de secret CI/CD.

Pour obtenir des instructions détaillées sur la configuration des applications externes, consultez Gestion des applications externes OAuth.

Utilisation de flux Orchestrator personnalisés

Lorsque vous utilisez des flux d'activités personnalisés provenant d'Orchestrator pendant des opérations de restauration, utilisez ces autres paramètres :

Paramètre standard	Paramètre de flux personnalisé
--applicationScope	--libraryOrchestratorApplicationScope
-T (locataire)	--libraryOrchestratorTenant
-U (URL)	--libraryOrchestratorUrl
(dossier)	--libraryOrchestratorFolder

Exemple :

uipcli solution restore <solution-path> \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --libraryOrchestratorApplicationScope "OR.Folders OR.Settings.Read" \
  --libraryOrchestratorTenant DefaultTenant \
  --libraryOrchestratorUrl https://cloud.uipath.com/ \
  --libraryOrchestratorFolder MyFolder

Meilleures pratiques de sécurité

• Ne jamais coder en dur des clés secrètes dans les pipelines YAML ou dans les scripts.
• Utilisez la gestion des clés secrètes de votre plate-forme CI/CD :
  • Azure DevOps : Groupes de variables avec des variables Secret.
  • Actions GitHub : clés secrètes du référentiel ou de l'organisation.
  • Jenkins : Magasin dʹidentifiants.
• Rotez régulièrement les clés secrètes de l’application externe.
• Utilisez des applications externes distinctes pour différents environnements (Dév, Test, Prod).
• Appliquer des étendues de moindre privilège : accordez uniquement ce qui est nécessaire pour chaque pipeline.