1.1. Adding an application link between your Jira and Confluence instance

Goal

This section contains the instructions to add an application link to Confluence in your Jira instance. This is required for using Confluence spaces in Gaia templates.

If you already have an application link set up between your Jira and your Confluence instances, then you don't need to follow this tutorial.

Pre-requisites

This tutorial was written considering that:

• you have a Jira instance installed and running on your server;
• you have a Confluence instance installed and running on your server;
• you have administrator rights on that Jira instance;
• you are logged in your Jira instance.

Adding an application link to Confluence in your Jira instance

1. In Jira, click the "Applications" option from the "Jira Administration" dropdown menu:

Find the administration menu icon on the upper right side of your screen. Once you click on it, select the "Applications" option.

2. Go to the "Application Links" section :

From the menu on the left side of the screen, find the "Integrations" section, click on "Application links".

By default, you should have no application links in your system :

3. Create a link to your Confluence instance:

Enter the URL of your Confluence instance and click the "Create new link" button. Use the format http[s]://0.0.0.0:0000/[confluence].

• 0.0.0.0 being the IP address or domain name to your Confluence server
• 0000 being the port Confluence's application server run through (by default it should be 8090). 

If you don't know the IP or the domain name for your Confluence server, check the address bar in your browser when you first connect to Confluence.

4. Configure the application link in Jira:

If you use a single authentication server (e.g.: Crowd) for all of your Atlassian's applications, check the "The servers have the same set of users and usernames" box. You can also check the "I am an administrator on both instances" box if that is the case. Once you're done, click on "Continue".

5. Configure the application link in Confluence:

You should be redirected to your Confluence instance for further authentication. On the Confluence side, you should see the same dialog opening up to confirm you want to link both together. Click on "Continue".

6. The new application links is now listed:

In Jira, the application link is listed under "Jira Administration", "Applications", "Integration", "Application links".

In Confluence, the application link is listed under "Confluence Administration", "General Configuration", "Administration", "Application Links".

7. Confirm that the "Outgoing" and "Incoming" connections are configured:

Make sure the "Outgoing Authentication" and "Incoming Authentication" of the application links are configured in Jira and Confluence.

In Jira:

In Confluence:

What's next

You can add as many application links as you want. If you have more then one Confluence application link and you want to use a template that needs Confluence, you will be asked to select the right application link when creating a project with Gaia (see 14812599).