Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Registered users can access the virtual assistant with their Jira credentials. This page describes how to add such a button for your Koji.

Key points

To configure the Atlassian OAuth 2.0 functionality:

  1. Set the permissions

  2. Set the bot end point

  3. Retrieve Client ID and secret

  4. Update Kbot configuration

  5. Add 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.

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, set the app name, avatar, and 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 your kbot.conf includes the following:

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

Adding 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.

  • No labels