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

Article
04/05/2024

Dans ce tutoriel, vous allez apprendre à créer un projet ASP.NET Core à l’aide d’un IDE et à le configurer pour l’authentification et l’autorisation. Ce tutoriel est la deuxième partie d’une série qui montre comment sécuriser une API web au moyen de la plateforme d’identités Microsoft. Dans l’article précédent, vous avez inscrit une application dans votre locataire Microsoft Entra ID. Dans cet article, vous allez :

Créer un projet vide ASP.NET Core dans votre IDE
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 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.

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

Ouvrez Visual Studio Code, sélectionnez Fichier > Ouvrir le dossier.... Recherchez et sélectionnez l’emplacement où créer le projet.
Ouvrez un nouveau terminal en sélectionnant Terminal dans la barre supérieure, puis Nouveau terminal.
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.
Ouvrez un nouveau terminal en sélectionnant Terminal > Nouveau terminal.
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
```

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.

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.
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.

Dans le menu supérieur, sélectionnez Outils>Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution.
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.
Sélectionnez OK ou J’accepte pour les autres fenêtres qui peuvent s’afficher.

Étapes suivantes

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

Partager via