Integração de 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.
• 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

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 produtos UiPath®:

• Se você executar o Test Manager e o Orchestrator versão 21.4 ou superior, pode usar o Provisionamento por meio do Gerenciamento de Identidades.
• Se você executar o Test Manager versão 21.4 e o Orchestrator versão 20.10 ou quiser habilitar o acesso entre tenant, use o Provisionamento por meio da CLI do Test Manager.

Provisionamento por meio do Gerenciamento do Identity

Você pode registrar seu aplicativo no Gerenciamento de Identidades, 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.

Quando você definir os escopos de API para a integração, selecione Test Manager como um Recurso. Para obter mais informações, consulte Escopos.

Provisionamento por meio da 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 de serviço a serviço entre os aplicativos.

Para integrar e começar a usar seu aplicativo com o Test Manager, você precisa configurar a autorização: Provisionar clientes e escopos e, em seguida, obter um ID do cliente e segredo do cliente.

Configurar autorização

Para estabelecer uma conexão de serviço a serviço entre o Test Manager e seu aplicativo, você usará a Ferramenta de Provisionamento do Test Manager como a principal ferramenta de CLI para obter um cliente, fornecer direitos de acesso e escopos para sua integração. Você pode encontrar essa 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 (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