---
title: "Set up single sign-on"
description: "Connect your identity provider with SAML 2.0 or OpenID Connect, copy ComplyTrain's service-provider values, test the connection, and decide whether everyone must sign in through it."
url: https://helpcenter.complytrain.net/en/articles/9-set-up-single-sign-on
collection: "Users and access"
updated: 2026-09-22
language: en
---

# Set up single sign-on

Connect your identity provider with SAML 2.0 or OpenID Connect, copy ComplyTrain's service-provider values, test the connection, and decide whether everyone must sign in through it.

Connect your identity provider with SAML 2.0 or OpenID Connect, copy ComplyTrain's service-provider values, test the connection, and decide whether everyone must sign in through it.

Single sign-on (SSO) lets people sign in to ComplyTrain with their organisation account, for example Microsoft Entra ID, Okta, Google Workspace or another identity provider. Your organisation has one SSO connection, using either SAML 2.0 or OpenID Connect.

## Before you start

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

-   **Who:** only organisation **Admins** can open and change single sign-on.
    
-   **Where:** **Settings**, then **User Management** and **SSO Configuration**. The page is titled **Single Sign-On (SSO)**.
    
-   **Plan:** SSO must be included in your plan. If it is not, the page shows **Single sign-on is not included in your plan** instead of the setup options: "Upgrade to set up SAML or OpenID Connect for your organisation. If you already have single sign-on configured, it keeps working — this only affects setting up a new connection."
    
-   **Identity provider:** you need someone who can register an application in your identity provider, and a test account there.
    

The **SSO Status** card shows **Not Configured**, **Active**, or **Configured (Disabled)**, the protocol and provider name, for example "via SAML (Contoso Entra ID)", and **Last tested:** with **Passed** or **Failed** after a connection test.

## Choose a protocol

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

Under **Choose SSO Provider Type**, choose the protocol your identity provider supports:

-   **SAML 2.0**, recommended for enterprise identity providers such as Okta, Azure AD (Microsoft Entra ID), OneLogin and ADFS.
    
-   **OpenID Connect**, for providers such as Google Workspace, Auth0 and other modern identity providers.
    

The configuration form opens under the choice. Close it with **Cancel** or the close button to choose again; nothing is saved until you configure the connection.

![The unconfigured SSO page offers SAML 2.0 and OpenID Connect setup paths.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/SpvW2gj7hSHxVhz0ePAYABFd7yZwJPUUXgopgnoAZt9zLABJ5WQe4h6QPqjaXR56iC6I18Kjvh6.png "Choose an identity-provider protocol")

## Copy the service-provider values

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

Your identity provider needs to know about ComplyTrain before the connection can work. The form shows the values to enter there, each with a copy button (**Copied!** confirms the copy). You can register ComplyTrain in the identity provider first and complete the ComplyTrain form afterwards.

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>ComplyTrain shows</p></th><th colspan="1" rowspan="1"><p>Enter it in Microsoft Entra ID as</p></th><th colspan="1" rowspan="1"><p>Enter it in Okta as</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Entity ID (Issuer)</strong> (SAML)</p></td><td colspan="1" rowspan="1"><p>Identifier (Entity ID)</p></td><td colspan="1" rowspan="1"><p>Audience URI (SP Entity ID)</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>ACS URL (Reply URL)</strong> (SAML)</p></td><td colspan="1" rowspan="1"><p>Reply URL (Assertion Consumer Service URL)</p></td><td colspan="1" rowspan="1"><p>Single sign-on URL</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Redirect URI</strong> (OpenID Connect)</p></td><td colspan="1" rowspan="1"><p>Redirect URI of type Web, in the app registration</p></td><td colspan="1" rowspan="1"><p>Sign-in redirect URIs</p></td></tr></tbody></table>

For SAML, have the identity provider send each person's email address as their identifier (name ID format email address) and sign its assertions. ComplyTrain recognises people by email address, so the address must match the one their ComplyTrain account uses.

## Configure SAML 2.0

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

1.  Choose **SAML 2.0**. **Configure SAML 2.0** opens with **Service Provider Details** at the top.
    
2.  Complete the fields below.
    
3.  Choose **Configure SAML**. **SAML Configured** confirms the save, and the page shows the **Configuration Details**.
    

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>What to enter</p></th><th colspan="1" rowspan="1"><p>Rules and defaults</p></th></tr><tr><td colspan="1" rowspan="1"><p>Provider Name</p></td><td colspan="1" rowspan="1"><p>A friendly name, such as "Contoso Entra ID".</p></td><td colspan="1" rowspan="1"><p>Required, up to 100 characters.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Configuration Method</p></td><td colspan="1" rowspan="1"><p><strong>Metadata URL</strong> or <strong>Manual Configuration</strong>.</p></td><td colspan="1" rowspan="1"><p>Default <strong>Metadata URL</strong>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Metadata URL</p></td><td colspan="1" rowspan="1"><p>The identity provider's federation metadata address. In Entra ID this is the App Federation Metadata Url; in Okta, the metadata URL on the application's Sign On tab.</p></td><td colspan="1" rowspan="1"><p>Required with <strong>Metadata URL</strong>. Must be a valid URL.</p></td></tr><tr><td colspan="1" rowspan="1"><p>IdP Entity ID</p></td><td colspan="1" rowspan="1"><p>The identity provider's issuer, such as the Microsoft Entra Identifier.</p></td><td colspan="1" rowspan="1"><p>Required with <strong>Manual Configuration</strong>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>SSO URL (Login URL)</p></td><td colspan="1" rowspan="1"><p>Where people are sent to sign in, such as the Entra Login URL.</p></td><td colspan="1" rowspan="1"><p>Required with <strong>Manual Configuration</strong>. Use an https address.</p></td></tr><tr><td colspan="1" rowspan="1"><p>X.509 Certificate</p></td><td colspan="1" rowspan="1"><p>The identity provider's public signing certificate in PEM format, from <code>-----BEGIN CERTIFICATE-----</code> to <code>-----END CERTIFICATE-----</code>.</p></td><td colspan="1" rowspan="1"><p>Required with <strong>Manual Configuration</strong>. Never paste a private key.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Enable SSO immediately after configuration</p></td><td colspan="1" rowspan="1"><p>Makes the connection available as soon as it is saved.</p></td><td colspan="1" rowspan="1"><p>On by default.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Force all users to authenticate via SSO</p></td><td colspan="1" rowspan="1"><p>Requires single sign-on for everyone. See below.</p></td><td colspan="1" rowspan="1"><p>Off by default. Needs SSO to be enabled.</p></td></tr></tbody></table>

![The SAML form accepts a metadata URL or manual configuration. Enabling SSO and forcing every user through SSO are separate choices; nothing is saved.](https://staticfiles.gleap.io/p6950dfbf97796f2087a9f022/ZgPOrwg0qQdVQLl4QVY86iuMo8EqdubjZ5Ki0khC5KNckMvj4zfFezARcO6fzJBwDGrVbUGDDFZ.png "Review metadata and enforcement choices")

## Configure OpenID Connect

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

1.  Choose **OpenID Connect**. **Configure OpenID Connect** opens with the **Redirect URI** at the top.
    
2.  Complete the fields below.
    
3.  Choose **Configure OIDC**. **OIDC Configured** confirms the save.
    

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>What to enter</p></th><th colspan="1" rowspan="1"><p>Rules and defaults</p></th></tr><tr><td colspan="1" rowspan="1"><p>Provider Name</p></td><td colspan="1" rowspan="1"><p>A friendly name, such as "Google Workspace".</p></td><td colspan="1" rowspan="1"><p>Required, up to 100 characters.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Issuer URL</p></td><td colspan="1" rowspan="1"><p>The provider's issuer, exactly as it publishes it. Entra ID uses <code>https://login.microsoftonline.com/</code> followed by your directory (tenant) ID and <code>/v2.0</code>; Okta uses your Okta domain or its authorisation server.</p></td><td colspan="1" rowspan="1"><p>Required. Must start with http:// or https://, up to 500 characters. ComplyTrain finds the provider's settings from this address.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Client ID</p></td><td colspan="1" rowspan="1"><p>The application (client) ID from the provider.</p></td><td colspan="1" rowspan="1"><p>Required, up to 255 characters.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Client Secret</p></td><td colspan="1" rowspan="1"><p>The client secret from the provider. Use the eye button to check what you typed.</p></td><td colspan="1" rowspan="1"><p>Required. "This will be securely stored and never displayed again."</p></td></tr><tr><td colspan="1" rowspan="1"><p>Scopes</p></td><td colspan="1" rowspan="1"><p>The information ComplyTrain asks the provider for, separated by spaces.</p></td><td colspan="1" rowspan="1"><p>Default <code>openid profile email</code>. Must include <code>openid</code>.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Enable SSO immediately after configuration</p></td><td colspan="1" rowspan="1"><p>As for SAML.</p></td><td colspan="1" rowspan="1"><p>On by default.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Force all users to authenticate via SSO</p></td><td colspan="1" rowspan="1"><p>As for SAML.</p></td><td colspan="1" rowspan="1"><p>Off by default. Needs SSO to be enabled.</p></td></tr></tbody></table>

## Test the connection

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

Choose **Test Connection** on the **SSO Status** card. ComplyTrain checks the saved configuration and shows **Connection Successful** or **Connection Failed** with a summary, such as "All … test(s) passed successfully", or the check that failed. The result and time appear under **Last tested:**.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Protocol</p></th><th colspan="1" rowspan="1"><p>What the test checks</p></th></tr><tr><td colspan="1" rowspan="1"><p>SAML 2.0</p></td><td colspan="1" rowspan="1"><p>That a metadata URL or all three manual values are present; that the metadata URL answers with XML metadata; that the certificate is in PEM format; and that the SSO URL uses https.</p></td></tr><tr><td colspan="1" rowspan="1"><p>OpenID Connect</p></td><td colspan="1" rowspan="1"><p>That the issuer URL and client ID are present; that the provider's discovery document can be read from the issuer URL; and that the issuer it states matches the one you entered.</p></td></tr></tbody></table>

The test checks configuration only; it does not sign anyone in. Before you rely on SSO, sign in with a test account in a private browser window and check that it reaches ComplyTrain with the expected name and access.

## Enable or disable SSO

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

**Enable** or **Disable** on the **SSO Status** card switches the connection on or off without changing any other setting.

-   **Enable SSO?**: "SSO will become available for user authentication." Choose **Yes, enable SSO**.
    
-   **Disable SSO?**: "Users will be able to log in with passwords again." Choose **Yes, disable SSO**.
    

**SSO Updated** confirms the change, and the status shows **Active** or **Configured (Disabled)**. Disabling keeps the configuration, so you can enable it again later without entering it again.

While SSO is active, people can sign in through your identity provider with their organisation account. Unless **Force SSO Login** is on, they can also still sign in with a ComplyTrain password.

## Require SSO for everyone

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

**Force SSO Login** appears below the status while SSO is active: "When enabled, all users must authenticate through SSO. Local passwords will be disabled."

1.  Test the connection and sign in with a test account first.
    
2.  Tick **Force SSO Login**. **Force SSO Login?** explains: "All users will be required to authenticate through SSO. Local passwords will be disabled."
    
3.  Choose **Yes, confirm**. **Setting Updated** confirms it. SSO stays enabled, and nothing else changes.
    

From then on, everyone signs in through your identity provider, including Admins, and signing in with a ComplyTrain password is refused. Make sure every administrator can sign in through the identity provider before you turn it on.

To allow passwords again, clear the box and confirm **Allow Local Passwords?**: "Users will be able to log in with either SSO or local passwords."

While **Force SSO Login** is on, **Invite User** and **Import users (CSV)** are unavailable to everyone who manages users, with the tooltip **User management is disabled while Force SSO is active.** People get their ComplyTrain accounts through your identity provider instead, as described next.

## New people signing in through SSO

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

When someone signs in through SSO for the first time and has no ComplyTrain account, ComplyTrain creates one for them in the **Pending** class, and every Admin receives a **User awaiting access** notification. The person sees **Your access is pending** until you assign a licensed or training seat in **Pending users**; see [manage seats and account classes](https://help.complytrain.net/en/settings/account-classes/).

A person who arrives by following a link to a training course is given a training-learner seat straight away when one is free. People who already have an account keep it, with their class, roles and history.

## Change or remove the configuration

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

**Configuration Details** shows the saved values. For SAML: **Provider Name**, **IdP Entity ID**, **SSO URL** and whether a **Certificate** is **Configured**. For OpenID Connect: **Provider Name**, **Issuer URL**, **Client ID**, the **Client Secret** as asterisks, and **Scopes**.

To change the connection, for example when the identity provider's certificate or client secret is renewed, choose **Reconfigure SSO**. The form opens with the saved values, except the certificate and client secret, which you enter again. Save with **Configure SAML** or **Configure OIDC**, then test again.

To remove single sign-on entirely, choose **Remove** and confirm **Remove SSO Configuration?**: "This will remove all SSO settings. Users will need to log in with passwords." Choose **Yes, remove SSO**. **SSO Removed** confirms that the configuration has been deleted, and the page offers the protocol choice again. People keep their ComplyTrain accounts, classes and roles. Setting up a new connection afterwards requires SSO in your plan.

## Example: connect Microsoft Entra ID

Product location: `/settings/users/sso`. Open User Management in Settings, then SSO Configuration.

Contoso wants everyone to sign in with their Microsoft work account.

1.  In ComplyTrain, open **SSO Configuration**, choose **SAML 2.0** and copy **Entity ID (Issuer)** and **ACS URL (Reply URL)**.
    
2.  In the Microsoft Entra admin centre, create an enterprise application for ComplyTrain, choose SAML single sign-on, and paste the values into Identifier (Entity ID) and Reply URL. Set the user identifier (name ID) to the user's email address, and assign the application to your staff.
    
3.  Copy the App Federation Metadata Url from Entra ID.
    
4.  In ComplyTrain, enter "Contoso Entra ID" as **Provider Name**, keep **Metadata URL**, paste the address, keep **Enable SSO immediately after configuration** and leave **Force all users to authenticate via SSO** clear. Choose **Configure SAML**.
    
5.  Choose **Test Connection**, then sign in with a test account in a private browser window.
    
6.  When the test user gets in, tick **Force SSO Login** and choose **Yes, confirm**. From now on, new colleagues are added in Entra ID, and you give them a seat in **Pending users** after their first sign-in.
