For the Jira family of products where your organization is hosting the software, e.g. Jira Server or Jira Data Center.
This applies to Jira, Jira Service Management and Jira Software where your organization is hosting Jira. It does not apply to Jira products running in Atlassian Cloud. In this case, please see the Atlassian Cloud integration for Trelica instead.
Generate an RSA public/private key pair
Run the following openssl commands in a terminal window. You can do this anywhere in your file system, but note that this is where the files will be created.
Generate a 1024-bit private key:
openssl genrsa -out jira_privatekey.pem 1024
Create an X509 certificate. You will be prompted for various bits of information. Fill this in as best you can, although the specific details are not particularly important.
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
Extract the public key from the certificate to the
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
Create an application link
In Jira, navigate to Jira settings (cog icon) > Applications > Application links.
In the Enter the URL of the application you want to link field, enter the URL
http://app.trelica.com/, and then click Create new link.
Ignore the warning about the Application URL redirecting, click Use this URL and click Continue.
On the first screen of the Link applications dialog, enter
Trelica as the Application Name. You can ignore the other fields. Make sure that Create incoming link is unchecked.
Click Continue. A message will appear confirming that the link has been created successfully.
Edit the application link
Find the new link in the list, and click the Edit (pencil) icon to edit the link:
Select the Incoming Authentication tab.
TrelicaOAuthKey as the Consumer Key and
Trelica as the Consumer Name:
Scroll down to the Public Key field. Paste in the contents of the
jira_publickey.pem file that you created earlier. You should include the whole of the file 'as-is', including the header and footer lines (
-----BEGIN PUBLIC KEY----- and
-----END PUBLIC KEY-----).
Also enter in the Consumer Callback URL as:
Finally scroll down further to and click the Save button:
Make sure you connect to the Jira (Self-Managed) integration (not Atlassian Cloud).
Enter the base URL for your installation, the Customer Key and also the contents of the private key PEM file that you created earlier.
Creating Jira Service Management tasks
The Trelica workflow system can synchronize Trelica tasks with Jira Service Management.
If you're running a self-managed version of Jira Service Management, then you must install a small Jira plugin in order for Trelica to receive notifications when a Jira Issue is marked as complete.
To do this go to Manage apps in the administration menu:
Now choose Manage apps in the side-menu, and click Upload app:
Cut and paste this URL into the From this URL field in the dialog that opens:
Click Upload and you should see a message confirming that the plugin is installed.
If you install the plugin after you've synchronized tasks from Trelica you may need to re-index your data. Please go to Administration > System > ADVANCED > Indexing in Jira and click Re-index. We recommend using the Background re-index option.
Please sign in to leave a comment.