Note: SSO configuration requires a paid Koan subscription and to be an organizational admin. Please reach out to us for help configuring your Koan instance appropriately.

If your organization is already using Office 365 for authentication and management, existing Koan users can use it to sign in. To set up Office 365 SSO, we'll need to:

  1. create an Azure Active Directory application
  2. configure Koan with your application's settings

Here's how it works.

Create an Azure app registration

In your Azure administrator panel, click Azure Active Directory in the left sidebar, then click App Registrations (Preview) in the adjacent sidebar.

You'll be brought to a page with a button at the top saying "New registration". Click that button, and you'll be taken to a page like this:

Set the name of the application to Koan, and specify the redirect URI as shown in the screenshot (https://myapp.koan.co/callbacks/oauth/azure ), but with myapp  replaced with your company's Koan subdomain. Click Register at the bottom of the screen, and you'll be taken to a page like this.

Note the Client ID and Tenant ID shown in the rectangle marked "1" in this screenshot. We'll need both of these when setting up your Azure application inside Koan.

Next, click on the Certificates & secrets link on the left side, marked "2" in the above screenshot. Clicking this will take you to a page like this:

Here, click "New client secret", as outlined in the screenshot. Note the secret that it provides you. Next, inside Koan, navigate to the SSO section of your company settings and click Connect Azure. Or, navigate directly to https://myapp.koan.co/org/configure/integrations/azure , with the myapp  part replaced with your company's Koan subdomain. Once there, you'll see a form like below. Simply paste in the Client ID, Tenant ID, and Client Secret you got from above, then click Save Configuration.

Did this answer your question?