Paramétrer un environnement Postman

Vous pouvez utiliser Postman pour vous connecter à votre instance de Dynamics 365 pour Customer Engagement (on-premises) et composer des requêtes de l’API web, les envoyer et afficher les réponses. La gestion de l’authentification est un défi pour de nombreux personnes. Cette rubrique décrit comment configurer un environnement Postman compatible avec les environnements en ligne et locaux.

Vous pouvez utiliser un environnement Postman pour enregistrer un ensemble de variables permettant de vous connecter. Ces valeurs sont accessibles dans Postman à l’aide de la syntaxe suivante : {{name}}. Pour plus d'informations sur les variables Postman, voir Documentation de Postman> Variables.

Hinweis

La documentation de l’authentification qui s’applique aux utilisateurs de l’application Dynamics 365 Customer Engagement (online) est désormais disponible dans la documentation Power Apps à l’adresse : Configurer un environnement Postman.

Configuration requise

• Disposer d’un en environnement en ligne ou local auquel vous pouvez vous connecter.
• Téléchargez et installez l’application de bureau Postman.

Sélectionnez l’option de connexion compatible pour votre environnement :

• Connexion à un environnement en ligne
• Connexion à un environnement local

Connexion à un environnement en ligne

Pour se connecter à un environnement en ligne, voir les informations fournies dans cette rubrique Dataverse de Power Apps : Se connecter à un environnement en ligne.

Connexion à un environnement local

1. Lancez l’application de bureau Postman.
2. Sélectionnez l’icône engrenages Options de l’environnement dans l’angle supérieur droit.
3. Dans la boîte de dialogue Gérer les environnements qui s’affiche, sélectionnez le bouton Ajouter pour ajouter un nouvel environnement.
4. Dans la boîte de dialogue qui s’ouvre, ajoutez un nom pour l’environnement. Copiez ensuite les paires clé-valeur suivantes dans l’espace de modification.

Nom de la variable	Value
url	https://yourservername/yourorgname
version	9.1
webapiurl	{{url}}/api/data/v{{version}}/

5. Remplacez la valeur d’espace réservé de l’URL de l’instance par l’URL de votre instance Dynamics 365 Customer Engagement (on-premises), puis sélectionnez Ajouter pour enregistrer l’environnement.
6. Fermez la boîte de dialogue Gérer les environnements.

Définir les informations d’identification

1. Sous l’onglet Autorisations, sélectionnez Authentification NTLM [Bêta].
2. Définissez les valeurs suivantes dans le formulaire :
   • Nom d’utilisateur. Saisissez l’alias uniquement, n’incluez pas le domaine.
   • Mot de passe. Vous avez la possibilité d’afficher le mot de passe.
   • Domaine. Vous devez définir cette option si vous accédez au compte à partir d’un autre domaine. Vous pouvez la définir sur ~ afin que le domaine par défaut du serveur soit utilisé.
   

Votre authentification peut se présenter comme suit si vous ouvrez une session en tant qu’administrateur.

Tester votre connexion

Créez une demande d’API web pour tester la connexion avec votre instance Dynamics 365 Customer Engagement (on-premises) . Utilisez le WhoAmI function :

1. Sélectionnez GET comme méthode HTTP et ajoutez {{webapiurl}}WhoAmI dans l’espace de modification.
2. Sélectionnez Envoyer pour envoyer cette requête.
3. Si votre requête aboutit, vous devez afficher les données de WhoAmIResponse ComplexType qui sont renvoyées par la WhoAmI Function.

Voir aussi

Utiliser l’API Web de Dynamics 365 Customer Engagement
Guide pas à pas : Enregistrer une application Dynamics 365 Customer Engagement avec Active Directory

Hinweis

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).