Building a self-service knowledge base with Jira Service Desk and Confluence

Knowledge bases enable customers to solve problems by themselves. This article shows how you can combine Jira Service Desk and Confluence to provide solutions and knowledge and also optimize the login experience for both support agents and customers.
30/09/2019 - jira service desk, confluence, sso

A knowledge base stores helpful articles, such as how-tos and frequently asked questions (FAQs) that your team and customers can reference. Knowledge bases empowers support portals for both customers and support agents:

  • Customers can help themselves by searching for articles in the help center
  • Agents can solve requests faster by sharing articles with customers or referencing articles while they work

This technical quide explains how to Link a Confluence space to your Jira service desk.

The screenshot below shows how we at Kantega SSO link our confluence documentation as knowledge base in our Jira service desk support portal. In this particular example, you can see that a user typing in “How to setup single logout?” in the support portal get suggestions for articles describing this topic.

alt text

Provide Single-sign on to Jira Service Desk customers

Many of our customers apply Jira Service Desk in environments where also customers can benefit of SSO. It can be that both support agents and customers work in the same organization or that the customers work in partner companies where the set of identity providers are known. In these scenarios it is fully possible to setup SSO through both SAML and Kerberos for all.

2-step login is a useful feature in the scenario where multiple identity providers are available for different user types, allowing you to define login-redirection rules based on the email domain the users type in, the user directory they exist in or the group memberships they have.

Handle authentication on knowledge base contents.

Setup of Confluence as a knowledge base is very easy if the documentation is public and do not require authentication. However, this it not the case for many organizations. It is a common scenario that knowledge base articles should be available throught the service portal, but at the same time require authentication for users accessing this content in Confluence directly.

In Kantega SSO Enterprise, the solution for this is as follows: When you set up a Confluence as a Knowledge base, you get the default Jira Service Desk-specific permission of anonymous access as shown below:

alt text

If you are using SAML based login in Kantega SSO Enterprise, you must keep this default setting for your Knowledge base space. The reason why is that when JSD opens a Knowledge base article for viewing, this is done in an IFRAME. And in an IFRAME, most SAML identity providers are not allowing to show their login window.

If you would like to require a login to the Knowledge base space when users are visiting directly in Confluence, this can be achieved by the Forced SSO URLs feature.

alt text

Book a meeting with us if you need assistance setting up a knowledge base with SSO.

You might also like

Multi-factor authentication

Multi-Factor Authentication (MFA) verifies a user’s identity by requiring multiple credentials. In addition to username and password, MFA requires additional credentials, such as a code from the user’s smartphone, or a fingerprint.
23/10/2019 - sso, saml, mfa

2 Step Login

Redirect to specific SAML identity providers based on email domain, user directory or group memberships.
10/09/2019 - sso, saml

Login to Atlassian without passwords

Nobody likes passwords. They are inconvenient, expensive and noisy friction in our workday. With Kerberos you can remove this friction and automatically authenticate users accessing Atlassian applications.
16/08/2019 - sso, kerberos