Atlassian OAuth 2.0

Owned by Danil Chernovalov (Unlicensed)
Last updated: Nov 17, 2021
3 min read

Registered users can access the virtual assistant with their Jira credentials. This page describes how to enable such functionality in your Koji.

 

Key points

To configure the Atlassian OAuth 2.0 functionality:

  1. Set the permissions in Jira

  2. Set the bot end point

  3. Retrieve Client ID and secret

  4. Update Kbot configuration

  5. Configure an application in Kbot

As the result, registered users will be able to access the virtual assistant with their Jira credentials:

Setting the permissions

1. Open the Atlassian Developer Console.

2. Select an app from the list.

3. Click Permissions on the left side of the window. Now you can view the list of permissions, add and configure them.

4. Add and configure the following permissions:

User REST API

Required scopes:

  • View user profiles

Jira Service Desk API

Required scopes:

  • View Jira Service Desl requres data

  • Create and manage Jira Service Desk requests

User identity API

Required scopes:

  • View user profile (profile details for the currently logged-in user)

  • View user profile (view user profiles)

Setting the bot end point

1. Click Authorization on the left side of the window.

2. Click Configure.

3. In the Callback URL field, enter the URL of the following type:

  • https://your-kjira-instance.konverso.ai/oauth2/jira/callback/

Make sure to change the your-kjira-instance part from the sample above.

Retrieving Client ID and secret

1. Click Settings on the left side of the window.

2. In the General settings area, enter the app name, set the avatar, and add the description.

3. In the Authentication details area, copy Client ID and Secret. You need these values to modify your Kbot configuration.

Updating your Kbot configuration

Make sure that the configuration file conf\kbot.conf on your host includes the following lines:

jira_oauth2_client_id = <client ID> jira_oauth2_client_secret = <secret> jira_oauth2_scope = read:me offline_access read:servicedesk-request write:servicedesk-request jira_oauth2_user_name_attribute = account_id

Configuring an application in Kbot

1. On your Kbot host, go to Configuration > Applications.

2. Find an application you want to provide with the Atlassian OAuth 2.0 functionality and click Modify.

3. Select Log in with Jira (Cloud) from the list of providers.

4. Click Save.

What’s next?

Now registered users can access your virtual assistant with their Jira credentials. If they are associated with multiple sites, they are offered to select one from the list.

Â