Set up a Jira service account for the main authorized user

Owned by Megan Storie
Last updated: Aug 15, 2024 by Michelle Ruoff
2 min read

Overview

This article explains how to set up a Jira service account to:

  • be used as the main authorized user (MAU).

  • help prevent potential issues when connecting to a specific employee account as the MAU.

  • limit access to the main user via Jira configuration. (The main user is the user who initially connected your bot in Slack to your Jira instance, and can be changed from the Account Portal.)

  • Integration + automatically respects users' Jira permissions.

  • There are also settings you can use to limit access via configuration.

 

 

Permission requirements for Integration+

  • Jira Permissions: The main authorized user (MAU) needs the following permissions to create a connection to the APIs. Individual users do not need these permissions:

    • Jira Administrator Access: Jira Administrator access allows users to manage Jira settings, users, and permissions.

    • JSM Agent Role: MAUs must have the JSM Agent role for each selected service desk. Agent roles are not required for Jira software projects.

    • JSM License: A valid Jira Service Management (JSM) license is required for integration functionality.

Atlassian occasionally requires additional authentication from users when the main user is altered. This behavior is tied to the functioning of OAuth keys within the APIs and falls outside our sphere of control. Should your instance exhibit this behavior, users will be prompted to re-authenticate during their next action.

 

 

 

How to set up a Jira service account

  1. Create a Jira account with admin access.

  2. Check Permissions Schemes for the following:

    • Browse Project

    • Create Issue

    • Comment on Issue

    • Edit Issue

    • Transition Issue

    • Add Attachment

  3. Add the service account to the relevant Project Role (usually Service Desk Team) in each project to ensure it has access to perform all actions.

  4. Log in to Jira with the new user.

  5. Navigate to https://account.ne xtup.ai in the same browser.

  6. Scroll to the Main authorized user.

  7. Click Change.

  8. Ensure you are logged into Jira as the new account, then click Allow.

 

 

Â