Integração da sua ferramenta com o 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.
• Generate an installation token in Orchestrator Identity Management. You will need this to provision through the command line. To get the Orchestrator Identity access token, see Generate an installation access token.

Métodos de autorização

Você pode escolher entre dois métodos para provisionar um cliente OAuth externo, com base em casos de uso específicos que dependem das versões usadas em sua infraestrutura de produto UiPath:

• 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

Você pode registrar seu aplicativo no Identity Management, definir os escopos do Test Manager e estabelecer uma conexão entre os aplicativos.

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.

Provisionamento por meio do CLI do Test Manager

Por meio da autorização da CLI do Test Manager, você pode provisionar o cliente, atribuir escopos e, em seguida, estabelecer uma conexão serviço a serviço entre os aplicativos.

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

Para estabelecer uma conexão serviço a serviço entre o Test Manager e seu aplicativo, você usará a Test Manager Provisioning Tool como a ferramenta CLI principal para obter um cliente, fornecer direitos de acesso e escopos para sua integração. Você pode encontrar esta ferramenta empacotada com cada compilação como testmanager.exe no local de instalação padrão, da seguinte forma:

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

Alternativamente, você pode encontrar o executável em sua pasta de instalação personalizada. Para obter uma lista de comandos e opções que estão fora do escopo da sua integração, consulte 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.
• Você precisa definir os escopos do Test Manager.

Command	Opção	Description
register third-party-s2sclient	-iu, --identityUrl (obrigatório)	A URL absoluta onde o Identity Server está localizado.
	-iit, --identityInstallationToken <identityinstallationtoken> (obrigatório)	O token de autenticação para provisionar clientes no Identity Server.
	cscopes, --clientScopes <clientscopes> (obrigatório)	Mostre os escopos do cliente a serem usados ao criar o cliente.
	-cid, --clientID<br /><br />&lt;clientid&gt;	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 <code>
register third-party-s2sclient</code>
-iu "https://orchestratorURL/identity" <code>
-iit "<your-access-token>" </code>
-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: <your-client-secret>