Create a new Azure Connection

TFS4JIRA requires connections to your Jira and Azure DevOps instances to perform synchronization tasks. Since TFS4JIRA is installed on Jira Cloud, no connection configuration is required. However, you must establish a connection to an Azure DevOps instance.

This page provides instructions for creating, editing and removing a connection to Azure DevOps.

Create a new connection to Azure

1. There are two ways to access the Azure Connections page:

   1. From the TFS4JIRA Synchronizer page. Click Connections from the Jira-Azure Synchronizer menu and click +Add Azure Connection to open the Add Azure Connection page.

   2. When creating or editing a Sync profile from the Connections section of General Settings. Click the Azure field and select Add Connection to go to the Add Azure Connection page.

2. Provide your Azure connection credentials:

   1. Enter the Azure Instance URL. Provide the root path to your instance, not to a particular project.

   2. Enter the Sync user email. This user account performs all synchronization changes and is associated with the personal access token.
      We strongly recommend creating a dedicated Azure user account specifically for synchronization. Refer to/wiki/spaces/DEVM/pages/559546535 for more information.

   3. Enter an Azure Personal access token. This token is created in Azure DevOps and contains security credentials used for authentication.
      Refer toCreate a Personal Access Token in Azure for creating a token in Azure.

      

3. Click Test Connection. A Connection succeeded message appears when all the provided details are valid.

4. Click Add Connection to save the connection.

The new connection appears on the Azure Connections page.

Edit an existing connection

1. Click Connections from the Jira-Azure Synchronizer menu to open the Azure Connections page.

2. Click the Options icon (…) for the connection you want to edit.

3. Click Edit from the options list.

4. You can update the Instance URL, Sync user email, or Personal access token from the Edit Azure Connection page.

5. Click Test Connection. A Connection succeeded message appears when all the provided details are valid.

6. Click Save Connection to save the updated details.

Remove an existing connection

1. Click Connections from the Jira-Azure Synchronizer menu to open the Azure Connections page.

2. Click the Options icon (…) for the connection you want to remove.

3. Click Remove from the options list.

4. Type REMOVE CONNECTION in the Remove connection? dialog to confirm.

5. Click Remove connection. This action cannot be undone.

   

The connection is now removed from the Azure Connections page.