Connect Azure DevOps

Connect Azure DevOps to show its work items in their own tab in the dialog, next to your JSM tabs. You create a Personal Access Token (PAT) in Azure DevOps, and then enter it in UniPortal together with the name of your organization.

Before you start

• You need administrator permissions in Jira, and permission to create a PAT in Azure DevOps.
• The organization name is the part of the address that comes right after dev.azure.com/, without https://. It can contain only letters, digits, and hyphens, and it must start with a letter or a digit.

Create a Personal Access Token in Azure DevOps

1. In Azure DevOps, select the settings icon in the top right and then select Personal access tokens.

   

2. Select New Token, enter a name, choose your organization, and choose an expiration date. Under Scopes, select Full access, and then select Create.

   

3. Copy the token right away. Azure DevOps shows it only once, and you can’t see it again after you leave the page.

   

Connect Azure DevOps in UniPortal

1. In Jira, select the cog icon and go to Marketplace apps > UniPortal > Connections.

2. Select Connect new tool and choose Azure DevOps.

3. In the Connect Azure DevOps window, paste the token into the Personal Access Token field.

4. Enter your organization name in the Organization field.

   

5. Select Connect. UniPortal asks you to allow access to dev.azure.com and to the visualstudio.com address of your organization. Select Approve. UniPortal then saves the credentials and tests the connection.

   

If the test fails, UniPortal shows a failure message and keeps the saved credentials. Correct the values and select Connect again. You can also check the connection later with Test connection in the … menu next to it.

Result

Your Azure DevOps organization appears in the Connections table.

The name in the Connected tool column is the name of the connection. It defaults to your organization name, and customers see it as the name of the instance tab in the dialog. To show another name, enter an Instance tab name in Configure tabs, for example “Dev Tasks”. A newly connected organization has no tabs yet, so add one in Request Tabs and choose its project and columns there.