Creating an Application Link between Atlassian Products results in a warning about

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

When attempting to create an Application Link between Atlassian Products that are bundled with Applinks v10, a warning message is shown on the UI like the following example:

The remote application, '<APPLICATION_NAME>', is running an older version of the Application Links plugin. It will not be possible to create the remote end of the link from this application. However both ends of the link can be created using the older process in '<APPLICATION_NAME>'.

ℹ️<APPLICATION_NAME> refers to the value of the Application Name field that was entered during the configuration.

(Auto-migrated image: description temporarily unavailable)

Environment

Creating or editing an Application Links plugin with the following products as the target:

  • Jira v10 and above

  • Confluence v9 and above

  • Bitbucket v9 and above

  • Bamboo v10 and above

The source product is on a version that is NOT listed below:

Jira Software

Jira Service Management

Confluence

Bitbucket

Bamboo

Crowd

Fisheye/Crucible

9.4.25+

9.12.12+

9.17.1+

10.0.0+

5.4.25+

5.12.12+

5.17.1+

10.0.0+

7.19.25+

8.5.12+

8.9.4+

9.0.1+

8.9.15+

8.19.4+

9.0.0+

9.2.15+

9.6.3+

10.0.0+

5.11.1+

5.2.6+

5.3.2+

6.0.0+

4.8.16+

4.9.0+

Diagnosis

A warning will be recorded in the source product's application log, like the following example:

1 2024-07-15 15:44:58,901+1000 JIRA-EventThread-3776 WARN [c.a.a.internal.capabilities.DefaultRemoteCapabilitiesService] Exception trying to get Applink for manifest with ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Cause

This issue is due to a bug in the Applinks included with each product, which prevents it from correctly parsing the Applinks version from the target product's Applinks manifest. During creation or update, there will be a request to the target product to obtain the manifest:

1 <Base_URL>/rest/applinks/1.0/manifest

An example of the response would be:

1 2 3 4 5 6 7 8 9 <manifest> <id>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</id> <name>Confluence with AppLink v10</name> <typeId>confluence</typeId> <version>9.0.0-beta3</version> <buildNumber>21111</buildNumber> <applinksVersion>10.0.13</applinksVersion> ... </manifest>

Solution

This is the compatible product versions for Application Link if you have any one of the products using Applinks v10:

Jira

Confluence

Bitbucket

Bamboo

Fisheye/Crucible

9.4.25+

9.12.12+

10+

7.19.25+

8.5.12+

8.9.4+

9+

8.9.15+

8.19.4+

9+

9.2.15+

9.6.3+

10+

4.8.16+

4.9.0+

Workaround

The workaround steps mentioned below assume the following example scenario:

Application

Version

Applinks version

Jira

9.12.11

9.0.15 (affected by the bug)

Confluence

9.0.0

10.0.13

From Jira (where the warning is observed)

  1. Create an Application Link with the Confluence URL and then click on Continue in the warning dialog

    • This creates a one-way application link only from Jira, with CONFIG ERROR in the status

  2. Edit the Application Link and manually set both Outgoing/Incoming to the desired Authentication Methods:

    • OAuth

    • OAuth (impersonation)

  3. Click Save changes

From Confluence (which, as per the above example, bundles the newer version of the Application Links plugin)

  1. Create an Application Link with the Jira URL and click on Continue

  2. You'll be redirected to Jira and see the following warning:

    An Application Link to this URL '<Confluence_URL>' has already been configured.

  3. Click Continue to redirect back to Confluence

  4. Edit the Application Link in Confluence to make sure both Outgoing/Incoming is set to the desired Authentication Methods (these must match what's configured on Jira):

    • OAuth

    • OAuth (impersonation)

  5. Click Save changes

The Application Link Status  should show Connected on both applications once all steps are completed.

Updated on April 17, 2025

Still need help?

The Atlassian Community is here for you.