Integrating your tool with 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 la section relative aux fournisseurs externes pour l’authentification de l’hôte.

Méthodes d'autorisation

You can choose between two methods for provisioning an external OAuth client, based on specific use cases that are dependent on the versions used in your UiPath® product infrastructure:

• If you run both Test Manager and Orchestrator version 21.4 or above, you can use Provisioning through Identity Management.
• If you run Test Manager version 21.4 and Orchestrator version 20.10, or you want to enable cross-tenant access, you can use the Provisioning through Test Manager CLI.

Enregistrement via la gestion des identités

You can register your application in Identity Management, define the Test Manager scopes and establish a connection between the applications.

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

When you define the API scopes for the integration, select Test Manager as a Resource. For more information, see Scopes.

Provisioning through Test Manager CLI

Through the Test Manager CLI authorization, you can provision the client, assign scopes, and then establish a service-to-service connection between the applications.

To integrate and start using your application with Test Manager, you need to configure authorization: Provision client and scopes and then get a client ID and client secret.

Configurer l'autorisation

To establish a service-to-service connection between Test Manager and your application you will be using the Test Manager Provisioning Tool as the main CLI tool to get a client, provide access rights and scopes for your integration. You can find this tool packaged with each build as testmanager.exe in the default installation location, as follows:

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

Alternatively, you can find the executable in your custom installation folder. For a list of commands and options that are outside of the scope of your integration, see Test Manager Provisioning Tool Cheat Sheet.

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.
• You need to define Test Manager scopes.

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*gbj9