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.
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.
- Go to ALM Accounts click on Add ALM Account select Jira Server oAuth type it will generate a callback URL.
- Copy the callback URL.
Step 2 - At Jira
- Goto this link in Jira:
http://<your jira url>/plugins/servlet/applinks/listApplicationLinks
- Create AppLink with <any name> in URL field and press Continue.
Important: Don't use URL, it must be some name like "company-name-app"
- Give <any> Application Name and press Continue
- Once the App has been created, click on the Pencil button to configure.
- 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
- Now at Kendis give this same Consumer Key
- Then the server's PRIVATE Key
Important: Please copy the private key from the .pcks8 file, e.g., "jira_privatekey.pcks8" (Refer to Jira help article)
- Click on Get Auth Token it will navigate to the Jira server and ask for authorization Allow it.
- Once navigated back to Kendis click on Test Connection & map fields.
- 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 authentication screen and users need to authenticate with their Jira credentials on the Jira login page.
- Please note, the user doesn't need to give any keys, etc that was needed for ALM creation. So they simply need to authorize their Jira account.
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.