#Connect an Application for Jira

To connect an application for Jira, complete the following configurations.

#Step 1: Create an API token in Jira

Follow the steps below to create an API token:

1. Sign in to Jira.

2. Click your profile picture in the upper right corner and select Account settings.

   

3. Navigate to the Security tab and click Create and manage API tokens link in the API tokens section.

   

4. Click Create API token.

   

5. In the Create an API token window, enter a token name, configure the expiration date and click Create.

   

6. After the API token is created, click Copy in the in the Copy your API token window. Then, paste and securely store it in a safe location.

#Step 2: Get the host URL

Copy the Host URL from the Jira website URL: https://your-sub-domain.atlassian.net.

#Step 3: Grant permissions to your account

Your account must have necessary permissions to perform Jira backup and restore operations. For details on how to grant permissions, refer to the following instructions.

#Grant Global Permissions

Global permissions can only be assigned to groups. Ensure the user you wish to include in the app connection is one of a member of a group that possesses the necessary permissions.

Follow the steps below to grant global permissions:

1. Sign in to Jira.

2. Click the Settings button and select System.

   

3. On the System page, click Global permissions on the left navigation pane.

4. In the Grant Permission field, select the required permissions and groups to assign.

   

   • Permissions required for backup:

     • Administer Jira

     • Browse users and groups

   • Permissions required for restore:

     • Administer Jira

     • Browse users and groups

     • Share dashboards and filters

     • Create team-managed spaces

#Grant Project Permissions

Follow the steps below to grant project permissions:

1. Sign in to Jira.

2. Click the Settings button and select Spaces.

   

3. On the Manage Spaces page, locate your space, click the More actions button, and click Space settings.

   

4. On the Space settings page, click Permissions on the left navigation pane.

5. Click Actions and select Edit permissions.

   

6. Click Grant permissions to assign permissions as needed.

   

   • Permissions required for backup:

     • Administer Projects

     • Browse Projects

     • Manage Sprints

   • Permissions required for restore:

     • Administer Projects

     • Browse Projects

     • Manage Sprints

     • Assign Issues

     • Create Issues

     • Edit Issues

     • Link Issues

     • Modify Reporter

     • Resolve Issues

     • Schedule Issues

     • Transition Issues

     • Manage Watchers

     • Add Comments

     • Create Attachments

     • Work on Issues

#Step 4: Create an application connection in AvePoint Online Services

Follow the steps below to create an application connection in AvePoint Online Services:

1. In AvePoint Online Services, navigate to Management > App management > Application connection, and then click Create on the action bar.

2. In the Create application connection panel, complete the following settings:

   • Profile name – Enter a name for your connection profile.

   • Description – Enter a description for the connection for future reference. This field is optional.

   • Select application – Select Jira from the drop-down list.

   • Host URL – Enter the URL copied from Jira: https://your-sub-domain.atlassian.net.

   • User email – Enter the email address associated with your Jira account. Make sure your account has been granted the required permissions mentioned in Step 3.

   • API token – Enter the API token copied from Jira.

3. Click Save.

Once you have created the connection profile, it will appear on the Management > App management > Application connection tab. Your application will now be connected. If needed, you can select a connection profile to Edit or Delete it.

#Allow API token access for external users

To allow user API token access:

1. Go to Atlassian Administration. Select your organization if you have more than one.

2. Select Security > User security > External users.

3. Choose API token access for external users.

4. Select Allow.

5. Click Update to save your changes.