- Erste Schritte
- Projektmanagement
- Projektvorgänge und Dienstprogramme
- Test Manager-Einstellungen
- ALM Tool-Integration
- API-Integration
- Integrieren Ihres Tools mit dem Test Manager
- API-Scopes
Ü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.
- 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.
Autorisierungsmethoden
Für die Bereitstellung eines externen OAuth-Clients können Sie zwischen zwei Methoden wählen, die auf spezifischen Anwendungsfällen basieren und von den Versionen abhängig sind, die in Ihrer UiPath®-Produktinfrastruktur verwendet werden:
- 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
Sie können Ihre Anwendung im Identity Management registrieren, die Test Manager-Scopes definieren und eine Verbindung zwischen den Anwendungen herstellen.
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.
Bereitstellen über die Test Manager-CLI
Über die Test Manager CLI-Autorisierung können Sie den Client bereitstellen, Scopes zuweisen und anschließend eine Dienst-zu-Dienst-Verbindung zwischen den Anwendungen herstellen.
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
Um eine Dienst-zu-Dienst-Verbindung zwischen dem Test Manager und Ihrer Anwendung herzustellen, verwenden Sie das Test Manager-Bereitstellungstool als wichtigstes CLI-Tool. Damit können Sie einen Client abrufen sowie Zugriffsrechte und Bereiche für Ihre Integration festlegen. Dieses Tool wird mit jedem Build als testmanager.exe in den Standardinstallationsordner gepackt. Dies geschieht wie folgt:
C:\Program Files (x86)\UiPath\TestManager\Tools\TestManagerProvisioner.
Alternativ können Sie die ausführbare Datei in Ihrem benutzerdefinierten Installationsordner finden. Eine Liste der Befehle und Optionen, die außerhalb des Scopes Ihrer Integration liegen, finden Sie in der Kurzübersicht über das Test Manager-Bereitstellungstool.
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.
- Sie benötigen das Installationstoken, das über Orchestrator Identity Management generiert wird, wie im Abschnitt der Voraussetzungen gefordert.
- Sie müssen Test Manager-Scopes definieren.
| 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<br /><br /><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
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