Exercice : Connecter une application ASP.NET Core à Microsoft 365

  • 5 minutes

Dans cet exercice, vous allez travailler avec une application ASP.NET Core et la connecter à Microsoft 365. Vous allez utiliser un assembly .NET Core nommé Microsoft.Identity.Web pour permettre aux utilisateurs de se connecter à votre application avec leur compte Microsoft 365. Leur nom et leur image de profil seront ensuite affichés à l’aide du Kit de développement logiciel (SDK) Microsoft Graph .NET Core.

Configuration et exécution du modèle d’application

Cet exercice vous permet de créer facilement une application web de base. Pour obtenir le code d’application de démarrage initial que vous allez utiliser, accédez à https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor, puis choisissez l’une de ces options :

  • Si vous utilisez Git, clonez le projet à l’aide de la commande git clone :

    git clone https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor.git

  • Si vous n’utilisez pas Git, sélectionnez le bouton Code, suivi de Télécharger le fichier ZIP. Extrayez le fichier *.zip sur votre ordinateur.

Une fois l’application initiale sur votre ordinateur, suivez ces étapes pour ouvrir l’application dans votre éditeur de code.

  1. Accédez au dossier avec le code source de l’application, puis sélectionnez l’une des options suivantes en fonction de votre éditeur de code.

    • Visual Studio (version 2019 16.11.0 ou supérieure)

      Double-cliquez sur MicrosoftGraph-DotNetCoreRazor.sln dans le dossier mslearn-m365-microsoftgraph-dotnetcorerazor/Begin pour ouvrir le projet.

    • Visual Studio Code ou un autre éditeur de code

      Ouvrez le dossier mslearn-m365-microsoftgraph-dotnetcorerazor/Begin dans votre éditeur de code.

  2. Dans votre éditeur de code, ouvrez le fichier appsettings.json et prenez le temps de passer en revue certains paramètres.

  3. Modifiez la valeur de la propriété Scopes comme suit pour autoriser l’accès à la lecture du profil et de la présence d’un utilisateur, des paramètres de boîte aux lettres (pour les informations de fuseau horaire) et des calendriers.

    user.read presence.read mailboxsettings.read mail.read

  4. Enregistrez appsettings.json avant de continuer.

  5. Pour ajouter les valeurs ClientId et ClientSecret de l’ID Microsoft Entra, vous allez utiliser ASP.NET secrets d’application Core.

  6. Ouvrez une fenêtre terminal à la racine du dossier mslearn-m365-microsoftgraph-dotnetcorerazor/Begin, puis exécutez les commandes suivantes, en remplaçant YOUR_APP_ID par votre ID d’application (client) du Portail Azure et YOUR_APP_SECRET par le secret d’application que vous avez créé.

    dotnet user-secrets init
dotnet user-secrets set "AzureAd:ClientId" "YOUR_APP_ID"
dotnet user-secrets set "AzureAd:ClientSecret" "YOUR_APP_SECRET"

    Importante

    Dans une application de production, vous pouvez stocker des informations sensibles dans un emplacement sécurisé tel qu’Azure Key Vault.

  7. Ce projet utilise les assemblys Plateforme d'identités Microsoft pour développeurs et Microsoft Graph suivants :

    • Microsoft.Identity.Web : permet de demander et de gérer des jetons d’accès.
    • Microsoft.Identity.Web.UI : fournit l’interface utilisateur pour se connecter et se déconnecter.
    • Microsoft.Identity.Web.MicrosoftGraph : fournit l’injection de dépendances pour le SDK Microsoft Graph.

  8. Effectuez l’étape suivante en fonction de votre éditeur de code :

    • Visual Studio

      Appuyez sur F5 pour générer et exécuter le projet.

    • Visual Studio Code ou un autre éditeur de code

      Ouvrez une fenêtre terminal dans le dossier Début, puis exécutez la commande suivante :

      dotnet run

    Importante

    Si vous recevez un avertissement signalant que le certificat pour localhost n’est pas approuvé, voir Approuver le certificat de développement https ASP.NET Core sur Windows et macOS pour des instructions sur l’utilisation de ,NET Core CLI pour approuver le certificat de développement. Si vous exécutez dans Visual Studio et que vous n’avez pas encore approuvé de certificat de développeur sur votre ordinateur, vous pouvez être invité à approuver un certificat.

  9. Ouvrez un navigateur et accédez à https://localhost:5001.

    Conseil

    Si vous utilisez Microsoft 365 dans votre travail quotidien et planifiez cet exercice dans un client de développement (suggéré), il peut être utile de travailler en mode privé ou « incognito » dans le navigateur. Vous pouvez même choisir d’utiliser un navigateur ou un profil de navigateur différent de celui que vous utilisez normalement dans la production.

  10. Connectez-vous à l’aide de votre compte Microsoft 365.

  11. Une fois la connexion réussie, vous êtes invité à donner votre consentement pour les autorisations requises. Cochez la case pour accepter les autorisations de votre organisation, puis sélectionnez le bouton Accepter.

  12. L’application doit afficher un message de bienvenue avec votre nom d’utilisateur et votre photo de profil.

  13. Fermez votre navigateur et appuyez sur Ctrl+C dans la fenêtre du terminal pour arrêter le serveur.

    Remarque

    Si vous avez ouvert le projet dans Visual Studio, vous pouvez fermer le navigateur ou sélectionner Maj+F5 dans Visual Studio pour arrêter le serveur. Fermez la fenêtre du terminal de Visual Studio si elle est toujours ouverte.