Guide to link Knowledge Base to JIRA Service Desk for unlicensed user

Still need help?

The Atlassian Community is here for you.

Ask the community


JIRA Service Desk has introduced a new feature starting JIRA ServiceDesk v3.1 where there is no need for users to have a license in Confluence to be able to access the Confluence Knowledge Base through Service Desk.

This feature is detailed in Linking A KnowledgeBase.  This article aims to further explain with details on that documentation to assist users in understanding this feature.

Things to Know:

This feature was originally built for the Cloud environment which has a shared user base directory (i.e. using the same user directory or has the same sets of users). If you are running server versions of JIRA Service Desk & Confluence, you will need to make sure that users (including Service Desk Customers exist in both JIRA and Confluence by using of one of the following approaches:

  • Have the same user base in both Jira & Confluence e.g. both JIRA and Confluence integrated with the same external directory. Briefly speaking, each Service Desk customers has a user account in both JIRA and Confluence but not consuming any licenses.
  • Manually create a user in Confluence for every customer in JSD that will need access to the Knowledge Base. You can create a "customer" account in Confluence by not assigning it to a group. This will not count against your Confluence license.

How to Set Up the Linking

A) AppLinks Configuration

  1. Setup the AppLinks using OAuth with impersonation on both Jira and Confluence Side

B) Configuration on Jira Side

  1.  Go to JSD Project Administration > Knowledge Base, link to the dedicated space and allow all active users to access the space without a Confluence license.

C) Configuration in Confluence

  1. Ensure that in the Global Permission page the Unlicensed Access is enabled. 
    (info) This Unlicensed Access option will only be visible once KB connection is created in JSD first.

  2. Ensure that in the Space Permissions page the Any active user can view this space panel is visible.

D) Making sure the customer exists on both applications

  1. In JIRA, the user can be created manually without granting any access to the user, or sign up the user via Service Desk sign up option.
    1. If both Applications are integrated with the same external directory, create the user in the directory first and sync it to the applications.

  2. In Confluence, search for the same user and ensure that the user is not added to any groups which consume a Confluence license.

E) Accessing the KB through JSD

  1. Log in to the help center as a customer and search for the KB. Clicking on the result will redirect user to the KB page with a login box.

  2. Clicking on the Log in to Confluence button will bring the user to the Confluence login page. Proceed to log in with the JIRA username and password and (warning) select Remember me.

  3. Upon successful login, customer will be able to see the article loaded in the Confluence page itself or back on the Service Desk page where the login was required, refreshing the page will also load the article in the frame.

(warning) If you are unable to search for the article using a customer account, and can only search article using admin/agent account, you might be hitting into this  JSD-4233 - Getting issue details... STATUS  bug. Do put a comment on this bug ticket if you experience this issue.

Last modified on Jun 20, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.