# Step 2: Configuring Azure DevOps connection

> Configure the connection settings in Test Manager and the UiPath Azure DevOps Extension to link your Azure DevOps project with Test Manager.

An Azure DevOps connection links a Test Manager project to your Azure DevOps project.

## Setting up an Azure DevOps connection

The connection uses the Azure DevOps server URL and a personal access token, and it is completed in the UiPath® Azure DevOps Extension.

### Prerequisites

* A Test Manager administrator account.
* To save the UiPath® Test Manager extension on Azure DevOps, you must be an Azure **Administrator** user.

### Steps

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** > **Integration**.
4. Select **New Connection** and select **Azure DevOps** from the dropdown.
5. Configure the following connection settings:
   * **Name**: Enter a name for your Azure DevOps connection.
   * **Description** (Optional): Add a description for reference.
   * **Server URL**: Add the Azure DevOps server URL. For example: `https://company-name-serverRegion.cloudapp.azure.com`.
   * **Personal Access Token**: Create a personal access token (PAT) and paste it into this field to authorize Test Manager to perform actions.

     :::warning
     When you create the Azure DevOps connection, the PAT needs full access to Azure DevOps services: select **Full access** under **Scopes** when you create or edit a PAT. After the connection is finished, you can reduce the PAT scopes to : **Test Management** - `Read & Write`, and **Work Items** - `Read & Write`. For more information, see [Use personal access tokens](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows).
     :::

   * **Defect Type**: Enter an object type used for bug reporting in Azure DevOps. Otherwise, leave empty if you do not want to use defect integration. Enter a defect type based on what object type you have selected for your newly created Azure DevOps project. For example: `Bug` or `Issue`.
   * **Project Name**: Enter your Azure DevOps project name.

   ![Azure DevOps connection settings form in Test Manager](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126414-52c9b34e-5c8fa29a.webp)
6. Select the connection to expand the panel and copy the **API Key** for later use.
7. Open your project in Azure DevOps and go to **Project settings**.
8. Under **Extensions**, go to **UiPath® Test Manager**.
9. Configure the following extension settings:
   * **Requirement Types**: Select the types of objects you want to assign a test to. These show up as requirements in Test Manager. For more information, see [Requirements](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/requirements).
   * **Server URL**: Add the Test Manager URL. The URL should have the following format: https://cloud.uipath.com/{organizationName}/{tenantName}/testmanager_.
   * **API**: Paste the API key.
   * **Manage Tests with Azure DevOps**: Select this option to manage your tests through Azure DevOps. Otherwise, leave this option off, to manage your tests through Test Manager.
10. Select **Save**.

    ![UiPath Test Manager extension settings in Azure DevOps](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126380-9a1f9564-3bd1126a.webp)

### Result

The Azure DevOps project is connected to Test Manager, with the connection configured in Test Manager and the extension settings saved in Azure DevOps.

## Editing an Azure DevOps connection

Editing a connection changes the settings of an existing Azure DevOps connection.

### Prerequisites

* A Test Manager administrator account.
* An existing Azure DevOps connection.

### Steps

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Select the **Settings** button to open Project Settings.
4. In the Integration list, select an Azure DevOps connection to expand the panel.
5. Select **Edit** to configure the connection.
6. Select **Save** to confirm.

### Result

The Azure DevOps connection settings are updated with your changes.

## Deleting an Azure DevOps connection

Deleting a connection removes it together with its associated requirements.

### Prerequisites

An existing Azure DevOps connection.

### Steps

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Select the **Settings** button to open Project Settings.
4. In the Integration list, select an Azure DevOps connection to expand the panel.
5. Select **Delete** to remove the connection.
6. Select **OK** to confirm.

### Result

The Azure DevOps connection and its associated requirements are removed from your project.