Creating the Public and Private Keys
Application Links in Jira use a public/private key to sign requests from the client application (AMP). Follow the instructions provided by Atlassian for creating the private and public keys. These will be needed to set up the Jira application link in the next step, as well as in the organization configuration in AMP. A summary of these steps is provided below:
- Open the terminal and CD to the directory where you wish to save the private and public key files.
openssl genrsa -out jira_privatekey.pem 1024
- When prompted enter the following:
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
When this line is run you will be prompted for some information such as your country and your email address. The only part that is important is the value entered for:
Common Name (eg, fully qualified host name) :
Please enter the fully qualified domain name for your AMP instance.
- Enter the following:
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
- Finally, enter the following in the terminal:
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
- On your desktop file system, navigate to the directory selected to save the files. There should be four files, including the following two files which will be used to setup the application link and configure the AMP organization connection to Jira:
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, a Jira system administrator must configure an application link for AMP and share relevant information with the AMP admin who is configuring the integration. Atlassian provides documentation for creating Application Links here https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-oauth-authentication/
Level Access provides a summary of these steps below (NOTE: Wording could be different depending on your version of JIRA, as internally-hosted instances may be on older versions. Step 4 especially, can have variability, specifically with regard to using 'Application Name'/'Application Type' vs 'Consumer Name'/'Consumer Key'):
- Login to the JIRA instance as a user who administrator access.
- Choose the gear icon in the upper right.
- Select the “System” option from the submenu.
- Reenter your admin credentials if prompted.
- Choose the “Applications” tab on the resulting page.
- Select “Application Links” from the left-hand navigation.
- Enter you AMP instance’s URL in the Configure Application Links for on the resulting page.
- Press “Continue” if a “No response was received” warning is shown. This warning can be disregarded in the AMP/JIRA configuration process.
- Ensure the “Create incoming link” checkbox is checked and enter the AMP application name on the following screen. The other fields are optional for AMP integration.
- Enter values for the “Consumer Key” and “Consumer Name”. These can be any values, but we have used the FQDN for the AMP instance. Copy the contents of the jira_publickey.pem file into the “Public Key” field.
- Press the “Continue” button.
- You will be redirected to the “Configure Application Links” page with the newly created Application Link listed.