Intégrer votre outil avec Test Manager

Vue d'ensemble (Overview)

Les méthodes d'autorisation décrites dans cette rubrique fournissent des informations sur la façon d'établir une connexion de service à service entre Test Manager et votre application, ou d'autres applications partenaires.

Prérequis

Activez l'automatisation des tests dans Orchestrator. Pour plus d’informations, consultez Activation/désactivation des fonctionnalités.
Générez un jeton d’installation dans Orchestrator Identity Management. Vous en aurez besoin pour enregistrer via la ligne de commande. Pour obtenir le jeton d’accès Orchestrator Identity, consultez Générer un jeton d’accès d’installation.

Méthodes d'autorisation

Vous pouvez choisir entre deux méthodes pour enregistrer un client OAuth externe, en fonction de cas d’utilisation spécifiques qui dépendent des versions utilisées dans votre infrastructure produit UiPath® :

Si vous exécutez à la fois Test Manager et Orchestrator version 21.4 ou ultérieure, vous pouvez utiliser l’enregistrement via la gestion des identités.
Si vous exécutez Test Manager version 21.4 et Orchestrator version 20.10, ou si vous souhaitez activer l’accès entre locataires, vous pouvez utiliser l’enregistrement via la CLI de Test Manager.

Enregistrement via la gestion des identités

Vous pouvez enregistrer votre application dans Identity Management, définir les étendues de Test Manager et établir une connexion entre les applications.

Pour configurer et autoriser votre application, vous devez ajouter une application externe.

Lorsque vous définissez les étendues d’API pour l’intégration, sélectionnez Test Manager en tant que ressource. Pour plus d’informations, consultez la section Étendues.

Enregistrement via la CLI de Test Manager

Grâce à l’autorisation de la CLI de Test Manager, vous pouvez enregistrer le client, attribuer des étendues, puis établir une connexion de service à service entre les applications.

Pour intégrer et commencer à utiliser votre application avec Test Manager, vous devez configurer l’autorisation : enregistrez le client et les étendues, puis obtenez un ID de client et une clé secrète de client.

Configurer l'autorisation

Pour établir une connexion de service à service entre Test Manager et votre application, vous utiliserez l’outil d’enregistrement de Test Manager comme principal outil de CLI pour récupérer un client et fournir des droits d’accès et des étendues pour votre intégration. Cet outil est fourni avec chaque version sous la forme d’un fichier testmanager.exe situé à l’emplacement d’installation par défaut, comme suit :

C:\Program Files (x86)\UiPath\TestManager\Tools\TestManagerProvisioner.

Vous pouvez également trouver l'exécutable dans votre dossier d'installation personnalisé. Pour obtenir une liste des commandes et des options qui sortent du cadre de votre intégration, consultez Aide-mémoire pour l'outil d'enregistrement de Test Manager.

La section suivante répertorie les paramètres de ligne de commande disponibles, y compris les options et les valeurs par défaut, afin que vous puissiez enregistrer des droits d'accès et des étendues, puis obtenir un ID et une clé secrète de client pour votre application.

Remarque :

Vous aurez besoin du jeton d’installation généré via Orchestrator Identity Management, comme demandé dans la section des prérequis.
Vous devez définir les étendues Test Manager.

Commande	Option	Description
`register third-party-s2sclient`	`-iu, --identityUrl` (requis)	L’URL absolue où se trouve Identity Server.
	`-iit, --identityInstallationToken <identityinstallationtoken>` (requis)	Le jeton d’authentification pour l’enregistrement des clients dans Identity Server.
	`cscopes, --clientScopes <clientscopes>` (requis)	Affichez les étendues client à utiliser lors de la création du client.
	`-cid, --clientID <IDclient>`	Affichez l'ID de client à utiliser lors de la création du client. Il est généré automatiquement si vous ne fournissez pas d'ID de client.
	`-cname, --clientName <clientname>`	Affichez le nom du client à utiliser lors de la création du client. Il est généré automatiquement si vous ne fournissez pas de nom de client.
	`-csecret, --clientSecret <clientsecret>`	Affichez la clé secrète du client à utiliser lors de la création du client. Elle est générée automatiquement si vous ne fournissez pas de clé secrète de client.
	`-lang, --language <language>`	Spécifiez la langue des messages d'erreur.
	`-?, -h?, --help`	Affiche l'aide et les informations d’utilisation.

Exemple de script Shell

Dans l'exemple suivant, la commande register third-party-s2sclient est suivie de l'URL d'identité d'Orchestrator, du jeton d'installation d'identité et des étendues de projet Test Manager.

testmanager.exe `
register third-party-s2sclient`
-iu "https://orchestratorURL/identity" `
-iit "e908741iofjikasjijfapuosf09210-012opjawdfsaodgfsadgu90029183i1jiratjapo" `
-cscopes "TM.Projects" "TM.Requirements.Read"
Client created successfully. Please note the data below right away. You will not be able to retrieve the secret afterwards.
ClientID: TestManager.ThirdPartyClient.36512487-1rfasdf-11451-321535
ClientName: TestManager.ThirdPartyClient.36512487-1rfasdf-11451-321535
ClientSecret: 43sdgj@efg145!fgdsg53125sfdg12a*gbj9testmanager.exe `
register third-party-s2sclient`
-iu "https://orchestratorURL/identity" `
-iit "e908741iofjikasjijfapuosf09210-012opjawdfsaodgfsadgu90029183i1jiratjapo" `
-cscopes "TM.Projects" "TM.Requirements.Read"
Client created successfully. Please note the data below right away. You will not be able to retrieve the secret afterwards.
ClientID: TestManager.ThirdPartyClient.36512487-1rfasdf-11451-321535
ClientName: TestManager.ThirdPartyClient.36512487-1rfasdf-11451-321535
ClientSecret: 43sdgj@efg145!fgdsg53125sfdg12a*gbj9