All Collections
Jira Integration
oAuth based Integration
Integrate with Jira Server using oAuth
Integrate with Jira Server using oAuth

Setup integration with Jira Server using oAuth

Kendis Team avatar
Written by Kendis Team
Updated over a week ago

Kendis supports integration with Jira Server using oAuth protocol.

Reference Link for Jira oAuth

It is important that you have Jira "Administration" rights and are familiar with Jira admin interface. This article from Jira explains how you to get Jira Server Private key and Public key.

https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-oauth-authentication/

You need these 2 keys in order to proceed to the next steps.

Steps for Configuration

There are 3 steps to complete this configuration and you need to make changes at both Kendis and Jira.
​Important Note: It's recommended that you open Kendis and Jira, so you don't have to navigate away from Kendis screen.

Step 1 - At Kendis

Get the callback URL from Kendis that you need in Step 2 for Jira.

  1. Go to ALM Accounts click on Add ALM Account select Jira Server oAuth type it will generate a callback URL.

  2. Copy the callback URL.
    ​

    ​

Step 2 - At Jira

  1. Goto this link in Jira:
    ​http://<your jira url>/plugins/servlet/applinks/listApplicationLinks

  2. Create AppLink with <any name> in URL field and press Continue.
    Important: Don't use a URL. It must be some name like "company-name-app"

  3. Give <any> Application Name and press Continue

  4. Once the App has been created, click on the Pencil button to configure.

  5. Goto Incoming Authentication tab & fill:
    a. Consumer Key (it can be any value)
    b. Consumer Name (it can be any value)
    c. Enter the server's PUBLIC KEY (Jira Server Public Key)
    d. and Consumer CallBack URL (The one generated by Kendis, which we copied in Part 1 and SAVE

Step 3 - At Kendis

Fill up the details at the Kendis ALM account setup that you started in Step 1.

  1. Use Consumer Key (Created in Jira, Step 2.5.a)

  2. Then copy from the Jira server's PRIVATE Key
    Important: Please copy the private key from the .pcks8 file, e.g., "jira_privatekey.pcks8" (Refer to Jira help article)

  3. Click on Get Auth Token it will navigate to the Jira server and ask for authorization Allow it.

  4. Once navigated back to Kendis, click on Test Connection & map fields.

  5. Finally press SAVE

User Profile Setup

Now create a board with this ALM, and when you go there, Kendis will ask you to set an ALM account for your profile.

  • Go to Profile and click on "ALM Credentials"

  • Make sure you have selected the correct ALM account that you have configured with oAuth.

  • Click on the "Edit"

  • Click on the "Get oAuth token"

  • It will take you to Jira to the authentication screen, and users need to authenticate with their Jira credentials on the Jira login page.

  • Please note, that the user doesn't need to give any keys, etc that were needed for ALM creation. So they simply need to authorize their Jira account.

Note

If ALM is oAuth then the user has to use oAuth, there is no password option for oAuth ALM. Additionally, oAuth doesn't impact your existing ALMs and boards, they will keep on working as-is.

Did this answer your question?