Single Sign On (SSO)

In this Article:

• Providers
• Only Allow Login via SSO
• Mix of SSO and LegalServer Credentials for Users
• Break the Glass Account (Hint: there isn't one)
• SSO and API Calls
• SSO and the Site Closed to Non-Admins Setting

Providers

LegalServer currently offers integration with the following single sign on providers:

• Google Workspace
• Microsoft Azure AD
• Okta

Only Allow Login via SSO

• Setting the Global Enforcement Policy to "Enabled and Required" removes the login fields from the landing page and provides users only with the "Single Sign-On" link:

• Setting it to "Enabled" leaves the standard LegalServer Username and Password prompt, allowing a user to bypass the SSO link and login that way (assuming they enter valid credentials).
• We currently use OpenID Connect with the three providers.

Mix of SSO and LegalServer Credentials for Users

You can have some users logging in with SSO and others logging in with LegalServer credentials. A common use case is staff versus pro bono users.

A site can use "Enabled", exposing the login fields, but set the password for select users to a random, unknown-to-the-users value, thus forcing those users to use SSO.

Break the Glass Account

There isn't one. A common question is how an administrator would get into a site if their SSO wasn't working and "Enabled and Required" is used, thus not showing login fields. You would not be able to.

You would need to contact LegalServer support (support@legalserver.org) and ask us to set your site to just "Enabled", exposing the login fields. Someone (presumably an Administrator) could then login and with LS credentials, assuming they have valid ones.

NB: LegalServer staff can set a site 'back' to Enabled based on a request from an administrator. We will not do that and provide a password reset without further steps to ensure it isn't an attempt to gain unauthorized access to a site.

SSO and API Calls

API calls for the Reports API and the Core APIs do not check on the SSO requirements for authentication. Making such an API call with either Basic or Bearer Authentication will work even if SSO is set to "Enabled and Required".

SSO and the Site Closed to Non-Admins Setting

The Admin > Site Settings page has "Site Closed to Non-admins?". The SSO link on the login page does not bypass this setting. A user not assigned to the Administrator role can click the SSO link, but will get a message that the site has been shutdown and to contact their administrator.