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.)
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.
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 ».
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.
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.
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.
Dépannage
| Symptôme | Solution |
|---|---|
| « 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 échoue | Vé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.