# Integrating your tool with Test Manager

> Authorization methods for establishing service-to-service connections between standalone Test Manager and partner or custom applications.

## Overview

The authorization methods described in this topic provide information on how to establish a service-to-service connection between Test Manager and your application, or other partner applications.

## Prerequisites

* Enable Test Automation in Orchestrator. For more information, see [Enabling/Disabling Features](https://docs.uipath.com/orchestrator/standalone/2025.10/user-guide/managing-tenants#enablingdisabling-features).
* Generate an installation token in Orchestrator Identity Management. You will need this to [provision through the command line](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/integrating-your-tool-with-test-manager#integrating-your-tool-with-test-manager). To get the Orchestrator Identity access token, see [Generate an installation access token](https://docs.uipath.com/orchestrator/standalone/2025.10/user-guide/host-authentication-settings#installation-key).

## Authorization methods

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](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/integrating-your-tool-with-test-manager#integrating-your-tool-with-test-manager).
* 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](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/integrating-your-tool-with-test-manager#integrating-your-tool-with-test-manager).

## Provisioning through Identity Management

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

To configure and authorize your application, you need to [add an external application](https://docs.uipath.com/orchestrator/standalone/2025.10/user-guide/managing-external-applications#adding-an-external-application).

When you define the API scopes for the integration, select **Test Manager** as a **Resource**. For more information, see [Scopes](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/test-manager-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](https://docs.uipath.com/test-manager/standalone/2025.10/user-guide/integrating-your-tool-with-test-manager#integrating-your-tool-with-test-manager): Provision client and scopes and then get a client ID and client secret.

## Configure Authorization

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](https://docs.uipath.com/test-manager/standalone/2025.10/installation-guide/test-manager-command-line-parameters).

The following section lists the available command-line parameters, including options and default values so you can provision access rights and scopes, and then get a client ID and client secret for your application.

:::note
* You will need the installation token generated
through Orchestrator Identity Management, as requested in the prerequisites section.
* You need to define Test Manager scopes.
:::

| Command | Option | Description |
| --- | --- | --- |
| `register third-party-s2sclient` | `-iu, --identityUrl` (Required) | The absolute URL where Identity Server is located. |
|  | `-iit, --identityInstallationToken <identityinstallationtoken>` (Required) | The authentication token for provisioning clients in Identity Server. |
|  | `cscopes, --clientScopes <clientscopes>` (Required) | Show client scopes to be used when creating the client. |
|  | `-cid, --clientID  &lt;clientid&gt;` | Show the client ID to be used when creating the client. This is automatically generated if you do not provide a client ID. |
|  | `-cname, --clientName <clientname>` | Show the client name to be used when creating the client. This is automatically generated if you do not provide a client name. |
|  | `-csecret, --clientSecret <clientsecret>` | Show the client secret to be used when creating the client. This is automatically generated if you do not provide a client secret |
|  | `-lang, --language <language>` | Specify the language of the error messages. |
|  | `-?, -h?, --help` | Show help and usage information. |

## Shell Script Sample

In the following example, the `register third-party-s2sclient` command is followed by the Orchestrator identity URL, identity installation token and Test Manager project scopes.

```
testmanager.exe `
register third-party-s2sclient`
-iu "https://orchestratorURL/identity" `
-iit "<your-access-token>" `
-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>
```
