Tutoriel : créer et configurer un projet ASP.NET Core pour l’authentification

Une fois l’inscription terminée, un projet ASP.NET Core peut être créé à l’aide d’un environnement de développement intégré (IDE). Ce tutoriel montre comment créer un projet ASP.NET Core à l’aide d’un IDE et comment le configurer pour l’authentification et l’autorisation.

Dans ce tutoriel, vous allez :

• Créer un ASP.NET Core vide
• Configurer les paramètres de l’application
• Identifier et installer les packages NuGet requis

Prérequis

• Respect des conditions préalables et des étapes décrites dans Tutoriel : inscrire l’API web auprès de la plateforme d'identités Microsoft.
• Vous pouvez télécharger les IDE utilisés dans ce tutoriel à partir de la page Téléchargements.
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 pour Mac

• Au minimum le Kit de développement logiciel (SDK) .NET Core 6.0.

Créer un projet ASP.NET Core

Utilisez les onglets suivants pour créer un projet ASP.NET Core au sein d’un IDE.

Visual Studio

1. Ouvrez Visual Studio, puis sélectionnez Créer un projet.
2. Recherchez et choisissez le modèle vide ASP.NET Core, puis sélectionnez Suivant.
3. Entrez un nom pour le projet, par exemple NewWebAPILocal.
4. Choisissez un emplacement pour le projet ou acceptez l’option par défaut, puis sélectionnez Suivant.
5. Acceptez la valeur par défaut pour I’infrastructure et Configurer pour HTTPS.
6. Sélectionnez Créer.

Visual Studio Code

1. Ouvrez Visual Studio Code, sélectionnez Fichier > Ouvrir le dossier.... Recherchez et sélectionnez l’emplacement où créer le projet.

2. Ouvrez un nouveau terminal en sélectionnant Terminal dans la barre supérieure, puis Nouveau terminal.

3. Créez un dossier à l’aide de l’icône Nouveau dossier... dans le volet Explorateur. Indiquez un nom similaire à celui inscrit précédemment, par exemple NewWebAPILocal.

4. Ouvrez un nouveau terminal en sélectionnant Terminal > Nouveau terminal.

5. Pour créer un modèle vide ASP.NET Core, exécutez les commandes suivantes dans le terminal pour accéder au répertoire et créer le projet :

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio pour Mac

1. Ouvrez Visual Studio, puis sélectionnez Nouveau.
2. Dans la barre de navigation gauche, sous Web et console, sélectionnez Application.
3. Sous ASP.NET Core, sélectionnez API et vérifiez que C# est sélectionné dans le menu déroulant, puis sélectionnez Continuer.
4. Acceptez la valeur par défaut pour l’Infrastructure cible et Avancé, puis sélectionnez Continuer.
5. Entrez un nom pour Nom du projet, qui sera répercuté dans Nom de la solution. Fournissez un nom similaire à celui inscrit sur le portail Azure, par exemple NewAPI1.
6. Acceptez l’emplacement par défaut pour le projet ou choisissez-en un autre et sélectionnez Créer.

Remarque

La mise hors service de Visual Studio pour Mac est prévue pour le 31 août 31, 2024, conformément à la stratégie de cycle de vie moderne de Microsoft. Visual Studio pour Mac 17.6 continuera d’être pris en charge jusqu’au 31 août 2024, avec des mises à jour de maintenance pour les problèmes de sécurité et les plateformes mises à jour d’Apple. Pour plus d’informations, reportez-vous à Que devient Visual Studio pour Mac ?.

Configurer le projet ASP.NET Core

Les valeurs enregistrées précédemment vont être utilisées dans appsettings.json pour configurer l’application pour l’authentification. appsettings.json est un fichier de configuration où sont stockés les paramètres d’application utilisés pendant l’exécution.

1. Ouvrez appsettings.json et remplacez le contenu du fichier par l’extrait de code suivant :

   {
     "AzureAd": {
       "Instance": "https://login.microsoftonline.com/",
       "ClientId": "Enter the client ID here",
       "TenantId": "Enter the tenant ID here",
       "Scopes": "Forecast.Read"
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   } 
   

   • Instance – Point de terminaison du fournisseur de cloud. Vérifiez les différents points de terminaison disponibles dans les clouds nationaux.
   • TenantId – Identificateur du locataire où l’application est inscrite. Remplacez le texte entre guillemets par la valeur du paramètre ID de l’annuaire (locataire) enregistrée précédemment dans la page Vue d’ensemble de l’application inscrite.
   • ClientId – Identificateur de l’application, également appelé client. Remplacez le texte entre guillemets par la valeur du paramètre ID d’application (locataire) enregistrée précédemment à partir de la page Vue d’ensemble de l’application inscrite.
   • Scopes – Étendue utilisée pour demander l’accès à l’application. Pour ce tutoriel, l’étendue est Forecast.Read.

2. Enregistrez les modifications du fichier.

Installer des packages d’identité

Les packages NuGet liés à l’identité doivent être installés dans le projet pour que l’authentification des utilisateurs soit activée.

Visual Studio

1. Dans le menu supérieur, sélectionnez Outils>Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution.
2. Avec l’onglet Parcourir sélectionné, recherchez Microsoft.Identity.Web, sélectionnez le package Microsoft.Identity.Web, cochez la case Projet, puis sélectionnez Installer.
3. Sélectionnez OK ou J’accepte pour les autres fenêtres qui peuvent s’afficher.

Visual Studio Code

1. Dans le terminal ouvert dans la section précédente, entrez la commande suivante :

   dotnet add package Microsoft.Identity.Web
   

Visual Studio pour Mac

1. Dans le menu supérieur, sélectionnez Outils>Gérer les packages NuGet.
2. Recherchez Microsoft.Identity.Web, sélectionnez le package Microsoft.Identity.Web, sélectionnez Projet, puis Ajouter un package.
3. Dans la fenêtre contextuelle, vérifiez que le projet correct est sélectionné, puis sélectionnez OK.
4. Sélectionnez Accepter si d’autres fenêtres Acceptation de licence s’affichent.

Étapes suivantes

Didacticiel : implémenter un point de terminaison protégé pour votre API