Configurez la connexion unique (SSO) pour que vos utilisateurs et lecteurs se connectent à Document360 avec un compte qu’ils possèdent déjà, au lieu d’un mot de passe séparé pour Document360. Cet article vous aide à choisir la bonne méthode SSO, à comprendre ce que les gens voient lors de leur connexion, et à lancer la configuration.
Document360 prend en charge trois méthodes :
- SAML 2.0 et OpenID Connect (OIDC) : Les personnes se connectent via votre fournisseur d’identité, tel qu’Okta, Microsoft Entra ID ou Google Workspace.
- JWT (JSON Web Token) : Votre propre application connecte les lecteurs et transmet un jeton vérifié à Document360, sans qu’aucun fournisseur d’identité ne soit impliqué.
Fonctionnement de la connexion SSO
La SSO implique deux parties :
- Fournisseur d’identité (IdP) : Le service qui stocke et vérifie les identifiants, tels qu’Okta, Microsoft Entra ID, Google Workspace, ADFS ou OneLogin.
- Fournisseur de services (SP) : Document360. Il s’appuie sur l’IDP pour confirmer qui se connecte.
Avec SAML ou OpenID Connect, la connexion fonctionne de la même manière pour les utilisateurs et les lecteurs :
- Un utilisateur ouvre le portail de la base de connaissances, ou un lecteur ouvre votre site de base de connaissances. Il saisit soit son adresse e-mail sur la page de connexion, soit sélectionne d’abord le bouton SSO.
- Document360 trouve la configuration SSO correspondante et les envoie à la page de connexion de votre IDP.
- Ils se connectent avec leurs identifiants IDP. Ils n’entrent jamais de mot de passe dans Document360.
- L’IdP confirme son identité et renvoie un jeton signé à Document360.
- Document360 vérifie le jeton et leur donne accès en fonction de leur rôle et de leurs permissions.
S’ils se sont déjà connectés à votre IDP pour une autre application, ils n’ont pas besoin de se reconnecter. Avec le SAML, vous pouvez aussi permettre aux gens d’ouvrir Document360 directement depuis le tableau de bord de votre IDP. Pour savoir comment faire, lisez la connexion initiée par IDP.
Avec JWT, il n’y a ni IdP ni redirection. Votre application crée et signe le jeton, et Document360 le vérifie directement.
Choisir une méthode SSO
| SAML 2.0 | OpenID Connect | JWT | |
|---|---|---|---|
| Choisis-le si | Vous utilisez un IdP d’entreprise ou sur site, tel qu’ADFS, ou Okta, Microsoft Entra ID, Google Workspace ou OneLogin | Vous utilisez un IDP basé sur le cloud, comme Okta ou Auth0, ou ADFS avec OpenID Connect | Vous gérez la connexion dans votre propre application et souhaitez connecter les lecteurs à partir de là |
| Qui peut se connecter | Utilisateurs et lecteurs | Utilisateurs et lecteurs | Lecteurs uniquement |
| Besoin d’un IDP | Oui | Oui | Non |
| Effort de mise en place | Moyen | Moyen | Plus haut : nécessite un développement personnalisé |
| Provisionnement SCIM | Okta et Microsoft Entra ID ; OneLogin uniquement pour les lecteurs ; ADFS via des outils tiers ; d’autres IDP supportant SCIM. Non disponible avec Google Workspace. | Okta ; ADFS via des outils tiers ; d’autres IDP qui prennent en charge SCIM. Non disponible avec Auth0. | Non disponible |
Méthodes de combinaison
- Vous pouvez avoir plusieurs configurations SAML actives en même temps, ou plusieurs configurations OpenID Connect, par exemple une IdP pour vos utilisateurs et une autre pour vos lecteurs.
- SAML et OpenID Connect ne peuvent pas être actifs en même temps. Pour passer de l’un à l’autre, désactivez la configuration que vous ne souhaitez plus utiliser.
- Vous pouvez ajouter jusqu’à cinq configurations JWT en plus de vos configurations SAML ou OpenID Connect.
Mettre en place SSO
Avant que tu commences
- Vous avez besoin du rôle de Propriétaire ou d’Administrateur dans votre projet Document360.
- Assurez-vous d’avoir un accès administrateur à votre IDP, ou, pour JWT, à un développeur capable de mettre à jour le code de connexion de votre application.
- Décidez quelle méthode vous utiliserez. Voir Choisir une méthode SSO.
Chaque configuration SSO commence au même endroit dans Document360 :
- Va dans Paramètres > Utilisateurs et Permissions > SSO Entreprise.
- Sélectionnez Créer SSO.
- Sélectionnez SAML, OpenID Connect ou JWT.
- Si vous avez sélectionné SAML ou OpenID Connect, sélectionnez votre fournisseur d’identité. L’assistant de configuration s’ouvre.
- Complétez l’assistant en utilisant le guide de votre méthode.
Configurer JWT
Connectez vos lecteurs à votre site de base de connaissances depuis votre propre application.
En savoir plus →Quand vous avez terminé, la configuration apparaît dans la liste SSO Enterprise avec toutes vos autres configurations SSO. Vous pouvez la modifier, réordonner ou supprimer à partir de là.
Les utilisateurs et lecteurs qui se connectent via SSO utilisent leurs identifiants IdP, pas un mot de passe Document360. Vous ne pouvez pas vous bloquer : un administrateur ne peut pas supprimer son propre access, seulement celui d’un autre administrateur.
Après avoir configuré SSO
Lorsque votre configuration SSO fonctionne, configurez le provisionnement automatique et gérez qui peut se connecter. SCIM est disponible uniquement pour SAML et OpenID Connect.
Configurez le provisionnement SCIM
Ajoute, mettez à jour et désactivez les utilisateurs et lecteurs dans votre IDP, et Document360 se met à jour automatiquement.
En savoir plus →Gérer l’accès SSO
Ajoutez des utilisateurs, gérez les lecteurs, cartographiez les projets et contrôlez les paramètres de connexion.
En savoir plus →FAQ
Puis-je utiliser SAML et OpenID Connect en même temps ?
Non. Un projet peut avoir SAML ou OpenID Connect activé, mais pas les deux. Pour changer, désactivez la configuration que vous ne souhaitez plus utiliser. L’un ou l’autre peut fonctionner en même temps que JWT.
Puis-je configurer SSO pour les utilisateurs et les lecteurs ?
Oui. SAML et OpenID Connect fonctionnent pour les utilisateurs qui se connectent au portail de la base de connaissances, et pour les lecteurs, qui se connectent au site de la base de connaissances. JWT fonctionne uniquement pour les lecteurs et ne peut pas être utilisé pour se connecter au portail.
Puis-je avoir plus d’une configuration SSO dans un projet ?
Oui. Vous pouvez avoir plusieurs configurations SAML ou plusieurs configurations OpenID Connect actives en même temps, par exemple une IdP pour vos utilisateurs et une autre pour vos lecteurs. Vous pouvez aussi ajouter jusqu’à cinq configurations JWT en même temps.