Integrating your tool with Test Manager

Información general

Los métodos de autorización descritos en este tema proporcionan información sobre cómo establecer una conexión de servicio a servicio entre Test Manager y tu aplicación u otras aplicaciones de socios.

Requisitos previos

• Habilita Probar automatización en Orchestrator. Para obtener más información, consulta Habilitar/deshabilitar características.
• Genera un token de instalación en Orchestrator Identity Management. Necesitarás esto para aprovisionar a través de la línea de comandos. Para obtener el token de acceso de Orchestrator Identity, consulta Proveedores externos para la autenticación de host.

Métodos de autorización

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.

Aprovisionamiento a través de la gestión de la identidad

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

Para configurar y autorizar tu aplicación, debes añadir una aplicación externa.

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.

Configurar la autorización

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 siguiente sección enumera los parámetros de línea de comandos disponibles, incluidas las opciones y los valores predeterminados, para que puedas aprovisionar derechos de acceso y ámbitos, y luego obtener un ID y un secreto de cliente para tu aplicación.

Nota:

• Necesitarás el token de instalación generado a través de Orchestrator Identity Management, como se solicita en la sección de requisitos previos.
• You need to define Test Manager scopes.

Comando	Opción	Descripción
register third-party-s2sclient	-iu, --identityUrl (obligatorio)	La URL absoluta donde se encuentra Identity Server.
	-iit, --identityInstallationToken <identityinstallationtoken> (obligatorio)	El token de autenticación para aprovisionar clientes en Identity Server.
	cscopes, --clientScopes <clientscopes> (obligatorio)	Muestra los ámbitos de cliente que se utilizarán al crear el cliente.
	`-cid, --clientID <clientid> `	Muestra el ID de cliente que se utilizará al crear el cliente. Esto se genera automáticamente si no proporcionas un ID de cliente.
	-cname, --clientName <clientname>	Muestra el nombre de cliente que se utilizará al crear el cliente. Esto se genera automáticamente si no proporcionas un nombre de cliente.
	-csecret, --clientSecret <clientsecret>	Muestra el secreto de cliente que se utilizará al crear el cliente. Esto se genera automáticamente si no proporcionas un secreto de cliente
	-lang, --language <language>	Especifica el idioma del mensaje de error.
	-?, -h?, --help	Muestra la información de ayuda y uso.

Script de Shell de ejemplo

En el siguiente ejemplo, el comando register third-party-s2sclient es seguido por la URL de Orchestrator Identity, el token de instalación de identidad y los ámbitos de proyecto de 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