SAML SSO avec d’autres configurations

Document360 prend en charge le SSO SAML avec tout fournisseur d’identité (IdP) qui prend en charge le protocole SAML 2.0, même s’il n’est pas explicitement listé dans les options IdP de Document360. Cet article vous guide dans la configuration du SSO entre Document360 et un fournisseur d’identité personnalisé ou non listé.

Ce que vous pouvez faire avec un IdP personnalisé

Avant que tu commences

• Vous disposez des identifiants nécessaires et de l’accès administratif à la fois à Document360 et au fournisseur d’identité de votre choix.
• Vous avez l’accès Propriétaire ou Administrateur dans votre projet Document360.
• Votre fournisseur d’identité prend en charge le SAML 2.0.
• Ouvrez Document360 et votre fournisseur d’identité dans deux onglets de navigateur distincts. Vous devrez passer plusieurs fois de l’un à l’autre pendant la configuration.

Étape 1 : Créer une application SAML dans votre fournisseur d’identité

Ajoutez une nouvelle application dans votre IDP

1. Connectez-vous à la console d’administration de votre fournisseur d’identité.
2. Localisez la section où vous pouvez créer ou gérer des applications (souvent appelée Applications, Applications d’entreprise ou similaire).
3. Sélectionnez l’option pour créer une nouvelle application.
4. Configurez les paramètres de base pour la nouvelle application :
   • Nom de la demande : Saisissez un nom, par exemple « Document360 SSO ».
   • Type d’application : Sélectionnez SAML 2.0 comme méthode de connexion.
5. Sauvegardez les paramètres de votre application.

Étape 2 : Configurez le SAML dans votre IdP en utilisant les paramètres Document360

Obtenez les paramètres du fournisseur de services via Document360

1. Ouvrez Document360 dans un onglet séparé.
2. Naviguez dans Paramètres () > Utilisateurs et permissions > Configuration SSO.
3. Cliquez sur Créer SSO.

4. Sélectionnez Autres comme fournisseur d’identité (IdP) pour accéder automatiquement à la page Configurer le fournisseur de services (SP ).

5. La page Configurer le fournisseur de service (SP) affiche les paramètres nécessaires pour configurer le SAML dans votre fournisseur d’identité.

Saisissez les paramètres Document360 dans votre IdP

Dans la configuration SAML de votre fournisseur d’identité, saisissez les paramètres Document360 à l’aide de la correspondance ci-dessous.

Configurez l’attribution de l’attribution dans votre IdP

Vous devrez peut-être configurer des instructions d’attribut dans votre fournisseur d’identité. Ajoutez les attributs suivants.

Complétez toute configuration supplémentaire dans votre IdP

1. Fournissez toute information supplémentaire de configuration requise par votre fournisseur d’identité.
2. Reviens tes paramètres et enregistre la configuration SAML.
3. Cliquez sur Suivant dans Document360 pour accéder à la page Configurer le fournisseur d’identité (IdP ).

Étape 3 : Terminer la configuration SSO dans Document360

Configurez le fournisseur d’identité dans Document360

1. Retournez à l’onglet Document360 affichant la page Configurer le fournisseur d’identité (IdP ).
2. Le champ Configurer une connexion existante vous permet d’hériter d’une configuration SSO déjà créée. En sélectionnant cette option, la configuration SSO actuelle sera définie comme enfant et aucune modification ne pourra être apportée.

3. Saisissez les valeurs correspondantes de votre fournisseur d’identité en utilisant la correspondance ci-dessous.

4. Téléchargez le certificat X.509 auprès de votre fournisseur d’identité et téléchargez-le dans le champ Certificat SAML dans Document360.
5. Activez ou désactivez l’option Permettre la connexion initiée IdP en fonction des exigences de votre projet.

6. Cliquez sur Suivant pour accéder à la page de provisionnement SCIM .

Étape 4 : Configurer le provisionnement SCIM

Le provisionnement SCIM automatise la gestion du cycle de vie des utilisateurs et des lecteurs entre votre fournisseur d’identité et Document360. Ceci est disponible si votre IDP prend en charge le SCIM.

Si vous n’avez pas besoin de provisionnement SCIM, passez à l’étape 5 : Plus de paramètres.

Activez SCIM dans Document360

1. Activez le bouton Activer la provision SCIM .
2. Une boîte de dialogue de confirmation apparaît. Consultez les conditions, sélectionnez la case à cocher, puis cliquez sur Accepter.

3. Un ensemble de paramètres sera alors affiché — utilisez-les pour activer le provisionnement SCIM dans votre IDP.

Attribuer le rôle et les groupes par défaut dans Document360

1. Activez la synchronisation de groupe si besoin. Cela assigne automatiquement les utilisateurs et lecteurs en fonction de vos correspondances de groupes IdP.
2. Dans le champ de rôle par défaut , le rôle est défini par défaut sur Contributeur . Vous pouvez changer cela depuis le menu déroulant si besoin.
3. Dans les champs Groupes d’utilisateurs et Groupes de lecteurs , sélectionnez les groupes que vous souhaitez ajouter. Plusieurs groupes peuvent être ajoutés, et ils hériteront du rôle par défaut que vous avez sélectionné plus tôt.
4. Cliquez sur Suivant pour accéder à la page Paramètres supplémentaires .

Étape 5 : Plus de réglages

Configurez le nom SSO et les options de connexion

1. Dans le champ nom SSO , saisissez un nom pour la configuration SSO.
2. Dans le bouton Personnaliser la connexion, saisissez le texte du bouton de connexion affiché aux utilisateurs.
3. Attribution automatique du groupe de lecteurs — cette option n’est disponible que pour les configurations SSO existantes. Pour les nouvelles configurations SSO, ce basculement ne sera pas affiché car SCIM fournit automatiquement les utilisateurs et les groupes. En savoir plus sur le groupe de lecteurs Auto Assign.
4. Activez la déconnexion de l’utilisateur SSO inactif si besoin, et basculez selon vos besoins.
5. Choisissez d’inviter les comptes utilisateurs et lecteurs existants à SSO.

6. Cliquez sur Créer pour compléter la configuration SSO.

La configuration SSO sera désormais configurée dans Document360 en utilisant le fournisseur d’identité que vous avez choisi.

Héritage d’une autre application

Lors de la création d’une nouvelle configuration SSO dans Document360, vous pouvez hériter des paramètres SCIM d’une connexion SSO existante. Cela simplifie le processus de configuration, évite la répétition des étapes de configuration et aide les administrateurs à gagner du temps tout en assurant la cohérence entre les intégrations.

Configuration SSO héritée par enfant

Sur la page Configurer le fournisseur d’identité (IdP ), sélectionnez le champ Configurer une connexion existante et sélectionnez l’application parent compatible SCIM SSO dont vous souhaitez hériter. Sélectionner cette option désigne le projet en cours comme projet enfant, héritant de toutes les propriétés pertinentes du parent concerné.

Configuration SSO héritée par le parent

L’application mère affichera une liste de tous les projets ayant hérité de sa configuration. Toute modification apportée à l’application mère sera automatiquement reflétée dans l’application enfant.

• Si SCIM est activé dans le projet parent après que les projets enfants l’ont déjà hérité, les utilisateurs et groupes seront automatiquement provisionnés sur tous les projets enfants en arrière-plan.
• Activer l’héritage facilite la gestion de plusieurs configurations SSO avec SCIM activé, car tous les paramètres sont contrôlés depuis une application parente. Cela permet de gagner du temps et réduit l’effort nécessaire pour gérer chaque configuration individuellement.

Meilleures pratiques

• Vérifiez le support SAML 2.0 avant de commencer. Confirmez que votre fournisseur d’identité prend en compte le protocole SAML 2.0. Document360 ne prend pas en charge SAML 1.x ni protocoles SSO propriétaires.
• Vérifiez attentivement la casse des noms d’attributs. Les noms email des attributs et name sont sensibles à la majuscule. Assurez-vous qu’elles sont saisies exactement comme indiqué dans le tableau de mappage des attributs.
• Téléchargez et stockez le certificat X.509 avant de terminer la configuration. Vous devrez télécharger ce fichier sur Document360. Gardez une copie dans un endroit sécurisé au cas où vous auriez besoin de reconfigurer.
• Testez d’abord avec un seul utilisateur. Avant de déployer SSO à tous les utilisateurs, vérifiez la configuration avec un compte de test pour confirmer que la correspondance des attributs, les certificats et les URL fonctionnent correctement.

FAQ