SAML SSO avec Entra

Microsoft Entra ID est le service cloud de gestion des identités et des accès de Microsoft, anciennement connu sous le nom d’Azure Active Directory. Avec le SSO SAML configuré entre Microsoft Entra et Document360, vos utilisateurs et lecteurs peuvent se connecter à Document360 en utilisant leurs identifiants Microsoft existants, sans avoir besoin d’un mot de passe séparé.

Que pouvez-vous faire avec Microsoft Entra comme IDP

Avant que tu commences

• Vous avez un compte Microsoft Azure actif avec accès administrateur. Connectez-vous à entra.microsoft.com.
• Vous avez l’accès Propriétaire ou Administrateur dans votre projet Document360.
• Ouvrez Document360 et Microsoft Entra dans deux onglets navigateurs distincts. Vous devrez passer plusieurs fois de l’un à l’autre pendant la configuration.

Étape 1 : Créer une application SAML dans Microsoft Entra

Connectez-vous à Microsoft Entra

1. Connectez-vous à votre compte Microsoft Azure à entra.microsoft.com.
2. Vous serez dirigé vers la page du centre d’administration Microsoft Entra .

Créer l’application

1. Dans le centre d’administration Microsoft Entra, sélectionnez Entra ID dans la barre de navigation de gauche et cliquez sur applications Enterprise.
2. Sur la page des applications Entreprise , cliquez sur Nouvelle application > Créer votre propre application.
3. Saisissez un nom pour votre application dans le champ Saisie du nom et cliquez sur Créer.

Étape 2 : Configurez le SAML dans Entra 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 Entra ID comme fournisseur d’identité (IdP) pour naviguer automatiquement vers la page Configurer le fournisseur de services (SP).

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

Configurez SAML dans Entra

1. Allez dans Microsoft Entra, et sur la page de l’application créée, ouvrez l’onglet Connexion unique et sélectionnez méthode SAML .

2. Cliquez sur Modifier dans la section Configuration SAML de base et entrez les paramètres de Document360 comme indiqué ci-dessous.

3. Cliquez sur Enregistrer.

Étape 3 : Terminer la configuration SSO dans Document360

Configurez le fournisseur d’identité dans Document360

1. Retournez à Document360 et cliquez sur Suivant pour accéder à la page Configurer le fournisseur d’identité (IdP ).
2. Si vous avez déjà une configuration SSO existante, vous pouvez la sélectionner dans la menu déroulante Configurer une connexion existante pour hériter de ses paramètres. Cela élimine la configuration redondante et fait gagner du temps.

3. Remplissez les champs requis en utilisant les paramètres trouvés dans la section SSO de Configurer Document360 SCIM de la page Entra, comme indiqué ci-dessous.

4. Téléchargez le Certificat (Base64) dans la section Certificats SAML et attachez-le au champ du certificat SAML dans Document360.

5. Activez ou désactivez l’option Permettre la connexion initiée IdP en fonction des exigences de votre projet. En savoir plus sur la connexion initiée par l’IDP.
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 utilisateur et lecteur entre Microsoft Entra et Document360. Une fois activés, les utilisateurs ajoutés, mis à jour ou désactivés dans Entra sont automatiquement synchronisés avec Document360.

Si vous n’avez pas besoin de provisionnement SCIM, cliquez sur Suivant et suivez les étapes de l’étape 5 : Plus de paramètres.

Activez SCIM dans Document360

1. Dans la page de provisionnement SCIM dans Document360, activez le bouton Activer le provisionnement SCIM .
2. Une boîte de dialogue de confirmation apparaîtra. Lisez les conditions et cliquez sur Accepter. Un ensemble de paramètres sera alors affiché.

Configurez la provisionnement SCIM dans Entra

1. Allez dans Entrée, sélectionnez l’onglet Provisionnement dans le menu de gauche, puis sélectionnez Nouvelle configuration dans le menu supérieur.

2. La page de configuration du nouveau provisionnement s’affichera. Remplissez les champs de la section Identifiants administrateur en utilisant les paramètres de Document360 comme indiqué ci-dessous.

Définir les rôles et groupes par défaut dans Document360

1. Retournez dans Document360 et activez l’option Activer la synchronisation de groupe . Une fois activé, les utilisateurs et les groupes de lecteurs sont automatiquement attribués selon les 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. Assignation 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 inactif SSO si nécessaire, et définissez la durée d’inactivité.
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 dans Document360 est créée avec succès.

Étape 6 : Effectuer le provisionnement SCIM dans Entra

Tester et sauvegarder la connexion SCIM

1. Retournez à Entra, où la page de configuration du nouveau provisionnement s’affiche.
2. Une fois tous les champs requis remplis, cliquez sur Tester la connexion pour vérifier la configuration.

3. Un message de confirmation apparaîtra une fois que la connexion de provisionnement SCIM entre Entra et Document360 sera réussie.
4. Cliquez sur Créer pour finaliser la configuration.

Le provisionnement SCIM entre Entra et Document360 a été créé avec succès.

Meilleures pratiques

• Créez une application hors galerie. Utilisez toujours l’option Intégrer toute autre application que vous ne trouvez pas dans la galerie lors de la création de votre application Entra. Les applications de galerie ne prennent pas en charge le provisionnement SCIM personnalisé.
• Stockez les deux jetons secrets en toute sécurité. Traitez les jetons SCIM principaux et secondaires comme des mots de passe. Stockez-les dans un gestionnaire de secrets ou un coffre-fort de mots de passe, pas dans des fichiers texte bruts ou des dépôts de code.
• Ne testez pas la connexion SCIM avant d’enregistrer la configuration Document360. Le test échouera à ce stade. Complétez toujours et enregistrez d’abord la configuration SSO de Document360, puis retournez à Entra pour tester.
• Définissez la correspondance des attributs au niveau utilisateur, pas au niveau du groupe. Lors de la configuration de l’attribut isTeamAccount , définissez-le toujours au niveau utilisateur afin d’éviter les conflits de provisionnement pour les utilisateurs appartenant à plusieurs groupes.
• Alignez le délai d’arrêt d’inactivité avec votre politique de sécurité. Activez la déconnexion de l’utilisateur SSO inactif et réglez la durée pour qu’elle corresponde aux besoins de gestion de session de votre organisation.

FAQ