Exercice : utiliser l’API Graph à partir d’un connecteur personnalisé

  • 15 minutes

Dans cet exercice, vous allez créer un connecteur personnalisé et découvrir comment le configurer pour accéder à l’API Microsoft Graph à l’aide de l’authentification Microsoft Entra ID. Comme l’accent est mis sur l’authentification, cet exercice ne configure qu’une seule action appelée Dernière utilisation.

Important

Utilisez un environnement de test avec Microsoft Dataverse approvisionné. Si vous ne disposez pas d’un environnement de test, vous pouvez vous inscrire pour bénéficier de l’offre Communauté.

Tâche 1 : créer une solution

Pour créer une solution, procédez comme suit :

  1. Accédez à Power Apps Maker Portal et veillez à vous trouver dans l’environnement approprié.

  2. Cliquez sur Solutions > + Nouvelle solution.

  3. Saisissez Graphique Contoso pour Nom d’affichage, sélectionnez Éditeur par défaut CDS pour Éditeur, puis cliquez sur Créer. Remarque : Lorsque vous travaillez sur un vrai projet, il est préférable de créer votre propre éditeur personnalisé.

    Capture d’écran de la fenêtre Créer une solution.

  4. Ne quittez pas cette page après avoir cliqué sur Créer.

Tâche 2 : tester l’API à l’aide de l’Afficheur Graph

Dans cette tâche, l’Afficheur Graph va vous permettre d’effectuer une action d’API que vous allez configurer dans le connecteur personnalisé.

  1. Dans un nouvel onglet de navigateur, accédez à l’Afficheur Graph.

  2. Cliquez sur Se connecter.

    Capture d’écran du bouton Se connecter à l’Afficheur Graph.

  3. Connectez-vous avec vos informations utilisateur.

  4. Lisez les autorisations demandées, puis continuez si vous êtes d’accord.

  5. Assurez-vous que le verbe GET est sélectionné, ajoutez /insights/used à l’URL, puis cliquez sur Exécuter la requête.

    Capture d’écran du menu GET, de l’URL et du bouton Exécuter la requête.

  6. Vous devriez obtenir une erreur 403 indiquant que l’Afficheur Graph ne dispose pas de votre autorisation pour effectuer cette action.

  7. Cliquez sur l’onglet Modifier les autorisations pour octroyer l’autorisation à l’Afficheur Graph.

  8. Sélectionnez Consentement pour Sites.Read.All.

  9. Lisez les autorisations demandées, puis continuez si vous êtes d’accord.

  10. Recliquez sur Exécuter la requête.

    Vous devriez maintenant obtenir le statut OK - 200.

    Capture d’écran de l’aperçu de la réponse à la requête.

  11. Ouvrez un nouvel onglet de session de navigateur.

  12. Accédez au Stockage cloud personnel OneDrive et connectez-vous.

  13. Cliquez sur + Nouveau, puis sélectionnez Document Word. Vous créez ce document afin d’avoir du contenu dans votre liste Dernière utilisation.

    Capture d’écran du bouton de création d’un document Word.

  14. Saisissez du texte test dans le fichier Word. Le document sera enregistré automatiquement.

  15. Retournez à l’Afficheur Graph.

  16. Réexécutez la même requête.

    Vous devriez à présent obtenir une réponse avec des valeurs. Si vous ne voyez pas de réponse, revenez au document que vous avez créé dans OneDrive et apportez des modifications, puis revenez et réexécutez la requête.

  17. Sélectionnez la réponse JSON, cliquez avec le bouton droit de la souris, sélectionnez Copier, puis enregistrez la réponse.

    Capture d’écran de la réponse JSON sélectionnée avec la fonction Copier.

    Vous aurez besoin de cette réponse plus tard dans cet exercice pour configurer la réponse dans le connecteur personnalisé.

Tâche 3 : enregistrer une nouvelle application et ajouter des autorisations

Dans cette tâche, vous allez configurer une nouvelle application permettant d’accéder à l’API Graph à partir du connecteur personnalisé. Vous allez également configurer les autorisations pour les actions spécifiques de l’API Graph, de la même façon que vous avez modifié les autorisations dans l’Afficheur Graph.

  1. Accédez à Microsoft Azure et connectez-vous avec vos informations d’identification utilisateur administrateur.

  2. Cliquez sur Afficher le menu du portail, puis sélectionnez Microsoft Entra ID.

    Capture d’écran du bouton de navigation vers Microsoft Entra ID.

  3. Cliquez sur Inscription d’application > + Nouvelle inscription.

    Capture d’écran du bouton de création d’inscription d’application.

  4. Saisissez Connaître le dernier connecteur utilisé pour le Nom, sélectionnez Web et saisissez https://global.consent.azure-apim.net/redirect pour l’URI de redirection, puis cliquez sur S’inscrire.

    Capture d’écran de la fenêtre Inscrire une application.

  5. Cliquez sur Autorisations de l’API, puis sur + Ajouter une autorisation.

  6. Sélectionnez Microsoft Graph.

  7. Cliquez sur Autorisations déléguées.

  8. Recherchez des sites, puis développez Sites.

  9. Sélectionnez Sites.Read.All et Sites.ReadWrite.All, puis cliquez sur Ajouter des autorisations.

    Capture d’écran de la fenêtre Sélectionner les autorisations.

  10. Vous devriez maintenant disposer de trois autorisations d’API. Cliquez sur Certificats et secrets.

    Capture d’écran du menu Certificats et secrets avec trois autorisations d’API.

  11. Cliquez sur + Nouvelle clé secrète client.

    Capture d’écran du bouton Nouvelle clé secrète client.

  12. Saisissez Action du dernier connecteur utilisé pour Description, sélectionnez 90 jours pour Date d’expiration, puis cliquez sur Ajouter.

  13. Copiez la Valeur et enregistrez-la pour plus tard, car elle ne s’affichera plus. Vous allez utiliser ce secret utilisateur lors de la création du connecteur.

    Capture d’écran de la fenêtre Clés secrètes client.

  14. Sélectionnez Vue d’ensemble.

  15. Copiez l’ID d’application (client) et enregistrez-le dans votre Bloc-notes. Vous utiliserez cet ID client lors de la création du connecteur.

    Capture d’écran de l’ID d’application (client) avec la fonction de copie.

Tâche 4 : créer un connecteur personnalisé

Pour créer un connecteur personnalisé, procédez comme suit :

  1. Accédez au portail d’administration Power Apps et veillez à vous trouver dans l’environnement approprié.

  2. Cliquez sur Solutions, puis sélectionnez la solution Graphique Contoso que vous avez créée à la Tâche 1 : créer une solution pour l’ouvrir.

  3. Cliquez sur + Nouveau, puis sélectionnez Automatisation > Connecteur personnalisé.

    Capture d’écran du menu Nouveau avec l’option Connecteur personnalisé sélectionnée.

  4. Entrez Graphique Contoso pour Nom du connecteur.

    Capture d’écran de Graphique Contoso saisi comme nom du connecteur.

  5. Faites défiler vers le bas, entrez graph.microsoft.com pour Hôte et /v1.0 pour URL de base.

  6. Sélectionnez Sécurité.

    Capture d’écran des champs Hôte et URL de base, avec le bouton Sécurité.

  7. Sélectionnez OAuth 2.0 pour Authentification.

  8. Sélectionnez Microsoft Entra ID pour Fournisseur d’identité.

  9. Collez l’ID que vous avez copié à partir d’Azure dans le champ ID client, puis collez la Valeur que vous avez copiée à partir d’Azure dans le champ Clé secrète client.

  10. Entrez https://graph.microsoft.com pour URL de la ressource, puis sélectionnez Créer un connecteur.

    Capture d’écran du bouton Créer un connecteur.

  11. Ne quittez pas cette page.

Tâche 5 : ajouter l’action

Dans cette tâche, vous allez configurer le conseil de la dernière action utilisée appelée API Graph.

  1. Cliquez sur Définition > + Nouvelle action.

    Capture d’écran du bouton Nouvelle action dans la fenêtre Définition.

  2. Entrez Dernière utilisation pour Résumé et LastUsed pour ID d’opération.

  3. Accédez à la section Demande et cliquez sur + Importer à partir de l’exemple.

    Capture d’écran du bouton Importer à partir de l’exemple dans la section Demande.

  4. Sélectionnez Get pour le verbe, entrez /me/insights/used pour l’URL, puis cliquez sur Importer.

  5. Faites défiler vers le bas et sélectionnez la réponse par défaut.

    Capture d’écran de la réponse par défaut dans la section Réponse.

  6. Cliquez sur + Importer à partir de l’exemple.

    Capture d’écran du bouton Importer à partir de l’exemple.

  7. Collez la réponse que vous avez copié à partir de l’Afficheur Graph dans le champ Corps, puis cliquez sur Importer.

    Capture d’écran de la réponse dans le champ Corps et du bouton Importer.

  8. Cliquez sur Mettre à jour le connecteur.

  9. Ne quittez pas cette page.

Tâche 6 : tester le connecteur

Pour tester le connecteur, procédez comme suit :

  1. Cliquez sur l’onglet Test, puis sur + Nouvelle connexion.

    Capture d’écran du bouton Nouvelle connexion dans l’onglet Test.

  2. Fournissez vos informations d’identification.

  3. Lisez les autorisations demandées, puis continuez.

  4. Cliquez sur Actualiser les connexions.

  5. Sélectionnez Opération de test.

    Capture d’écran du bouton Opération de test mis en surbrillance.

    Vous devriez voir s’afficher un statut 200 et la réponse doit ressembler à l’image suivante.

    Capture d’écran du statut 200 et de l’exemple de réponse.