Integrating your tool with Test Manager

Visão geral

Os métodos de autorização descritos neste tópico fornecem informações sobre como estabelecer uma conexão serviço a serviço entre o Test Manager e seu aplicativo ou outros aplicativos parceiros.

Pré-requisitos

• Habilitar Testar automação no Orchestrator. Para obter mais informações, consulte Habilitando/desabilitando recursos.
• Gere um token de instalação no Orchestrator Identity Management. Você precisará disso para provisionar através da linha de comando.Para obter o token de acesso ao Orchestrator Identity, consulte provedores externos para autenticação do host.

Métodos de autorização

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.

Provisionamento por meio do Gerenciamento do Identity

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

Para configurar e autorizar seu aplicativo, você precisa adicionar um aplicativo externo.

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 autorização

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.

A seção a seguir lista os parâmetros de linha de comando disponíveis, incluindo opções e valores padrão para que você possa fornecer direitos de acesso e escopos e, em seguida, obter um ID e um segredo do cliente para seu aplicativo.

Observação:

• Você precisará do token de instalação gerado por meio do Gerenciamento do Orchestrator Identity, conforme solicitado na seção de pré-requisitos.
• You need to define Test Manager scopes.

Command	Opção	Description
register third-party-s2sclient	-iu, --identityUrl (Necessário)	A URL absoluta onde o Identity Server está localizado.
	-iit, --identityInstallationToken <identityinstallationtoken> (Necessário)	O token de autenticação para provisionar clientes no Identity Server.
	cscopes, --clientScopes <clientscopes> (Necessário)	Mostre os escopos do cliente a serem usados ao criar o cliente.
	`-cid, --clientID <clientid>`	Mostre o ID do cliente a ser usado ao criar o cliente. Isso é gerado automaticamente se você não fornecer um ID do cliente.
	-cname, --clientName <clientname>	Mostre o nome do cliente a ser usado ao criar o cliente. Isso é gerado automaticamente se você não fornecer um nome de cliente.
	-csecret, --clientSecret <clientsecret>	Mostre o segredo do cliente a ser usado ao criar o cliente. Isso é gerado automaticamente se você não fornecer um segredo do cliente
	-lang, --language <language>	Especifique o idioma das mensagens de erro.
	-?, -h?, --help	Mostrar informações de ajuda e uso.

Amostra de Script de Shell

No exemplo a seguir, o comando register third-party-s2sclient é seguido pelo URL do Orchestrator Identity, token de instalação do Identity e os escopos de projeto do 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