Integrating your tool with Test Manager

Überblick

Die in diesem Thema beschriebenen Autorisierungsmethoden enthalten Informationen darüber, wie eine Dienst-zu-Dienst-Verbindung zwischen dem Test Manager und Ihrer Anwendung oder anderen Partneranwendungen hergestellt werden kann.

Voraussetzungen

• Aktivieren Sie die Testautomatisierung im Orchestrator. Weitere Informationen finden Sie unter Funktionen aktivieren/deaktivieren.
• Generieren Sie ein Installationstoken in Orchestrator Identity Management. Sie benötigen es für die Bereitstellung über die Befehlszeile. Informationen zum Abrufen des Orchestrator Identity-Zugriffstokens finden Sie unter externe Anbieter für Hostauthentifizierung.

Autorisierungsmethoden

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.

Bereitstellen durch Identitätsverwaltung

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

Um Ihre Anwendung zu konfigurieren und zu autorisieren, müssen Sie eine externe Anwendung hinzufügen.

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.

Autorisierung konfigurieren

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.

Im folgenden Abschnitt sind die verfügbaren Befehlszeilenparameter aufgeführt, einschließlich Optionen und Standardwerte, sodass Sie Zugriffsrechte und Scopes bereitstellen und dann eine Client-ID und einen geheimen Clientschlüssel für Ihre Anwendung abrufen können.

Hinweis:

• Sie benötigen das Installationstoken, das über Orchestrator Identity Management generiert wird, wie im Abschnitt der Voraussetzungen gefordert.
• You need to define Test Manager scopes.

Befehl	Option	Beschreibung
register third-party-s2sclient	-iu, --identityUrl (Erforderlich)	Die absolute URL, unter der sich Identity Server befindet.
	-iit, --identityInstallationToken <identityinstallationtoken> (Erforderlich)	Das Authentifizierungstoken für die Bereitstellung von Clients in Identity Server.
	cscopes, --clientScopes <clientscopes> (Erforderlich)	Zeigt Client-Scopes an, die beim Erstellen des Clients verwendet werden sollen.
	`-cid, --clientID <clientid>`	Zeigt die Client-ID an, die beim Erstellen des Clients verwendet werden soll. Wird automatisch generiert, wenn Sie keine Client-ID angeben.
	-cname, --clientName <clientname>	Zeigt den Clientnamen an, der beim Erstellen des Clients verwendet werden soll. Wird automatisch generiert, wenn Sie keinen Clientnamen angeben.
	-csecret, --clientSecret <clientsecret>	Zeigt den geheimen Clientschlüssel an, der beim Erstellen des Clients verwendet werden soll. Wird automatisch generiert, wenn Sie keinen geheimen Clientschlüssel angeben.
	-lang, --language <language>	Geben Sie die Sprache der Fehlermeldungen an.
	-?, -h?, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Shell-Skriptbeispiel

In diesem Beispiel wird nach dem Befehl register third-party-s2sclient die Orchestrator Identity-URL, das Token für die Identitätsinstallation und der Projekt-Scope des Test Managers angegeben.

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