Authentification unique et SCIM (Enterprise)

Laissez votre équipe se connecter à FolianX avec votre fournisseur d'identité, et provisionnez ou déprovisionnez les membres automatiquement. SAML 2.0 pour l'authentification unique, SCIM 2.0 pour le cycle de vie des utilisateurs. Les captures ci-dessous utilisent JumpCloud ; Okta, Microsoft Entra ID et tout fournisseur SAML/SCIM suivent le même schéma.

L'authentification unique et SCIM font partie de l'offre Enterprise. Vous les configurez depuis Paramètres → SSO, et tout ce que vous collez dans votre fournisseur d'identité (IdP) provient de cette même page.

Avant de commencer

  • Votre organisation est sur l'offre Enterprise.
  • Vous êtes administrateur de votre organisation FolianX.
  • Vous pouvez administrer votre IdP (créer une application SAML, gérer les utilisateurs et les groupes).

Partie 1 — Authentification unique (SAML)

1. Créez une application SAML dans votre IdP

Dans JumpCloud, allez dans SSO Applications → Add New Application → Custom Application, puis activez Manage Single Sign-On (SSO) avec Configure SSO with SAML. (Cochez aussi Export users to this app si vous voulez également le provisionnement SCIM — Partie 2.)

JumpCloud : création d'une application personnalisée avec SSO et provisionnement activés
Création d'une application personnalisée et activation du SSO (et, en option, du provisionnement).

2. Faites pointer l'application vers FolianX

L'URL de l'Assertion Consumer Service (ACS) de FolianX est :

https://folianx.com/sso/saml/acs

Saisissez une valeur de votre choix pour le SP Entity ID (par exemple folianx) — vous mettrez la même valeur dans FolianX à l'étape 5, afin que les deux côtés concordent.

Configuration SAML de JumpCloud : SP Entity ID et URL ACS
Les paramètres du fournisseur de service SAML : le SP Entity ID et l'URL ACS de FolianX.

3. Réglez le sujet, le format et — surtout — la signature

  • SAML Subject NameID : email
  • Format du NameID : urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress
  • Associez l'attribut e-mail à http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.

Signez l'assertion, pas seulement la réponse. FolianX exige que l'assertion SAML elle-même soit signée. Réglez Sign sur Assertion and Response (ou au moins Assertion). Si vous laissez la valeur par défaut Response seule, la connexion échoue avec « SSO authentication failed: invalid response ».

JumpCloud : NameID e-mail, format emailAddress, et Sign réglé sur Assertion and Response
NameID email, format emailAddress, et Sign → Assertion and Response.

4. Affectez vos utilisateurs

Dans JumpCloud, les utilisateurs accèdent à une application via un groupe d'utilisateurs : créez un groupe, ajoutez vos membres et rattachez le groupe à l'application depuis son onglet User Groups.

5. Configurez le SSO dans FolianX

Exportez les métadonnées IdP de votre application et copiez trois valeurs dans Paramètres → SSO de FolianX :

  • IdP Entity ID — l'IdP Entity ID de l'application.
  • IdP SSO URL — l'URL de connexion SSO de l'application.
  • Certificat IdP X.509 — le certificat de signature, au format PEM.

Réglez le SP Entity ID sur la même valeur qu'à l'étape 2, puis cliquez sur Configurer le SSO.

FolianX Paramètres → SSO : le formulaire de configuration SAML et la section des jetons SCIM
FolianX Paramètres → SSO : le formulaire SAML (en haut) et la section des jetons SCIM (en bas).

6. Activez le provisionnement Just-in-Time

Une fois la configuration enregistrée, cochez Enable Just-in-Time user provisioning pour qu'un membre qui se connecte pour la première fois obtienne automatiquement un compte FolianX. Comme un nouveau membre consomme un siège, vous devez aussi cocher Auto-bill JIT-provisioned users — sinon un utilisateur SSO inconnu est refusé avec « Your account has not been provisioned ».

C'est tout — un utilisateur rattaché peut désormais se connecter via votre IdP et arriver directement dans son espace de travail.

Partie 2 — Provisionnement automatique (SCIM)

SCIM permet à votre IdP de créer, mettre à jour et désactiver automatiquement les membres FolianX, afin que les arrivées et les départs soient gérés au même endroit.

1. Générez un jeton SCIM dans FolianX

Dans Paramètres → SSO, sous SCIM Provisioning Tokens, donnez un nom au jeton, définissez éventuellement un plafond max seats et cochez Allow auto-billing on user creation pour que les utilisateurs provisionnés puissent occuper un siège. Cliquez sur Generate Token — le jeton n'est affiché qu'une fois, copiez-le donc immédiatement.

2. Ajoutez le provisionnement dans votre IdP

Dans l'onglet Provisioning de l'application, choisissez SCIM API avec l'authentification par Bearer token et saisissez :

  • URL de base : https://folianx.com/scim/v2
  • Token Key : le jeton SCIM que vous venez de générer.
Provisionnement JumpCloud : SCIM API, bearer token et URL de base FolianX
Provisionnement SCIM : URL de base https://folianx.com/scim/v2 et bearer token.

3. Testez et activez

Lancez Test Connection ; une fois le test réussi, cliquez sur Activate. Le provisionnement devient actif — les membres ajoutés à l'application dans votre IdP sont créés dans FolianX, les mises à jour se propagent, et retirer un membre désactive son compte FolianX.

JumpCloud : provisionnement actif
Provisionnement actif — le cycle de vie des utilisateurs se synchronise désormais de votre IdP vers FolianX.

Dépannage

SymptômeSolution
« SSO authentication failed: invalid response ».Réglez l'IdP pour qu'il signe l'assertion (voir l'encadré de l'étape 3) et vérifiez que le SP Entity ID concorde des deux côtés.
« Your account has not been provisioned ».Activez Auto-bill JIT-provisioned users dans la configuration SSO, ou invitez l'utilisateur depuis Paramètres → Équipe.
« Test Connection » SCIM échoueVérifiez que l'URL de base est exactement https://folianx.com/scim/v2, que le jeton est à jour et qu'il a l'auto-facturation activée, avec de la marge sous son plafond de sièges.

Toujours bloqué ? Contactez-nous — précisez votre IdP et l'erreur exacte, nous vous aiderons.