Adding an Application Link Between Your Jira and Confluence Instance

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.

Adding an application link to Confluence in your Jira instance

Warning

Make sure your Jira instance has a unique name. This is essential to link Jira issues in your Confluence pages upon creation. The Jira server name must be the same as the application link name.

To do this configuration, you must have Admin permissions in Jira.

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

2. Go to the Integrations section → 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.

Need for an administrator

If you cannot find the URL of your Confluence instance, please ask a system administrator for help.

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 are now listed:

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:

You're done!

For best result, we recommend that your Jira and Confluence "Outgoing" and "Incoming" authentication be set to OAuth (impersonation).

You can review Atlassian's "Integrating Jira and Confluence" documentation here.

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.