All Collections
Tools SDK
Authenticate Tools in Jira
Authenticate Tools in Jira

Instructions for how to authenticate Tools built using Glean's Jira template

Vivek Choksi avatar
Written by Vivek Choksi
Updated this week

Set up the integration user

  • Select a user whose Jira account will be used to set up the integration between Glean and Jira. This account must have Modify Reporter permissions in Jira.

  • To grant this account Modify Reporter permissions, do the following:

    • Log into Jira as an Administrator.

    • In Jira’s settings page, click the Issues menu.

    • Scroll down and select the “Permission schemes” menu and select the permission scheme corresponding to your project

    • Add the user to ‘Modify Reporter’ permissions by clicking ‘Update’ > ‘Single user’ > Select the integration user > Update

    • Add the user to ‘Create Issues’ permissions by clicking ‘Update’ > ‘Single user’ > Select the integration user > Update

    • Add the user to ‘Assign Issues’ permissions by clicking ‘Update’ > ‘Single user’ > Select the integration user > Update

Create the Jira OAuth app

  • Navigate to the Atlassian Developer Console at this link and create a new app of type: OAuth2.0 Integration.

  • Follow the prompts to set up the app. Make note of details like the app name, description, and logo.

Configure the callback URL

  • Go to the Authorization tab of your app configuration.

  • Using the unique Tool identifier in Glean’s Tool creation page, set the callback URL to the following: https://{domain}-be.glean.com/tools/oauth/verify_code/{uniqueToolIdentifier}.

Set permissions

  • In the Atlassian Developer Console, navigate to the Permissions tab

  • Add the following scopes:

    • Jira API - write:jira-work, read:jira-user

Configure the app on Glean

  • Fill the following fields in the Glean Tool setup page:

  • Complete authentication

    • Save the tool's settings to confirm the configuration

    • Click on the authorization link provided to complete the OAuth flow. Once authorization is complete, you should see a message “Authorized <tool name>”

Did this answer your question?