Tutoriel : intégration de l’authentification unique (SSO) Microsoft Entra avec TextMagic

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

  • Contrôler les accès à TextMagic depuis Microsoft Entra ID.
  • Permettre à vos utilisateurs de se connecter automatiquement à TextMagic 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 TextMagic pour lequel l’authentification unique est activée

Description du scénario

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

  • TextMagic prend en charge l’authentification unique lancée par le fournisseur d’identité.

  • TextMagic prend en charge l’attribution d’utilisateurs juste-à-temps.

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 TextMagic avec Microsoft Entra ID, vous devez ajouter TextMagic à votre liste d’applications SaaS managées, depuis la galerie.

  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 TextMagic dans la zone de recherche.
  4. Sélectionnez TextMagic 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 l’authentification unique Microsoft Entra pour TextMagic

Configurez et testez l’authentification unique Microsoft Entra avec TextMagic à l’aide d’un utilisateur de test appelé B.Simon. Pour que l’authentification unique fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l’utilisateur TextMagic associé.

Pour configurer et tester l’authentification unique Microsoft Entra avec TextMagic, 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 TextMagic pour configurer les paramètres de l’authentification unique côté application.
    1. Créer un utilisateur de test TextMagic – pour avoir dans TextMagic un équivalent de B.Simon associé à 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>TextMagic>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 Identificateur, tapez une l’URL : https://my.textmagic.com/saml/metadata

  6. L’application TextMagic attend les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à la configuration des attributs de jetons SAML. La capture d’écran suivante montre la liste des attributs par défaut, où nameidentifier est mappé avec user.userprincipalname. L’application TextMagic s’attend à ce que nameidentifier soit mappé avec user.mail. Vous devez donc modifier le mappage d’attribut en cliquant sur l’icône Modifier.

    image

  7. En plus de ce qui précède, l’application TextMagic s’attend à ce que quelques attributs supplémentaires soient repassés dans la réponse SAML. Ces attributs sont également préremplis, mais vous pouvez les examiner pour voir s’ils répondent à vos besoins.

    Nom Attribut source Espace de noms
    société user.companyname https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    firstName user.givenname https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    lastName user.surname https://schemas.xmlsoap.org/ws/2005/05/identity/claims
    phone user.telephonenumber https://schemas.xmlsoap.org/ws/2005/05/identity/claims
  8. Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, recherchez Certificat (Base64) , puis 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 TextMagic, 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 lui accordant l’accès à TextMagic.

  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>TextMagic.
  3. Dans la page de vue d’ensemble de l’application, recherchez la section Gérer et sélectionnez Utilisateurs et groupes.
  4. Sélectionnez Ajouter un utilisateur, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
  5. 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.
  6. Si vous attendez une valeur de rôle dans l’assertion SAML, dans la boîte de dialogue Sélectionner un rôle, sélectionnez le rôle approprié pour l’utilisateur dans la liste, puis cliquez sur le bouton Sélectionner en bas de l’écran.
  7. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique TextMagic

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

  2. Sélectionnez Paramètres du compte sous le nom d’utilisateur.

    Screenshot shows Account settings selected from the user.

  3. Cliquez sur l’onglet Authentification unique (SSO) , puis complétez les champs suivants :

    Screenshot shows the Single Sign-On tab where you can enter the values described.

    a. Dans la zone de texte ID d’entité du fournisseur d’identité :, collez la valeur de l’identificateur Microsoft Entra.

    b. Dans la zone de texte URL d’authentification unique du fournisseur d’identité, collez la valeur d’URL de connexion.

    c. Dans la zone de texte URL de Single Logout du fournisseur d’identité, collez la valeur de l’URL de logout.

    d. Ouvrez dans le Bloc-notes votre certificat codé en base 64 téléchargé à partir du portail Azure, copiez son contenu dans le Presse-papiers, puis collez-le dans la zone de texte Certificat x509 public.

    e. Cliquez sur Enregistrer.

Créer un utilisateur de test TextMagic

Dans cette section, un utilisateur appelé B.Simon est créé dans TextMagic. TextMagic prend en charge le provisionnement d’utilisateurs juste-à-temps, qui est activé par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe pas encore d’utilisateur dans TextMagic, il en est créé un après l’authentification.

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 devrait automatiquement vous connecter à l’instance de TextMagic pour laquelle vous avez configuré l’authentification unique.

  • Vous pouvez utiliser Mes applications de Microsoft. Quand vous cliquez sur la vignette TextMagic dans Mes applications, vous devez être connecté automatiquement à l’application TextMagic pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Une fois que vous avez configuré TextMagic, 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.