AMP bug tracker: Set up a Jira connection using OAuth 2.0

To track AMP bugs using your Jira instance, you'll need to integrate AMP with Jira.

You must be an AMP administrator and a Jira administrator to set up the Jira connection.

On this page:

• Create and configure the Jira application
• Integrate AMP and Jira
• Map Jira projects to AMP

Create and configure the Jira application

In order to use AMP with Jira, you must create an application for AMP in Jira. You can do this through the Atlassian Developer Console for Jira Cloud or the Jira Administrator dashboard of your installed Jira Data Center and Server for on-premise.

Create a Jira Cloud application

You'll need access to the Jira Developer console to create a Jira Cloud application.

To create a Jira Cloud application:

1. Go to the Developer console in Jira.
2. From the account dropdown, choose My apps.
3. Select Create and choose OAuth 2.0 integration from the dropdown.
4. Name your application. For example "AMP Jira integration".
5. Check the box to agree to the terms.
6. Select Create.

Configure the Jira Cloud application settings

To configure the Jira Cloud application, you need to update the distribution, permissions, and authorization settings.

Update the distribution settings

To update the distribution settings:

1. Go to Distribution.
2. Select Edit.
3. Fill in the fields:
   • Distribution Status: Choose Sharing.
   • Vendor Name: Enter "Level Access".
   • Privacy Policy: Enter the URL of Level Access’s privacy policy: https://www.levelaccess.com/privacy-policy/.
   • Does your app store personal data?: Choose No.
4. Select Save changes.

Update the permission settings

To update the permission settings:

1. Go to Permissions.
2. Find Jira API and select the Add button. Select the same button again when it changes to Configure.
3. For Jira platform REST API, select Edit Scopes.
4. Check the boxes for View Jira Issue Data and Create and manage issues.
5. Select Save.

Update the authorization settings

To update the authorization settings:

1. Go to Authorization.
2. Under Authorization type, choose Add for OAuth 2.0.
3. Enter the URL for your AMP instance using this format "https://amp.levelaccess.net/api.issuetracker/user/oauth2/setSession" into the Callback URL field.
4. Select Save Changes.

Copy and save the Client ID and Secret

Finally, you'll need to save the Client ID and Secret from Jira to enter into AMP.

To find the Client ID and Secret:

1. Go Settings.
2. Copy and paste the Client ID and Secret in a word processor or note app. You'll need them in step 4 of the section Integrate AMP and Jira.

Create and configure a Jira application using Jira Data Center and Server

To create and configure a Jira application using Jira Data Center and Server:

1. Go to Administration in Jira.
2. Under Applications, choose Application links.
3. Select Create link.
4. Fill in the fields:
   • Application type: Choose External application.
   • Direction: Choose Incoming.
5. Select Continue.
6. Fill in the fields:
   • Name: Enter a name for the integration.
   • Redirect URL: Enter the URL for your AMP instance.
   • Permission: Choose Write.
7. Select Save.
8. Copy and paste the Client ID and Secret in a word processor or note app. You'll need them in step 4 of the section Integrate AMP and Jira.

Integrate AMP and Jira

Once the application is set up in Jira, the next step is setting up the integration in AMP.

You must be an AMP Organization or System Administrator to set up the integration.

To integrate AMP with Jira:

1. Go to Administration.
2. Select Create Bug Tracking Integration.
3. Choose Atlassian JIRA - OAuth 2.0 and select Create Integration.
4. Fill in the fields:
   • Jira Site Address: Enter the URL of the JIRA instance.
   • Jira Client ID: Paste the client ID from Jira. 
   • Jira Client Secret: Paste the client secret from Jira.
5. Select Validate.
6. Once validation is complete, select Submit.

Map Jira projects to AMP

Once you've integrated AMP and Jira, you'll need to map the Jira projects where you want to send AMP bugs.

To map Jira projects:

1. Go to Administration.
2. Select Bug Tracking Integration.
3. Choose Update Project Mappings.
4. Select Please authorize AMP to use your JIRA.
5. Choose Allow. This allows AMP to use OAuth to integrate with JIRA.
6. Select Update Project Mappings.
7. Choose the Jira project(s) that you'd like to connect with AMP and select Next.
8. Expand each Jira project and choose each issue type AMP can create in this Jira project.
9. Select Next.
10. For each project:
    1. Select the Include checkbox for the Jira fields you'd like to map (Summary is required).
    2. Use the dropdown to select the AMP field(s) you'd like to map to the Jira field.
11. Select Submit.