Troubleshooting: Insight/Assets Confluence Object Attribute is unable to locate the desired Confluence Page/space
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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
JSM Insight/Assets come equipped with an attribute type called Confluence, which allows you to link a Confluence page with an object. It is important to note, however, that in order for the Confluence Asset attribute to function as intended, the Application link between Jira and Confluence must be properly configured. Failing to do so will result in an inability to locate the desired Confluence pages.
Environment
4.15.0 and above
Cause
When Jira and Confluence use "OAuth" authentication type for Application links without manually authorizing it, we won't be able to find the Confluence pages linked with Asset Attribute. If there are any pages already linked, then we will find the below errors in the atlassian-jira.log
:
2023-07-03 12:49:04,691+0000 http-nio-8080-exec-1748 ERROR hv061 769x5428585x1 11dk9999 10.1.1.1,10.1.1.1 /rest/insight/1.0/object/ITSM-123456 [c.r.j.p.i.services.confluence.ConfluenceIntegrationServiceImpl] Could not retrieve space with key ABC! com.atlassian.applinks.api.CredentialsRequiredException: You do not have an authorized access token for the remote resource.
Solution
We can try either of the below options to fix the issue:
Option 1:
Change the Applinks authentication type to "OAuth (Impersonation)" both ways in both applications
Option 2:
Manually authorize the authentication (only need to do it one time per user)
- Open any Jira issue > More > Link > Confluence page > click "search for a page"
- You will be redirected to the OAuth authentication steps and then click Allow button.
- Please complete any login process if prompted by Jira.
- Navigate to the Assets attribute page and try to add the Confluence object type.