This guide explains the administrative steps required to create a token-based connection between Kendis and your Jira Server instance using the OAuth 2.0 authorization code.

Prerequisites: Jira Administrator rights are required.

Authentication Type: OAuth 2.0 is used for secure, user-based synchronization.

Configuration Steps

Establishing this secure connection involves three primary configuration steps that integrate Kendis and Jira.

Best Practice: To maintain workflow efficiency, open your Jira administration panel and Kendis ALM settings in two separate tabs. This prevents losing your progress on the Kendis screen.

I. Set Up the ALM Account and Retrieve the Callback URL

This step initiates the connection in Kendis and obtains the unique redirection URL required for Jira.

Locate the Settings Menu: On the left navigation bar in Kendis, click the Settings Menu Item.
Open ALM Accounts: From the Settings configuration submenu that appears, click on "ALM Accounts".
Add New Account: Click the "+ Add ALM Account" button in the top right corner.

Configure Connection Details:

ALM Type: Select Atlassian JIRA.
Enter Account Name: Provide a descriptive account name (e.g., Jira - Core Banking).
Select Authentication: Scroll down and select the button for Jira Server → Use OAuth 2.0.
Copy Callback URL: The unique URL will be displayed in the Callback URL field. Click the "Copy URL" button.

Please keep this Kendis configuration screen open. You will return to it in Step 3 to paste the credentials.

II. Log In to Jira Server and Create a New Application Link

The next step is to access the Application Links settings in Jira to configure the incoming connection for Kendis, paste the Callback URL, and generate the required Client ID and Client Secret.

Access Application Link Setup

Log In to Jira: Open your Jira Server's base URL and log in with your administrator credentials.
Access Applications: Click the Settings Icon in the top-right corner, and select "Applications" from the dropdown menu.
Access App Links: In the Administration sidebar, under INTEGRATIONS, select "Application links".
On the Application links page, click "Create link".
Select Application Type and Direction to create a link:
- Application type: Select "External application".
- Direction: Select "Incoming" (Kendis accesses data from Jira).
Click "Continue" to proceed to the configuration screen.

Configure the Link

Enter Link Details.
- Name: Enter a unique name (e.g., Core Banking).
- Redirect URL: Paste the exact Callback URL you copied from Kendis in the first step.
Set Application Permissions:
- Click the Permission dropdown menu.
- Select "Admin" from the list. (Selecting Admin ensures Kendis receives the necessary scopes to view, create, update, and manage all program-level work and configurations.)
Click "Save" to complete the configuration settings.