---
updatedAt: 2025-09-24T20:48:49.000Z
agentTools:
  projectIndex: https://docs.quable.com/v5-EN/llms.txt
---

# Configuring SSO SAML Authentication

> 📘 Learning Objectives
>
> * Understand SSO SAML authentication for user access management
> * Configure and enable SSO authentication with an Identity Provider (IdP)
> * Manage user account creation and define permissions

***

<br />

# Overview

SAML authentication allows administrators to manage access to their company’s applications efficiently and securely. By centralizing authentication through an Identity Provider (IdP), it simplifies user management and reduces password-related risks (loss, reuse, phishing attacks).

With Single Sign-On, employees log in once to access all their business applications, enhancing user experience and reducing IT support requests related to login issues.

In summary, SSO authentication via SAML enables users to sign in once to access Quable and other company applications without entering multiple passwords. The key benefits of SAML authentication are:

* Fast and simplified login for users,
* Reduced password reset requests,
* Secure and proven authentication.

<Callout icon="👍🏼" theme="default">
  ### Good to know

  * The **SSO/SAML** option requires a subscription. Contact your **CSM** for more details.
  * Your **domain** must be verified before enabling SSO.
  * Once **SSO/SAML** is enabled, users with an email address from your domain will only be able to log in via SSO. Google logins will still be possible through Social Login.
</Callout>

***

# Enabling SSO Authentication

* From the administration menu, go to **Users > SAML Authentication,**

<Image alt="Capture d’écran 2025-02-03 à 17.59.18.png" align="center" width="20% " src="https://files.readme.io/7dfa253b3b11e0be21b7bd02d2219d34c73b150466cbc99f0f73d01f5ccbd59f-Capture_decran_2025-04-08_a_16.11.36.png" />

* Enable the SSO option using the dedicated toggle switch,
* Once enabled, configuration fields will appear.

<Image alt="Capture d’écran 2025-02-03 à 17.59.27.png" align="center" src="https://files.readme.io/3bdc4ccdf1e0cae2321bee00b92c8686af4986b495d49712531ba4ba5ad50b18-Capture_decran_2025-04-08_a_16.11.49.png" />

<br />

## Configuring the Identity Provider (IdP)

The **Identity Provider (IdP)** handles user authentication and sends the required information to Quable.

**Enter the details provided by your IdP:**

* Entity ID
* Sign-On URL
* Logout URL
* IdP Certificate

<Image alt="Capture d’écran 2025-02-03 à 17.59.31.png" align="center" src="https://files.readme.io/b298ef12f84cfe851e527c325fb1f0e5b3317f183e3c3a79fb9ba1fbc582ed75-Capture_decran_2025-04-08_a_16.12.00.png" />

<Callout icon="👍🏼" theme="default">
  ### Good to know

  The IdP certificate must include:

  ```
  -----BEGIN CERTIFICATE-----
  (certificate content)
  -----END CERTIFICATE-----

  ```
</Callout>

<br />

## Configuring the Service Provider (SP)

Quable acts as a **Service Provider (SP)**. The following details are automatically generated:

* **Entity ID**: `https://instance_name.quable.com/api/sp/metadata`
* **ACS URL**: `https://instance_name.quable.com/api/sp/acs`
* **Logout URL**: `https://instance_name.quable.com/api/sp/logout`

<Image alt="Capture d’écran 2025-02-03 à 17.59.39.png" align="center" src="https://files.readme.io/8f09036a8208986d07ccf84e17fca461cc95c6ed79094fab8691d096963dd000-Capture_decran_2025-04-08_a_16.12.15.png" />

<Callout icon="📌" theme="default">
  ### Required Action

  Enter these details in your **IdP** configuration.
</Callout>

<br />

## Managing User Account Creation

You can define how Quable handles new users logging in via SSO.

### **Enabling or Disabling Automatic Account Creation**

* **Disabled** ❌ → Access is denied to non-existing users,
* **Enabled** ✅ → An account is automatically created upon first login.

<Image align="center" width="20% " src="https://files.readme.io/bc6e69a55b3e811d53a3e7afe73019fc06da4d8b3166a0d00ab3ac80bbc33941-Capture_decran_2025-04-08_a_16.14.40.png" />

> ⚠️ Limitations
>
> The number of user accounts you can add without additional cost is limited and depends on your Quable subscription plan. Contact your **CSM** for more details.

<br />

### Required Information in the SAML Token

When an account is automatically created, the IdP must transmit the following fields:

* email
* firstname
* username

<br />

### Configuring New Users

* Define default languages,
* Assign a role to manage permissions,
* Configure the timezone and other necessary information.

<Callout icon="👍🏼" theme="default">
  ### Good to know

  * Languages must be set,
  * A role must be assigned,
  * The timezone must be specified.
</Callout>

<br />

## Validating the Configuration

* Verify all entered information,
* Click **Update** to save the configuration,

<Image alt="Capture d’écran 2025-02-03 à 17.59.50.png" align="center" width="20% " src="https://files.readme.io/babf8dc9381ccfd12236a14d19706b68752a028087d64ec7102a58bec1b06a87-Capture_decran_2025-04-08_a_16.12.51.png" />

SSO is now enabled!

<br />

## Login Page

Once the SSO feature is deployed, the login page displays a new SSO/SAML access button.

<Image align="center" width="30% " src="https://files.readme.io/d83b12db78a3b63704de761452ffa5c9cdce12966534f6639023ff7c8c772547-Capture_decran_2025-03-25_a_16.04.24.png" />

***

> 📘 Summary
>
> SAML (Security Assertion Markup Language)\
> SSO (Single Sign-On)
>
> * Enabling SSO SAML
>   * Feature requires a subscription
>   * Configuring the Identity Provider (IdP): entity ID, login/logout URL, certificate.
>   * Verify certificate format (BEGIN CERTIFICATE / END CERTIFICATE).
>   * Configuring the Service Provider (SP): automatically provided.
>   * Enter these values in your IdP to establish the connection.
> * User Account Management
>   * Enable/disable automatic account creation upon first login.
>   * If enabled, the IdP must transmit email, first name, and username.
>   * Configure languages, roles, and time zones before validation.

***

# Next Chapter

Congratulations! You have completed the "Configuring SSO SAML Authentication" course. Continue your learning journey with the next module in the [Administrator Training](https://docs.quable.com/v5-EN/docs/administrator-training).