> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/compte-et-facturation/sso-and-saml.md).

# SSO et SAML

Apprenez à partager votre contenu GitBook via SSO et SAML

Gérez l’accès à votre organisation à l’aide de domaines de messagerie ou de l’authentification unique SAML (SSO). Configurez les deux dans les **Paramètres** → **Accès**.

## Authentification unique via domaine e-mail

Ajoutez des domaines e-mail pour permettre aux personnes dont les adresses e-mail vérifiées correspondent de rejoindre votre organisation lorsqu’elles se connectent.

Pour configurer des domaines e-mail :

1. Dans le menu de l’organisation, cliquez sur **Paramètres**.
2. Sous **Organisation**, sélectionnez **Accès**.
3. Sous **Domaines de messagerie autorisés**, ajoutez chaque domaine que vous souhaitez autoriser, par exemple `mycompany.com`.
4. Sous **Nouveaux membres**, choisissez le **Rôle par défaut** pour les personnes qui rejoignent automatiquement l’organisation.

Seuls les domaines de messagerie professionnels sont acceptés. Les domaines de messagerie personnels, tels que `gmail.com`, ne peuvent pas être ajoutés.

<figure><img src="broken://files/ad6efaa63c1f4004a8b2a854786914a17604198b" alt="The Access management settings showing allowed email domains, the default role for new members, and the option to register a SAML identity provider"><figcaption><p>Configurez la SSO pour votre organisation.</p></figcaption></figure>

{% hint style="info" %}
Le rôle par défaut s’applique également aux membres qui rejoignent l’organisation par l’intermédiaire de votre fournisseur d’identité. Vous pouvez modifier le rôle d’un membre à tout moment dans **Organisation → Membres**.
{% endhint %}

## Authentification unique SAML

Le SSO SAML donne aux membres l’accès via votre fournisseur d’identité (IdP).

GitBook utilise votre IdP pour l’authentification des membres. Les administrateurs de l’organisation peuvent toujours se connecter avec une autre méthode. Cela évite tout blocage après une configuration SSO incorrecte.

### Prérequis <a href="#prerequisites-for-sso-with-gitbook" id="prerequisites-for-sso-with-gitbook"></a>

Le SSO SAML est disponible avec l’offre Enterprise.

* Le fournisseur d’identité (IdP) de votre entreprise doit prendre en charge la norme **SAML 2.0** .
* Vous devez disposer d’autorisations d’administration sur l’IdP.
* Vous devez être administrateur de l’organisation GitBook.

### Configurer SAML dans GitBook <a href="#setup-on-gitbook" id="setup-on-gitbook"></a>

Vous devez être [administrateur de l’organisation](https://gitbook.com/docs/documentation/fr/collaborate/member-management/roles.md#admin) pour configurer SAML.

Pour configurer SAML :

1. Dans le menu de l’organisation, cliquez sur **Paramètres**.
2. Sous **Organisation**, sélectionnez **Accès**.
3. Sous **SAML**, cliquez sur **Enregistrer le fournisseur d’identité** et saisissez les informations fournies par votre fournisseur d’identité.
4. Enregistrez la configuration, puis partagez l’URL de connexion SSO avec vos membres.

GitBook n’envoie pas d’e-mail d’annonce après l’enregistrement de la configuration.

{% hint style="info" %}
Les administrateurs de l’organisation peuvent toujours se connecter par des méthodes autres que le SSO, même si **Imposer le SSO** est activé. Les options Google, GitHub ou e-mail peuvent toujours s’afficher.

Cela évite de vous retrouver bloqué hors de votre organisation après une mauvaise configuration de la SSO. Les administrateurs peuvent toujours se connecter et supprimer ou corriger les paramètres SSO.
{% endhint %}

Vous avez besoin des informations suivantes de votre IdP :

* **Libellé** — affiché sur la page de connexion.
* **ID d’entité**.
* **URL d’authentification unique**.
* **Certificat X.509** — incluez le certificat complet.

### Configurer l’IdP <a href="#setup-on-the-idp" id="setup-on-the-idp"></a>

La plupart des fournisseurs d’identité compatibles avec SAML 2.0 ont besoin des informations du fournisseur de services. Dans GitBook, ouvrez **Paramètres → Organisation → Accès** et repérez les valeurs de votre organisation sous **SAML**.

Copiez ces valeurs dans votre IdP pour terminer la configuration SAML.

GitBook a besoin que le **NameID** contienne l’adresse e-mail du membre. Utilisez `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` comme format NameID. De nombreux fournisseurs d’identité proposent ce format sous **E-MAIL**.

### Attributs personnalisés

GitBook lit ces attributs personnalisés à partir de l’assertion SAML lors de la création d’un compte.

| Champ        | Description                                                                                                  |
| ------------ | ------------------------------------------------------------------------------------------------------------ |
| `first_name` | `first_name` et `last_name` les champs sont combinés pour créer le nom affiché de l’utilisateur dans GitBook |
| `last_name`  | `first_name` et `last_name` les champs sont combinés pour créer le nom affiché de l’utilisateur dans GitBook |

## Création de comptes pour les utilisateurs finaux <a href="#creating-end-user-account" id="creating-end-user-account"></a>

Pour ajouter des membres, créez des comptes pour eux dans votre IdP. Lors de la première connexion d’un nouveau membre à GitBook via l’IdP, un compte GitBook sera créé pour lui via le provisionnement automatique de l’IdP. L’utilisateur aura accès aux ressources de l’organisation en tant que membre de l’organisation.

{% hint style="danger" %}
La configuration nécessite des adresses e-mail en minuscules. N’utilisez pas d’adresses e-mail avec des majuscules et des minuscules mélangées.‌
{% endhint %}

## Suppression de comptes <a href="#removing-end-user-accounts" id="removing-end-user-accounts"></a>

La suppression d’un membre de l’IdP empêchera l’utilisateur de se connecter au compte GitBook correspondant, **mais ne supprimera pas son compte de GitBook**. Nous vous conseillons également de supprimer le compte de l’organisation GitBook.

## Contrôle de l’accès

Une fois la SAML SSO configurée, il incombe à l’IdP de contrôler qui peut accéder à votre compte GitBook.

## Avis de sécurité <a href="#security-notice" id="security-notice"></a>

GitBook ne lie jamais un compte existant à votre fournisseur d'identité au nom d'un administrateur. Seul le propriétaire du compte peut le lier, en se connectant via votre IdP.

Si quelqu'un a déjà un compte GitBook sous l'adresse e-mail envoyée par votre IdP, la connexion avec SAML ne l'ajoute pas automatiquement à votre organisation. Pour lui donner accès :

1. Invitez-le dans votre organisation.
   * Si **Imposer le SSO** n’est pas activé, invitez-le depuis **Membres** dans les paramètres de votre organisation.
   * Si **Imposer le SSO** est activé, utilisez le point de terminaison API `invites` avec `"sso": true`:

     ```bash
     curl --request POST \\
       --url "https://api.gitbook.com/v1/orgs/<org_id>/invites" \\
       --header "Authorization: Bearer <your_access_token>" \\
       --header "Content-Type: application/json" \\
       --data-raw '{ "sso": true, "role": "<role>", "emails": ["<email>"] }'
     ```
2. Demandez-leur de se connecter à GitBook avec leur compte existant et d'ouvrir votre organisation. Lorsque GitBook le leur demande, ils se connectent via votre IdP, ce qui lie leur compte à votre SSO.

L’invitation ajoute immédiatement un compte existant en tant que membre. La réponse de l’API le répertorie sous `failedSSOEmails`, car le compte n’est pas encore associé à votre fournisseur d’identité. Les comptes créés à partir de l’invitation sont associés immédiatement.

{% hint style="info" %}
Un compte GitBook ne peut être associé au SSO que d’une seule organisation à la fois. Si le compte est déjà associé à une autre organisation, son propriétaire ne peut pas accéder au contenu d’une organisation où **Imposer le SSO** est activé.
{% endhint %}

Sinon, la personne peut supprimer son compte GitBook existant, puis se connecter à votre organisation avec SAML. GitBook crée un nouveau compte et l'ajoute à votre organisation. La suppression d'un compte retire son accès à toutes les autres organisations.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/compte-et-facturation/sso-and-saml.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
