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 :

Paramètre	Description	Exemple
-U	URL d'Orchestrator	https://cloud.uipath.com/
-T	Nom du locataire Orchestrator	DefaultTenant
-A	Nom de l'organisation	myorg
-I	ID d’application externe	12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx
-S	Clé secrète d’application externe	**** (protéger)
--applicationScope	Liste d'étendues séparées par des espaces	Voir les étendues ci-dessus
--traceLevel	Niveau de journalisation	Information, Verbose, Warning

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.