> For the complete documentation index, see [llms.txt](https://stablebuild.gitbook.io/stablebuild-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stablebuild.gitbook.io/stablebuild-documentation/docs/fr/product/single-sign-on-saml.md).

# Authentification unique (SAML)

Vous pouvez configurer l'authentification unique pour tous les utilisateurs de votre organisation. Chaque utilisateur devra alors s'authentifier auprès de votre fournisseur d'identité (Google Workspace ou Okta, par exemple). Les utilisateurs qui se connectent via le SSO obtiennent automatiquement accès à votre organisation, en tant que membres. Vous pouvez accorder manuellement les droits d'administrateur aux nouveaux utilisateurs depuis l'écran **Utilisateurs**.

{% hint style="info" %}
Le SSO est disponible à partir du forfait Professional. Vous pouvez changer de forfait sur la page Facturation du [tableau de bord](https://dashboard.stablebuild.com).
{% endhint %}

### Mettre en place le SSO avec Google Workspace

1. Connectez-vous à la console d'administration Google sur <https://admin.google.com>
2. Cliquez sur **Applications > Applications Web et mobiles**, puis sur **Ajouter une application > Ajouter une application SAML personnalisée**\
   \\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-8251af7f2e8918bf5041b0ff5129838c2e9edf23%2Fimage%20(12)%20(1).png?alt=media" alt=""><figcaption><p>Ajout d'une nouvelle application SAML dans Google Workspace</p></figcaption></figure>
3. Saisissez « StableBuild » comme nom d'application, ajoutez un logo, puis cliquez sur **Continuer**.
4. Cliquez sur **Télécharger les métadonnées**, attendez la fin du téléchargement du fichier, puis cliquez sur **Continuer**.\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-f3d72fa546f810082dfc8af8fd8e5bd02a3a9592%2Fimage%20(13).png?alt=media" alt=""><figcaption><p>Téléchargement des métadonnées de l'IdP depuis Google</p></figcaption></figure>
5. Ouvrez une nouvelle fenêtre de navigateur (en laissant la console d'administration Google ouverte), rendez-vous sur le [tableau de bord StableBuild](https://dashboard.stablebuild.com) et cliquez sur **Paramètres > Configurer SAML**.
6. Donnez un nom au fournisseur d'identité (par exemple Google Workspace), sélectionnez le fichier de métadonnées de l'IdP fourni par Google, puis cliquez sur **Téléverser les métadonnées**.\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-c930f029d7d98c1240f0141a1c90be423990051d%2Fimage%20(15).png?alt=media" alt=""><figcaption><p>Téléversement des métadonnées de l'IdP dans StableBuild</p></figcaption></figure>
7. Copiez ensuite les valeurs de StableBuild vers Google Workspace comme ci-dessous. Veillez également à définir « Format d'ID de nom » sur « EMAIL » :\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-42ced57686b650b36714a61fd121e7b89a6daecd%2Fimage%20(16).png?alt=media" alt=""><figcaption><p>Configuration de Google Workspace comme IdP dans StableBuild</p></figcaption></figure>
8. Ensuite, dans la console d'administration Google, cliquez sur **Continuer**, puis sur **Terminer**. Puis, sous « Accès utilisateur », cliquez sur l'icône en forme de chevron vers le bas :\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-2cc0072c6816a705cc39b8b512a3ee2c50455f19%2Fimage%20(18).png?alt=media" alt=""><figcaption><p>Modification de l'accès utilisateur à StableBuild</p></figcaption></figure>

   \
   Et activez l'application pour tout le monde :\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-072a818f0f824b673b037bb39822e4f1749b4672%2Fimage%20(19).png?alt=media" alt=""><figcaption><p>Autoriser tous les membres de votre organisation à utiliser StableBuild depuis Google Workspace</p></figcaption></figure>
9. Vous devez maintenant vous reconnecter une fois via le SSO. Dans le tableau de bord StableBuild, sous **Paramètres > SAML / Authentification unique**, repérez l'« URL de connexion directe ». Déconnectez-vous ensuite de StableBuild (cliquez sur votre avatar, puis sur « Se déconnecter »). Rendez-vous enfin à l'URL de connexion directe pour déclencher le parcours SSO :\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-ed19898a92b1f517f314f9e9779723e59e22321d%2Fimage%20(20).png?alt=media" alt=""><figcaption><p>Où trouver l'URL de connexion directe</p></figcaption></figure>
10. Une fois que vous vous êtes connecté au moins une fois via le SSO, vous pouvez l'imposer à tous les membres de votre organisation. Rendez-vous sur **Paramètres** et activez « Imposer la connexion via SAML / SSO ».

Et voilà. Vous avez configuré l'authentification unique pour tous vos utilisateurs avec Google Workspace. 🔐

#### Limitations

La connexion depuis le lanceur d'applications de Google n'est pas prise en charge actuellement, en raison d'un problème dans notre logiciel d'authentification ([ici](https://github.com/FusionAuth/fusionauth-issues/issues/2545)).

<figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-64092d6534b63643d837afdf3de019e3b2779842%2Fimage%20(21).png?alt=media" alt="" width="375"><figcaption><p>Le lanceur d'applications</p></figcaption></figure>

### Mettre en place le SSO avec Okta

1. Connectez-vous à la console d'administration Okta.
2. Cliquez sur **Applications > Applications**, puis sur **Create app integration**, choisissez « SAML 2.0 » et cliquez sur **Next**.\
   \\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-f57dfcc56bddc225177b5efcddaaa42d7849b0b1%2Fimage%20(12).png?alt=media" alt=""><figcaption><p>Création d'une nouvelle intégration d'application dans Okta</p></figcaption></figure>
3. À l'étape 1 de l'intégration SAML, saisissez « StableBuild » comme nom d'application, téléversez un logo, puis cliquez sur **Next**.\
   \\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-863f931157b7ec597a1895fb984118557df756d0%2Fimage%20(3)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Création d'une nouvelle application dans Okta</p></figcaption></figure>
4. À l'étape 2, saisissez les informations suivantes (nous les mettrons à jour plus tard) :\
   \
   ![](https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-05526c64bfbe3971fd6c2b9af9e4d419616ad6bf%2Fimage%20\(2\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\).png?alt=media)\\

   * Single sign-on URL : **<http://example.com>**
   * Audience URI (SP Entity ID) : **1234**
   * Default RelayState : *laisser vide*
   * Name ID format : **EmailAddress**

   \
   Cliquez ensuite sur **Next**.
5. Parcourez l'étape 3 et terminez l'assistant.
6. Dans votre application, cliquez sur « Sign On », repérez « SAML Signing Certificates », sélectionnez le certificat « Active » et cliquez sur **View IdP metadata**. Enregistrez ensuite le fichier obtenu (par exemple avec CTRL+S ou CMD+S).\\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-8152fa6f0f62b64134f3e5e6f446b7dc9687cd52%2Fimage%20(5)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Rendez-vous sur « Sign On »</p></figcaption></figure>

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-ec77ed27f3c3e367373505f857b6c70f9ef0ebfa%2Fimage%20(4)%20(1)%20(1)%20(1).png?alt=media" alt=""><figcaption><p>Enregistrez ensuite les métadonnées de l'IdP fournies par Okta</p></figcaption></figure>
7. Rendez-vous sur « Assignments », cliquez sur **Assign > Assign to people** et ajoutez-vous :\
   \\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-1fa6978539b2bfc373e1daa35aad1d3e37846e8f%2Fimage%20(9)%20(1).png?alt=media" alt=""><figcaption><p>Attribution de StableBuild à des personnes depuis Okta</p></figcaption></figure>
8. Ouvrez une nouvelle fenêtre de navigateur (en laissant Okta ouvert), rendez-vous sur le [tableau de bord StableBuild](https://dashboard.stablebuild.com) et cliquez sur **Paramètres > Configurer SAML**.
9. Donnez un nom au fournisseur d'identité (par exemple Okta), sélectionnez le fichier de métadonnées de l'IdP que vous venez de télécharger, puis cliquez sur **Téléverser les métadonnées**.\
   \\

   <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-7c570df4ebf698363c0c22488570ac9cf79ca2ef%2Fimage%20(6)%20(1).png?alt=media" alt=""><figcaption><p>Téléversement des métadonnées de l'IdP Okta dans StableBuild</p></figcaption></figure>
10. Retournez maintenant dans Okta et, dans votre application, choisissez **General**, puis, sous « SAML Settings », cliquez sur **Edit**.\
    \\

    <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-87a92a34aca175c831f90c96b7fc4ba0099693eb%2Fimage%20(7)%20(1).png?alt=media" alt=""><figcaption><p>Modification des paramètres SAML de votre application Okta</p></figcaption></figure>
11. Sous « Configure SAML », copiez les valeurs de StableBuild vers Okta comme ci-dessous. Vous devrez cliquer sur « Show Advanced Settings » pour copier la 4e valeur.\
    \\

    <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-68ff6fb5a72f4da37a8147d583ad96d2c2c6ee66%2Fimage%20(8)%20(1).png?alt=media" alt=""><figcaption><p>Copie des valeurs de StableBuild vers Okta</p></figcaption></figure>
12. Vous devez maintenant vous reconnecter une fois via le SSO. Déconnectez-vous de StableBuild, rendez-vous sur votre tableau de bord d'applications Okta et cliquez sur le logo StableBuild :\
    \\

    <figure><img src="https://3692775141-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq2rcaL74coCkWoi6NPK7%2Fuploads%2Fgit-blob-043b90d2a9a2930eaa78fc393d4143aa1304c00e%2Fimage%20(10)%20(1).png?alt=media" alt=""><figcaption><p>Connexion à StableBuild depuis le tableau de bord d'applications Okta</p></figcaption></figure>
13. Une fois que vous vous êtes connecté au moins une fois via le SSO, vous pouvez l'imposer à tous les membres de votre organisation. Rendez-vous sur **Paramètres** et activez « Imposer la connexion via SAML / SSO ».

Et voilà. Vous avez configuré l'authentification unique pour tous vos utilisateurs avec Okta. 🔐