Jira API Token-Based Authentication

Overview

Atlassian is sunsetting user credentials as a method of accessing the Jira API. As a result, the Jira API returns “401 Access Denied” errors when attempting to synchronize data with Kantata OX. To resolve this issue, you will need to create an API token in Jira and then update your local and global account Jira services in the Kantata Integrations Platform to use the new token.

To perform this update, please follow the steps below:

How to Authenticate Using a Jira API Token

Log in to https://start.atlassian.com.
Note: Be sure to log in as the Jira integration user you have configured in the Services - Jira sections of the Kantata Integrations Platform.
Navigate to Manage Profile in the Your Products section.

Your profile displays.
In the left-hand navigation bar, click Security.

The Security page displays.
Under the API token section, click Create and manage API tokens. The Manage Your Account > API tokens page displays.
Click Create API token.
Provide a memorable and concise label for your new token.
In the Your new API token dialog, copy the API token to your clipboard. This is important as you won't be able to see the token again later.
Next, go to the Kantata Integrations Platform.
From the Mavenlink Integrations header, select Services from the Account drop-down menu.
On the Services page, find Jira in the Account Services list and click the Edit button located to the right. Note that you can integrate more than one Jira account.
Edit the following:
- In the Email field, provide the Jira integration user’s email address.
- In the Token field, paste the API token you previously copied to your clipboard.
- Note: If you are using an On premise Jira server, tokens are not supported. You must fill out the username and password. Leave the Email field empty. Entering an email will generate a Jira error during synchronization.
When you are finished updating these sections, click Save.
Check to make sure the Kantata Integrations Platform can connect by clicking the Test button(s) located to the right of each Jira Service in the Account Services sections.
If everything is configured correctly, you will receive a ‘success’ confirmation message. Your integration scenarios will automatically start using the updated service definition.