Jira (Self-managed)

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.

Configure Jira

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 jira_publickey.pem file:

openssl x509 -pubkey -noout -in jira_publickey.cer  > jira_publickey.pem

In Jira, navigate to Jira settings (cog icon) > Applications > Application links.

The Application links menu

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.

Create new application 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.

Link applications dialog

Click Continue. A message will appear confirming that the link has been created successfully.

Find the new link in the list, and click the Edit (pencil) icon to edit the link:

Select the Incoming Authentication tab.

Enter 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:

Configuring Trelica

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.

Was this article helpful?

0 out of 0 found this helpful



Please sign in to leave a comment.