SSO in Organisation Settings

SSO in Organisation Settings

Cognassist

Single sign-on setup

Client Admins can now set up single sign-on (SSO) for their organisation themselves, on the Integrations page.

Read this before you start

Once single sign-on is on, it can't be turned off, and your identity provider can't be changed. Agree the setup with your IT team first.

Before you start

 
You need to be a Client Admin.
 
Your organisation needs a custom domain in Cognassist. Without one, the SSO tab says "Single sign-on needs a custom domain. Contact Customer Success to set one up."
 
From your identity provider, have ready your domain or issuer URL, client ID and client secret.

Supported identity providers

ProviderNotes
Microsoft Entra IDEnter your domain or issuer URL, client ID and client secret
OpenID Connect (OIDC)Choose the front channel or back channel, then enter your details
Google WorkspaceEnter your domain or issuer URL, client ID and client secret

Set up single sign-on

1

Open the SSO tab

Go to Integrations > SSO.

2

Switch it on

Switch single sign-on on.

3

Choose your provider

Pick Microsoft Entra ID, OpenID Connect (OIDC) or Google Workspace. For OIDC, choose the front or back channel.

4

Enter your details

Add your domain or issuer URL, client ID and client secret.

5

Confirm and save

Confirm that you understand single sign-on can't be turned off, then save.

After you save

 
Your identity provider can't be changed.
 
Your client secret is never shown again.
 
To update your details later, enter the client secret again each time you save, unless you use OIDC on the front channel.
 
Saving switches off email verification for your organisation's users.
 
You can't switch single sign-on off or change your custom domain on this page. Contact Customer Success about your custom domain.

FAQs

Where is SSO setup?

On the Integrations page, in the SSO tab. It isn't in Organisation settings.

Who can set it up?

Client Admins.

Can we turn single sign-on off later?

No. Once it's on, it stays on.

Can we move to a different identity provider?

No. The provider can't be changed once single sign-on is on.

We don't have a custom domain. What now?

Contact Customer Success to set one up, then come back to the SSO tab.

Need a hand?

Talk to your Customer Success Manager. They can help you set this up for your organisation.