-
Bug
-
Resolution: Fixed
-
Low
-
7.4.13, 7.13.20
-
8.18
-
2
-
Severity 3 - Minor
-
3
-
Issue Summary
The Advanced Roadmaps for Jira in Confluence macro added to a Confluence page fails to load a Roadmap from a Jira On-prem instance if there is a mismatch in the Application URL used in the AppLink and the URL from the Roadmap Link.
The issue only affects versions 1.2.0 and above of the app Advanced Roadmaps for Jira in Confluence.
Steps to Reproduce
Tested on Confluence 7.4 and 7.13 linked to a Jira 8.18 instance:
- Install Jira 8.18.
- Install Confluence 7.4 or 7.13.
- Create an Application link between them using the same URL as Application URL and Display URL:
- In the tests performed, it was http://localhost:8080
- Install the Advanced Roadmaps for Jira in Confluence app (version 1.1.0) on Confluence.
- Add an Advanced Roadmaps macro to a Confluence page and link it to a valid Roadmap from Jira.
- If the URL from the Roadmap Link and the Application URL from the AppLink match (see example below), the macro works as expected
:
- Application URL from the AppLink Confluence->Jira: http://localhost:8080/
- Roadmap Link: http://localhost:8080/secure/PortfolioRoadmapConfluence.jspa?r=1hFAg
- Edit the AppLink and change the Application URL to a different but valid URL such as http://127.0.0.1:8080 (which points to the same location as localhost, in this case).
- Check the page where the macro was added and it is still working as expected.
- Update the app to version 1.2.0 or higher.
- Check the page where the macro was added and it is no longer working as expected.
- This is due to a mismatch in the URL from the Roadmap Link and the Application URL.
- Application Link Confluence->Jira, Application URL: http://127.0.0.1:8080/
- Roadmap Link: http://localhost:8080/secure/PortfolioRoadmapConfluence.jspa?r=1hFAg
- If you replace localhost in the Roadmap Link above with the IP address we are using on this example, the macro starts working again.
Expected Results
The Roadmap would be displayed on the Confluence page.
Actual Results
The message below is displayed instead:
Error rendering macro 'portfolio-for-jira-plan'
It looks like you've entered a URL to a Jira that is not connected to Confluence. Contact your administrator to configure an Application Link
Additional Notes
If we go back to the Release Notes for Release Notes for v1.2.0 of this app, we can see the following:
Note to administrators: This new version pulls Advanced Roadmaps data from Jira using Application Links. To ensure a smooth upgrade, please make sure that the Application Link between your Confluence and Jira servers is set up. If you update to the new version without this connection, your Macro might not work as intended
We have some cases where customers set an AppLink between Confluence and Jira using different URLs for Display URL and Application URL.
This is done, for example, when setting an unproxied application link. Usually, the Display URL will match the Base URL for the Jira instance, which is not the same URL set for the Application URL.
When generating the Roadmap Link on Jira, it will use the Base URL as a reference.
Workaround
The user can use one of the following workarounds:
- Downgrade the app Advanced Roadmaps for Jira in Confluence to version 1.10, as long as you are running a Confluence version compatible with it; or
- Set the Application URL in the AppLink to be equal to the Display URL, if possible; or
- When adding the Roadmap Link to the macro on a Confluence page, manually change the URL to use the Application URL from the AppLink (see step 10 in the Steps to Reproduce section).