Back to Mavenlink.com Blog Tour Status

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 Mavenlink. 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 Mavenlink Integrations Platform to use the new token.

To perform this update, please follow the steps below:

Step-by-Step

How to Authenticate Using a Jira API Token

  1. 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 Mavenlink Integrations Platform.
  2. Navigate to Manage Profile in the Your Products section. ManageProfile.pngYour profile displays.
  3. In the left-hand navigation bar, click Security.Security.png The Security age displays.
  4. Under the API token section, click Create and manage API tokensAPITokens.png The Manage Your Account > API tokens page displays.
  5. Click Create API token.CreateAPIToken.png
  6. Provide a memorable and concise label for your new token.Create-API-token-1.png
  7. 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.Your-New-API-Token.png
  8. Next, go to the Mavenlink Integrations Platform.
  9. From the Mavenlink Integrations header, select Services from the Account drop-down menu.MIP-Header-Services.png
  10. 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.jira-account-service-mapping.png
  11. 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.Services-Jira-MIP.png
    • 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.
  12. When you are finished updating these sections, click Save.
  13. Check to make sure the Mavenlink Integrations Platform can connect by clicking the Test button(s) located to the right of each Jira Service in the Account Services sections.Account-Services-Jira-Test-MIP.png
  14. If everything is configured correctly, you will receive a ‘success’ confirmation message. Your integration scenarios will automatically start using the updated service definition.

Test-Success.png

Related Articles:

Step-by-Step:

Created on