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

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

On this page:

• Set up public/private keys
• Configure the Jira application link
• Integrate AMP and Jira
• Map Jira projects to AMP

Set up public/private keys

Application links in JIRA use a public/private key to sign requests from the client application
(AMP).

To generate keys for AMP:

1. Run the four lines below from a bash shell.

   • openssl genrsa -out jira_privatekey.pem 1024
     openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
     openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
     openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem

2. When prompted, enter the fully qualified domain name for your AMP instance into the common name field. The rest of the fields are optional.
3. Save the files on your desktop system. Use the following files to setup the application link and configure the AMP organization connection to Jira: 
   • jira_privatekey.pem
   • jira_publickey.pem

Configure the Jira application link

Jira requires users to configure an application link to any applications they wish to integrate with
the Jira instance. In order to use AMP for Jira, you must configure an application link for AMP.

You must be a Jira administrator to create the application link.

Set up application link for OAuth 1.0

1. Log in to the JIRA instance.
2. Select the gear icon in the top navigation and choose Products from the dropdown.
   • Note: You may need to reenter your admin credentials.
3. Choose Application Links.
4. Select Create link.
5. Choose Direct application link and enter your AMP URL.
6. Select Continue. 
   • Note: Choose Continue again if you receive a “No response was received” warning. You can disregard this warning.
7. Fill in the following fields:
   • Application Name: Enter "AMP" as the application name.
   • Application Type: Choose Generic Application from the dropdown.
   • Create incoming link: Check this box.
8. Select Continue.
9. Fill in the following fields:
   • Consumer Key: Can be any value. Note this value, you'll need it in the next section.
   • Consumer Name: Can be any value.
   • Public key: Paste the contents of the jira_publickey.pem file.
10. Select Continue. Your newly created application link will show on the page.

Integrate AMP and Jira

Once the application link 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 1.0 (Existing implementation) and select Create Integration.
4. Fill in the fields:
   • Jira Site Address: Enter the URL of the JIRA instance.
   • Jira Consumer Key: Enter the consumer key you created in step 9 of the previous section. 
   • Jira Private Key File: Attach the private key file noted in the set up public/private keys section.
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 again.
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.