Tutoriel : intégration de l’authentification unique Microsoft Entra avec Envoy

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

  • Contrôler dans Microsoft Entra ID qui a accès à Envoy.
  • Permettre à vos utilisateurs d’être automatiquement connectés à Envoy avec leur compte 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 Envoy pour lequel l’authentification unique est activée

Remarque

Cette intégration est également disponible à partir de l’environnement Microsoft Entra US Government Cloud. Vous pouvez trouver cette application dans la galerie d’applications Microsoft Entra US Government Cloud et la configurer de la même manière que vous le faites à partir du cloud public.

Description du scénario

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

  • Envoy prend en charge l'authentification unique initiée par le fournisseur de services.

  • Envoy prend en charge l'attribution d'utilisateurs juste-à-temps.

  • Envoy prend en charge l’attribution automatique d’utilisateurs.

Notes

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 Envoy dans Microsoft Entra ID, vous devez ajouter Envoy depuis la galerie à votre liste d’applications SaaS managé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, tapez Envoy dans la zone de recherche.
  4. Sélectionnez Envoy dans le volet de 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 Envoy

Configurez et testez Microsoft Entra SSO avec Envoy à l'aide d'un utilisateur test appelé B.Simon. Pour que l’authentification unique fonctionne, vous devez établir un lien entre un utilisateur Microsoft Entra et l'utilisateur associé dans Envoy.

Pour configurer et tester Microsoft Entra SSO avec Envoy, 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 unique Envoy pour configurer les paramètres de l’authentification unique côté application.
    1. Créer un utilisateur test Envoy pour avoir un équivalent de B.Simon en lien avec 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>Envoy>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, effectuez l’étape suivante :

    Dans la zone de texte URL de connexion, tapez une URL au format suivant : https://app.envoy.com/a/saml/auth/<company-ID-from-Envoy>.

    Remarque

    Cette valeur n’est pas la valeur réelle. Mettez à jour la valeur avec l’URL de connexion réelle. Pour obtenir cette valeur, contactez l’équipe du support client Envoy. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.

  6. Dans la section Certificat de signature SAML, cliquez sur le bouton Modifier pour ouvrir la boîte de dialogue Certificat de signature SAML.

    Edit SAML Signing Certificate

  7. Dans la section Certificat de signature SAML, copiez la valeur de l’empreinte et enregistrez-la sur votre ordinateur.

    Copy Thumbprint value

  8. Dans la section Configurer Envoy, copiez la ou les URL appropriées, en fonction de 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 accordant l'accès à Envoy.

  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>Envoy.
  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 unique Envoy

  1. Dans une autre fenêtre du navigateur Web, connectez-vous à votre site d’entreprise Envoy en tant qu’administrateur

  2. Accédez à Intégrations>Toutes les intégrations, puis cliquez pour Installer SAML sous Authentification unique.

    SAML Authentication

  3. Accédez à la section Enabled integrations (Intégrations activées) et procédez comme suit :

    Single sign-on

    Remarque

    La valeur de l’ID d’emplacement du siège est générée automatiquement par l’application.

    a. Dans la zone de texte Fingerprint , collez la valeur Thumbprint du certificat.

    b. Collez la valeur URL de connexion copiée dans le portail Azure dans la zone de texte IDENTITY PROVIDER HTTP SAML URL (URL HTTP SAML du fournisseur d’identité).

    c. Cliquez sur Enregistrer.

Créer un utilisateur de test Envoy

Dans cette section, un utilisateur appelé Britta Simon est créé dans Envoy.

Envoy prend aussi en charge l’attribution automatique d’utilisateurs. Vous trouverez ici plus d’informations sur la façon de configurer l’attribution automatique d’utilisateurs.

Tester l’authentification unique (SSO)

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

  • Cliquez sur Tester cette application, ce qui redirigera vers l'URL de connexion Envoy où vous pourrez initier le flux de connexion.

  • Accédez directement à l'URL de connexion à Envoy pour lancer le processus de connexion.

  • Vous pouvez utiliser Mes applications de Microsoft. Le fait de cliquer sur la vignette Envoy dans Mes applications vous redirige vers l'URL de connexion à Envoy. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Après avoir configuré Envoy, vous pouvez appliquer le contrôle de session, qui protège en temps réel contre l'exfiltration et l'infiltration des données sensibles de votre organisation. 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.