Partage via


Configurer Postman pour l’authentification unique avec l’ID Microsoft Entra

Dans cet article, vous allez apprendre à intégrer Postman à Microsoft Entra ID. Lorsque vous intégrez Postman avec Microsoft Entra ID, vous pouvez :

  • Contrôler dans Microsoft Entra ID qui a accès à Postman.
  • Permettre à vos utilisateurs d’être automatiquement connectés à Postman avec leurs comptes Microsoft Entra.
  • Gérez vos comptes dans un emplacement central.

Conditions préalables

Le scénario décrit dans cet article suppose que vous disposez déjà des conditions préalables suivantes :

  • Un abonnement Postman 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 cloud Microsoft Entra US Government et la configurer de la même façon que vous le faites à partir du cloud public.

Description du scénario

Dans cet article, vous allez configurer et tester l’authentification unique Microsoft Entra dans un environnement de test.

  • Postman prend en charge l’authentification unique initiée par le fournisseur de services et le fournisseur d’identité.
  • Postman prend en charge l’attribution d’utilisateurs juste-à-temps.

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 Postman dans Microsoft Entra ID, vous devez ajouter Postman 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. Naviguez vers Entra ID>Applications d'entreprise>Nouvelle application.
  3. Dans la section Ajouter à partir de la galerie, saisissez Postman dans la zone de recherche.
  4. Sélectionnez Postman dans le volet de résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez sinon également utiliser l’Assistant de configuration des applications d'entreprise . Dans cet assistant, vous pouvez ajouter une application à votre instance, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, ainsi que parcourir la configuration de l’authentification unique (SSO). En savoir plus sur les assistants Microsoft 365.

Configurer et tester Microsoft Entra SSO pour Postman

Configurez et testez Microsoft Entra SSO avec Postman à l’aide d’un utilisateur 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 associé dans Postman.

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

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

Configurer l’authentification unique Microsoft Entra

Suivez 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 à Entra ID>Enterprise apps>Postman>Single sign-on.

  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 , sélectionnez l’icône crayon de configuration SAML de base pour modifier les paramètres.

    Modifier la configuration SAML de base

  5. Dans la section Configuration SAML Basique, si vous souhaitez configurer l’application en mode initié par IDP, effectuez l’étape suivante :

    Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://identity.getpostman.com/sso/<INSTANCE_NAME>/callback

  6. Sélectionnez Définir des URL supplémentaires et effectuez l’étape suivante si vous souhaitez configurer l’application en mode initié par le fournisseur de services :

    Dans la zone de texte URL de connexion, tapez une URL au format suivant : https://identity.getpostman.com/sso/<INSTANCE_NAME>/init.

    Remarque

    Ces valeurs ne sont pas réelles. Mettez à jour ces valeurs avec l’URL de réponse et l’URL de connexion réelles. Pour obtenir ces valeurs, contactez l’équipe de support technique de Postman. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.

  7. Votre application Postman s’attend à recevoir les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à la configuration des attributs du jeton SAML. La capture d’écran suivante montre un exemple pour cela. La valeur par défaut pour Identificateur d’utilisateur unique est user.userprincipalname, mais Postman s’attend à ce qu’elle soit mappée à l’adresse e-mail de l’utilisateur. Pour cela, vous pouvez utiliser l’attribut user.mail à partir de la liste ou utiliser la valeur d’attribut appropriée en fonction de la configuration de votre organisation.

    image

  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.

    Lien de téléchargement du certificat

  9. Dans la section Configurer Postman, copiez les URL appropriées en fonction de vos besoins.

    Copier les URL de configuration

Créer et affecter un utilisateur de test Microsoft Entra

Suivez les instructions du guide de démarrage rapide pour créer et attribuer un compte utilisateur afin de créer un compte utilisateur de test appelé B.Simon.

Configurer l’authentification unique de Postman

Pour configurer l’authentification unique côté Postman, vous devez charger le XML des métadonnées de fédération téléchargé et mettre à jour sur Postman les URL appropriées que vous avez copiées. Pour savoir comment configurer l’authentification unique de Postman, consultez le guide pas à pas.

Créer un utilisateur de test Postman

Dans cette section, un utilisateur appelé Britta Simon est créé dans Postman. Postman prend en charge l’attribution d’utilisateurs juste-à-temps, option qui peut être activée en cochant la case Automatically add new users (Ajouter automatiquement de nouveaux utilisateurs). Grâce à cela, s’il n’existe pas encore d’utilisateur dans Postman, 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.

Lancé par le fournisseur de services :

  • Sélectionnez Tester cette application, cette option redirige vers l’URL de connexion Postman où vous pouvez lancer le flux de connexion.

  • Accédez directement à l’URL de connexion de Postman pour initier le flux de connexion.

Initialisé par IDP :

  • Sélectionnez Tester cette application et vous devez être connecté automatiquement à l’application Postman pour laquelle vous avez configuré l’authentification unique.

Vous pouvez également utiliser Microsoft My Apps pour tester l’application en tout mode. Lorsque vous sélectionnez le tile Postman dans Mes applications, si le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l'application pour initier le processus de connexion. En revanche, s'il est configuré en mode Fournisseur d'identité, vous serez automatiquement connecté à l'application Postman pour laquelle vous avez configuré l'authentification unique. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Une fois que vous avez configuré Postman, 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 s’étend de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.