Partager via

Tutoriel : Intégration de l'authentification unique (SSO) de Microsoft Entra avec Documo

  • Article

Dans ce didacticiel, vous apprendrez comment intégrer Documo à Microsoft Entra ID. Lorsque vous intégrez Documo à Microsoft Entra ID, vous pouvez :

  • Contrôlez dans Microsoft Entra ID qui a accès à Documo.
  • Permettez à vos utilisateurs d'être automatiquement connectés à Documo avec leurs comptes Microsoft Entra.
  • Gérer vos comptes à partir d’un emplacement central.

Prérequis

Pour commencer, vous devez disposer de ce qui suit :

  • Un abonnement Microsoft Entra. Si vous ne disposez d’aucun abonnement, vous pouvez obtenir un compte gratuit.
  • Un abonnement Documo pour lequel l’authentification SSO (authentification unique) est activée.

Description du scénario

Dans ce tutoriel, vous configurez et testez Microsoft Entra SSO dans un environnement de test.

Remarque

L’identificateur de cette application étant une valeur de chaîne fixe, une seule instance peut être configurée dans un locataire.

Pour configurer l'intégration de Documo dans Microsoft Entra ID, vous devez ajouter Documo depuis la galerie à votre liste d'applications SaaS gérées.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.
  3. Dans la section Ajouter à partir de la galerie, dans la zone de recherche, tapez Documo.
  4. Sélectionnez Documo dans le panneau Résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez également utiliser l’assistant Entreprise App Configuration. Dans cet assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, mais également parcourir la configuration de l’authentification unique. En savoir plus sur les assistants Microsoft 365.

Configurer et tester Microsoft Entra SSO pour Documo

Configurez et testez Microsoft Entra SSO avec Documo à l'aide d'un utilisateur test appelé B.Simon. Pour que SSO fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l'utilisateur associé dans Documo.

Pour configurer et tester Microsoft Entra SSO avec Documo, effectuez les étapes suivantes :

  1. Configurer Microsoft Entra SSO – pour permettre à vos utilisateurs d'utiliser cette fonctionnalité.
    1. Créez un utilisateur de test Microsoft Entra pour tester l’authentification unique Microsoft Entra avec B.Simon.
    2. Attribuer l’utilisateur test Microsoft Entra – pour permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra.
  2. Configurer l’authentification SSO pour Documo afin de configurer les paramètres d’authentification unique côté application.
    1. Créer un utilisateur test Documo – avoir un homologue de B.Simon dans Documo qui est lié à la représentation Microsoft Entra de l'utilisateur.
  3. Tester l’authentification unique pour vérifier si la configuration fonctionne.

Configurer Microsoft Entra SSO

Effectuez ces étapes pour activer l’authentification unique Microsoft Entra.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez à Identité>Applications>Applications d’entreprise>Documo>Authentification unique.

  3. Dans la page Sélectionner une méthode d’authentification unique, sélectionnez SAML.

  4. Dans la page Configurer l’authentification unique avec SAML, cliquez sur l’icône de crayon de Configuration SAML de base afin de modifier les paramètres.

    Edit Basic SAML Configuration

  5. Dans la section Configuration SAML de base, l’utilisateur n’a rien à faire, car l’application est déjà intégrée à Azure. Si votre compte Documo a un domaine personnalisé, vous devez également disposer d’un domaine d’API personnalisé pour que l’authentification unique fonctionne. Remplacez les valeurs par défaut par votre domaine d’API personnalisé, par exemple https://mycustomapidomain.com et https://mycustomapidomain.com/assert.

  6. Si vous souhaitez configurer l’application en mode démarré par le fournisseur de services, cliquez sur Définir des URL supplémentaires, puis effectuez les étapes suivantes :

    Dans la zone de texte URL de connexion, tapez l’URL :
    https://app.documo.com/sso

  7. Cliquez sur Enregistrer.

  8. Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, recherchez XML de métadonnées de fédération et sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

    The Certificate download link

  9. Dans la section Configurer Documo, copiez l’URL ou les URL appropriées selon vos besoins.

    Copy configuration URLs

Créer un utilisateur de test Microsoft Entra

Dans cette section, vous allez créer un utilisateur de test appelé B.Simon.

  1. Connectez-vous au Centre d’administration de Microsoft Entra en tant qu’Administrateur de l’utilisateur.
  2. Accédez à Identité>Utilisateurs>Tous les utilisateurs.
  3. Sélectionnez Nouvel utilisateur>Créer un utilisateur dans la partie supérieure de l’écran.
  4. Dans les propriétés Utilisateur, effectuez les étapes suivantes :
    1. Dans le champ Nom d’affichage, entrez B.Simon.
    2. Dans le champ Nom d’utilisateur principal, entrez username@companydomain.extension. Par exemple : B.Simon@contoso.com.
    3. Cochez la case Afficher le mot de passe, puis notez la valeur affichée dans le champ Mot de passe.
    4. Sélectionnez Revoir + créer.
  5. Sélectionnez Create (Créer).

Attribuer l’utilisateur test Microsoft Entra

Dans cette section, vous allez permettre à B.Simon d’utiliser l’authentification unique en lui accordant l’accès à Documo.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Accédez à Identité>Applications>Applications d’entreprise>Documo.
  3. Dans la page de présentation de l’application, sélectionnez Utilisateurs et groupes.
  4. Sélectionnez Ajouter un utilisateur/groupe, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
    1. Dans la boîte de dialogue Utilisateurs et groupes, sélectionnez B. Simon dans la liste Utilisateurs, puis cliquez sur le bouton Sélectionner au bas de l’écran.
    2. Si vous attendez qu’un rôle soit attribué aux utilisateurs, vous pouvez le sélectionner dans la liste déroulante Sélectionner un rôle . Si aucun rôle n’a été configuré pour cette application, vous voyez le rôle « Accès par défaut » sélectionné.
    3. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification SSO pour Documo

  1. Connectez-vous à votre site web Documo en tant qu’administrateur.

  2. Accédez à Paramètres de compte ->Sécurité.

    screenshot for security page.

  3. Sous l’onglet Security, cliquez sur le bouton Configure SSO (Configurer l’authentification SSO) situé au bas de la page.

    screenshot for configure button.

  4. Effectuez les étapes suivantes dans la page Setup SAML (Configurer SAML).

    screenshot for configuration page.

    a. Dans la zone de texte Entity Id, collez la valeur Microsoft Entra Identifier que vous avez copiée précédemment.

    b. Dans la zone de texte URL d’authentification unique (URL de redirection), collez la valeur de l’URL de connexion que vous avez copiée précédemment.

    c. Indiquez la valeur de Email Domain (Domaine d’e-mail) dans la zone de texte correspondante.

    d. Entrez la valeur appropriée dans la zone de texte Field Name in SAML Token containing Identity email (Nom de champ dans le jeton SAML contenant l’e-mail d’identité).

    e. Ouvrez le fichier XML de métadonnées de fédération téléchargé dans le Bloc-notes. Recherchez l’étiquette <X509Certificate> et collez le contenu dans la zone de texte Signer Certificate (Certificat de signataire).

    f. Cliquez sur Envoyer.

Créer l’utilisateur de test Documo

Dans cette section, un utilisateur appelé B.Simon est créé dans Documo.

  1. Accédez à la page Utilisateurs de l’application Documo.
  2. Cliquez sur le bouton Nouvel utilisateur.
  3. Remplissez le formulaire utilisateur avec le nom, l’adresse e-mail, le numéro de téléphone, le rôle d’utilisateur et les informations de mot de passe. Assurez-vous que le champ Email correspond à l'e-mail de B.Simon dans Microsoft Entra ID.
  4. Cliquez sur Créer.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

Lancée par le fournisseur de services :

  • Cliquez sur Tester cette application. Vous êtes alors redirigé vers l’URL d’authentification de Documo à partir de laquelle vous pouvez lancer le flux de connexion.

  • Accédez directement à l’URL de connexion à Documo, puis lancez le flux de connexion à partir de cet emplacement.

Lancée par le fournisseur d’identité :

  • Cliquez sur Tester cette application, ce qui devrait automatiquement vous connecter à l’application Documo pour laquelle vous avez configuré l’authentification unique.

Vous pouvez aussi utiliser Mes applications de Microsoft pour tester l’application dans n’importe quel mode. Si, quand vous cliquez sur la vignette Documo dans Mes applications, le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l’application pour lancer le flux de connexion ; s’il s’agit du mode Fournisseur d’identité, vous êtes automatiquement connecté à l’instance de Documo pour laquelle vous avez configuré l’authentification SSO. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Une fois que vous avez configuré Documo, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.