Custom Jira Charts for Confluence

Server - Application Link Set Up

Owned by Old Street Apps
Last updated: Jan 24, 2023 by Morgan Folsom
3 min read

Custom Jira Charts for Confluence on Server requires OAuth (impersonation) to be enabled to access Jira data. This application link type is required to use Custom Jira Charts for Confluence. This is required because it ensures that user information matches between Jira and Confluence. If a user’s information is even slightly different in Jira and Confluence, the charts will not work for them. If OAuth (without impersonation) is used, some or all users in your Confluence instance may be unable to view Custom Charts.

If you have two Jira instances connected to Confluence only the Primary Jira instance will be used.

For more information on the difference between OAuth and OAuth (Impersonation), see this article from Atlassian: https://confluence.atlassian.com/applinks/oauth-security-for-application-links-774045732.html

Step 1: On Confluence, as an administrator, navigate to General configuration → Application Links.

Step 2: Edit the Jira application link and set both Outgoing and Incoming local authentication methods to OAuth (impersonation).



Step 3: Save changes once both authentication options have been updated.





Step 4: When both Outgoing and Incoming local authentication methods have been set to OAuth (impersonation), navigate to Jira Application Links (using the link under Remote authentication) and perform the same actions again on the reciprocal link from Jira.

Note: The CONFIG ERROR status is expected because you haven't yet updated the reciprocal link from Jira to Confluence.



Step 5: Save changes once both local authentication options have been updated.



Once both application links have been updated on Jira and Confluence you should see the status return to Connected

 

And that's it! You can return to your Confluence page and start using the Custom Jira Charts for Confluence macro 

If you need any more help getting started with the Custom Jira Charts for Confluence macro check out our User's Guide or raise a support ticket so someone on our team can help you.