Configuring SAML SSO for KnowledgeOwl

These steps will guide you through setting up the single sign-on functionality between ADSelfService Plus and KnowledgeOwl

Prerequisite

1. Log in to ADSelfService Plus as an administrator.
2. Navigate to  Configuration → Self-Service → Password Sync/Single Sign On → Add Application, and select KnowledgeOwl from the applications displayed.
   Note: You can also find KnowledgeOwl application that you need from the search bar located in the left pane or the alphabet wise navigation option in the right pane.
3. Click IdP details in the top-right corner of the screen.
4. In the pop-up screen that appears, note down the values of Entity ID, Login URL, Logout URL. and download the SSO certificate by clicking Download Certificate.

KnowledgeOwl (Service Provider) configuration steps

1. Now, log in to your KnowledgeOwl administrator account.
2. Navigate to Settings → Basic.

3. Note down the sub domain name. This will serves as the SP Identifier for KnowledgeOwl in ADSelfService Plus.

   

4. Now, click Security in the toppane.

   
5. For Default Login Page option, select SAML Login URL.
6. Scroll down to SAML SSO Integration section, and in Enable SAML option, select Enable SAML SSO.
7. In the iDP entityID and Login URL fields, enter the Login URL value that you had saved in Step 4 of Prerequisite.
8. In the Logout URL field, enter the Logout URL value that you had saved in Step 4 of Prerequisite.

9. Click Update Certificate. In the x509 Certificate field, click Choose and select the PEM certificate file you had saved in Step 4 of Prerequisite.

   
10. Click Save.
11. To test whether the SSO configuration was successful, click Map Reader Fields link. If you get an error, please check whether you’ve followed the above steps correctly.

ADSelfService Plus (Identity Provider) configuration steps

1. Now, switch to ADSelfService Plus’ KnowledgeOwl configuration page.
2. Enter the Application Name and Description.
3. In the Assign Policies field, select the policies for which SSO need to be enabled.
   Note:ADSelfService Plus allows you to create OU and group-based policies for your AD domains. To create a policy, go to Configuration → Self-Service → Policy Configuration → Add New Policy.
4. Select Enable Single Sign-On.
5. Enter the Domain Name of your KnowledgeOwl account. For example, if you use johndoe@thinktodaytech.com to log in to KnowledgeOwl, then thinktodaytech.com is the domain name.
6. In the SP Identifier field, enter the Sub Domain you had saved in Step 3 of KnowledgeOwl configuration.
7. Choose the Name ID format that has to be sent in the SAML response. The Name ID format will specify the type of value sent in the SAML response for user identity verification.

8. Click Add Application

   Your users should now be able to sign in to KnowledgeOwl through ADSelfService Plus.

Note:

• For KnowledgeOwl, both IdP-initiated and SP-initiated flows are supported.
• Currently SSO to KnowledgeOwl through ADSelfService Plus is available for the reader page only. That is, only end users can make use of the SSO functionality. We do have plans to implement SSO for the whole application soon so that admin users too can make use of this functionality.