Skip to main content

Jira Scope-Based API Authentication for Individual Users

Configure your personal Jira Scope-Based API token and update your Kendis profile to enable secure user-level authentication.

Written by Kendis Team
Updated over a week ago

Once your organisation’s Main ALM Account has been configured by an administrator, each user must connect their own Jira profile using a Scope-Based API Token.

This guide explains how individual users can:

  • Create their own Jira Scope-Based API Token.

  • Ensure the correct scopes are selected.

  • Update the token inside their Kendis profile.

  • Validate the connection.

Let’s Set It Up

The main ALM integration is configured once by an administrator.

However, because Jira Scope-Based authentication works on a per-user level, every user must:

  1. Generate their own Scope-Based API Token.

  2. Update it in their Kendis Profile settings.

Without completing this step, the user’s Jira access will not function correctly inside Kendis.

Step 1: Create a Scope-Based API Token in Jira

Each user must generate their own API token from their Atlassian account.

Access Your Atlassian Account

Log in to Jira.

Click your Profile icon (top-right corner).

Select Manage Account.

Switch to the Security tab.

Scroll to the API tokens section.

Click Create and manage API tokens.

Create API Token with Scopes

Click Create API token with scopes.

Enter a descriptive name (e.g., Kendis User Scope Token).

Set the expiry date (choose the maximum duration allowed).

Click Next.

Select Jira as the App

From the list of apps, select Jira.

Click Next.

Select Required Jira Scopes

Search and select the following permission names:

Delete

delete:async-task:jira

delete:attachment:jira

delete:avatar:jira

delete:board-scope.admin:jira-software

delete:build-info:jira

delete:cmdb-attribute:jira

delete:cmdb-object:jira

delete:cmdb-schema:jira

delete:cmdb-type:jira

delete:comment:jira

Read

read:project:jira

read:board-scope:jira-software

read:epic:jira-software

read:sprint:jira-software

read:jira-work

read:jira-user

Write

write:epic:jira-software

write:sprint:jira-software

write:jira-work

Manage

manage:jira-project

After selecting all required scopes:

  • Click Next.

  • Review the scopes.

  • Click Create token.

Copy the API Token

  • Click Copy.

  • Save the token securely (password manager recommended).

⚠️ This token will not be visible again after closing the window.

Step 2: Update API Token in Your Kendis Profile

After generating your Scope-Based API Token, update it inside Kendis.

Open Your Profile Settings

Click your Profile menu in Kendis.

  • Select Profile.

  • Navigate to ALM Credentials.

Update the Token

  • Click Edit.

  • Click Change next to Password/API Token.

  • Make sure Using Scope API is checked.

  • Paste your newly generated Jira Scope-Based API Token into the field.

  • Click Test Connection.

If successful, your profile is now connected using Scope-Based authentication.

After completing these steps, your Jira access is securely authenticated and your permissions align with the configured scopes.

Did this answer your question?