Knowby
Configure SSO with Entra ID for your Knowby organisation
Learn how to set up Single Sign-On (SSO) for your Knowby organisation using Microsoft Entra ID. This guide walks you through creating an app in Entra ID, and configuring authentication settings to ensure a seamless and secure login experience.
Learn how to set up Single Sign-On (SSO) for your Knowby organisation using Microsoft Entra ID. This guide walks you through creating an app in Entra ID, and configuring authentication settings to ensure a seamless and secure login experience.
1
<p>Login to your <a class="e-rte-anchor" href="https://portal.azure.com" title="https://portal.azure.com" target="_blank" aria-label="Open in new window">Azure Portal</a>&nbsp;and select Microsoft Entra ID (formerly Azure AD).</p><p>Select the Entra ID directory that aligns with your company's public domain name associated with your user's email addresses (e.g. user@companyname.com).</p><p><br></p><blockquote><p><span>⚠️If you have more than one Entra ID directory, make sure you are in the correct directory when you register the app you want to use with Knowby.&nbsp;</span><br></p></blockquote><p><br></p><p><span>If you are unsure on how to use Entra ID in the Azure Portal, please refer to&nbsp;</span><a class="e-rte-anchor" href="https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app#add-credentials" title="https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app#add-credentials" target="_blank" aria-label="Open in new window">Microsoft's Quickstart Guide.</a><br></p>

Login to your Azure Portal and select Microsoft Entra ID (formerly Azure AD).

Select the Entra ID directory that aligns with your company's public domain name associated with your user's email addresses (e.g. user@companyname.com).


⚠️If you have more than one Entra ID directory, make sure you are in the correct directory when you register the app you want to use with Knowby. 


If you are unsure on how to use Entra ID in the Azure Portal, please refer to Microsoft's Quickstart Guide.

2
<p>Click <em><strong>Add &gt; Enterprise Application</strong></em></p>

Click Add > Enterprise Application

3
<ol><li>Add a <em><strong>Name </strong></em>(e.g. Knowby)</li><li>Under <strong><em>Redirect URI</em></strong>, in the dropdown box, select <em><strong>Web</strong></em>&nbsp;</li><li>Enter the following URI:&nbsp; <a class="e-rte-anchor" href="https://knowby.au.auth0.com/login/callback" title="https://knowby.au.auth0.com/login/callback" target="_blank">https://knowby.au.auth0.com/login/callback</a> </li><li>Click <em><strong>Register</strong></em></li></ol>
  1. Add a Name (e.g. Knowby)
  2. Under Redirect URI, in the dropdown box, select Web 
  3. Enter the following URI:  https://knowby.au.auth0.com/login/callback
  4. Click Register
4
<p>In the <strong><em>Overview</em></strong> section of the new enterprise application you just created, copy the&nbsp;<strong><em>Application (client) ID</em></strong>, and provide this to the person at Knowby supporting you with the SSO Integration.</p>

In the Overview section of the new enterprise application you just created, copy the Application (client) ID, and provide this to the person at Knowby supporting you with the SSO Integration.

5
<ol><li>Navigate to <em><strong>Manage</strong></em></li><li>then <strong><em>Authentication</em></strong></li><li>Then <strong><em>Add URI</em></strong></li><li>Paste the following URI: <a class="e-rte-anchor" href="https://auth.knowby.pro/login/callback" title="https://auth.knowby.pro/login/callback" target="_blank">https://auth.knowby.pro/login/callback</a> <br></li><li>Click <strong><em>Save</em></strong></li></ol>
  1. Navigate to Manage
  2. then Authentication
  3. Then Add URI
  4. Paste the following URI: https://auth.knowby.pro/login/callback
  5. Click Save
6
<ol><li><span>Navigate to&nbsp;<strong><em>Manage</em></strong></span></li><li><div>then&nbsp;<strong><em>Certificates &amp; secrets</em></strong></div></li><li>then<em><strong> Client secrets</strong></em></li><li><div>Then click <strong><em>+ New client secret</em></strong></div></li></ol>
  1. Navigate to Manage
  2. then Certificates & secrets
  3. then Client secrets
  4. Then click + New client secret
7
<ol><li>Add a description for the client secret in the <strong><em>Description</em></strong> field</li><li>&nbsp;In the <strong><em>Expires</em></strong> dropdown box, select a suitable expiry time for the client secret in line with your organisation's security policies</li><li>Then click <strong><em>Add</em></strong></li></ol><blockquote><p><span><span>⚠️ M</span>ake sure to&nbsp;</span>record the expiration date; you will need to renew the key before that day to avoid a service interruption.<br></p></blockquote>
  1. Add a description for the client secret in the Description field
  2.  In the Expires dropdown box, select a suitable expiry time for the client secret in line with your organisation's security policies
  3. Then click Add

⚠️ Make sure to record the expiration date; you will need to renew the key before that day to avoid a service interruption.

8
<p><span>Your new client secret has been created.</span></p><p><span>Copy the text in the <strong><em>Value</em></strong> field and </span>provide this to the person at Knowby who is supporting you with the SSO Integration.</p><blockquote><p><span>⚠️ Ensure you store the secret value in a safe place as it is never displayed again after you leave this page.</span><br></p></blockquote><p><br><br></p>

Your new client secret has been created.

Copy the text in the Value field and provide this to the person at Knowby who is supporting you with the SSO Integration.

⚠️ Ensure you store the secret value in a safe place as it is never displayed again after you leave this page.



9

Finally, send the following to the person at Knowby who is supporting you with the SSO Integration so they can complete the configuration:

  1. Your company's public domain name.
  2. The Application (client) ID
  3. The Client Secret Value