> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAML SSO

> Configurez l'authentification unique SAML 2.0 pour votre organisation.

Truthlocks prend en charge l'authentification unique native SAML 2.0 afin que votre équipe puisse s'authentifier via votre fournisseur d'identité (IdP) existant. Lorsque SAML est configuré, les utilisateurs sont automatiquement redirigés vers votre IdP lors de la connexion.

> [!NOTE]
>
> Le SAML SSO est disponible avec le plan **Business** et les plans supérieurs.

## Comment ça marche

**1. Configurez votre IdP**

Enregistrez Truthlocks en tant que fournisseur de services (SP) dans votre fournisseur d'identité.
Vous avez besoin de l'ID d'entité SP et de l'URL du service consommateur d'assertions (ACS) de l'IdP.
écran de configuration.

**2. Ajouter une connexion dans Truthlocks**

Dans la console, allez dans **Paramètres > SSO** et créez une nouvelle connexion SAML.
Saisissez l'URL des métadonnées de votre IdP ou fournissez manuellement l'ID d'entité IdP, l'URL SSO,
et certificat de signature.

**3. Les utilisateurs se connectent via IdP**

Une fois actifs, les utilisateurs qui visitent la page de connexion de la console sont redirigés vers votre
IdP. Après authentification, ils sont renvoyés à Truthlocks avec une session.

## Détails du fournisseur de services

Fournissez ces valeurs à votre IdP lors de l'enregistrement de Truthlocks :

| Champ | Valeur |
| - | - |
| ID d'entité SP | `urn:truthlocks:TENANT_ID` |
| URL ACS | `https://console.truthlocks.com/api/auth/saml/acs` |
| Format NameID | `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` |
| Liaison | HTTP-POST |

## Champs de configuration IdP

Lors de la création d'une connexion SAML dans la console, vous pouvez configurer votre IdP de deux manières :

### Option A: URL des métadonnées

Fournissez l'URL des métadonnées de votre IdP et Truthlocks récupère automatiquement l'ID d'entité, l'URL SSO et le certificat de signature.

### Option B: configuration manuelle

| Champ | Description |
| - | - |
| ID d'entité IdP | L'identifiant unique de votre fournisseur d'identité |
| URL SSO IdP | L'URL où Truthlocks envoie les requêtes d'authentification SAML |
| Certificat IdP | Le certificat de signature X.509 de votre IdP (format PEM) |

## Création d'une connexion via l'API

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections \
  -H "Authorization: Bearer <admin_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_type": "SAML",
    "idp_metadata_url": "https://idp.example.com/metadata",
    "role_mapping_mode": "GROUPS"
  }'
```

Si vous préférez une configuration manuelle, omettez `idp_metadata_url` et fournissez plutôt `idp_entity_id`, `idp_sso_url` et `idp_certificate`.

## Mappage des rôles

Truthlocks mappe les assertions de groupe IdP aux rôles internes lors de la connexion. Deux modes sont disponibles :

| Mode | Comportement |
| - | - |
| `STATIC` | Tous les utilisateurs SAML reçoivent un rôle par défaut fixe (par exemple, `viewer`) |
| `GROUPS` | Les noms de groupe IdP sont automatiquement mappés aux rôles Truthlocks (`admin`, `editor`, `auditor`) |

Définissez le mode lors de la création ou de la mise à jour de la connexion SSO.

## Provisionnement des utilisateurs

Lorsqu'un utilisateur s'authentifie via SAML pour la première fois, Truthlocks crée automatiquement son compte en utilisant les attributs de l'assertion SAML (e-mail, prénom, nom). C'est ce qu'on appelle le provisionnement juste-à-temps (JIT).

Pour la synchronisation et la désapprovisionnement en masse des utilisateurs, utilisez [l'approvisionnement SCIM](https://docs.truthlocks.com/fr/security/scim.md).

## Détails de la session

* Les sessions durent **12 heures** après la connexion SAML.
* Les cookies de session sont `HttpOnly` et `SameSite=Lax`.
* Une tolérance de décalage d'horloge de 2 minutes est appliquée lors de la validation des assertions SAML.

## Tester une connexion

Après avoir créé une connexion SAML, testez-la avant de l'activer pour tous les utilisateurs :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/test \
  -H "Authorization: Bearer <admin_token>"
```

Ceci valide que Truthlocks peut atteindre votre IdP et analyser correctement les métadonnées.

## Désactivation de l'authentification unique (SSO)

Pour revenir à l'authentification standard par e-mail/mot de passe :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/sso/connections/<connection_id>/disable \
  -H "Authorization: Bearer <admin_token>"
```

## Lié

* [Provisionnement SCIM](https://docs.truthlocks.com/fr/security/scim.md) — Automatisez la synchronisation des utilisateurs et des groupes depuis votre IdP.
* [RBAC et permissions](https://docs.truthlocks.com/fr/security/rbac.md) — Comprendre les rôles auxquels les utilisateurs SAML sont mappés.
* [Authentification](https://docs.truthlocks.com/fr/security/auth.md) — Méthodes d'authentification par clé API et JWT.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.