Démarrage rapide : Protéger une API web ASP.NET Core avec la plateforme d’identités Microsoft

Article
10/03/2024

Ce guide de démarrage rapide utilise un exemple de code d’API web ASP.NET Core pour montrer comment restreindre l’accès aux ressources aux comptes autorisés. L’exemple utilise l’Identité ASP.NET Core qui interagit avec la bibliothèque d’authentification Microsoft (MSAL) pour gérer l’authentification.

Prérequis

Compte Azure avec un abonnement actif. Si vous n’en avez pas déjà un, créez un compte gratuitement.
Exigence minimale de SDK .NET 8.0
Visual Studio 2022 ou Visual Studio Code

Inscrire l’application et enregistrer les identificateurs

Conseil

Les étapes décrites dans cet article peuvent varier légèrement en fonction du portail de départ.

Pour terminer l’inscription, fournissez un nom à l’application et spécifiez les types de comptes pris en charge. Une fois l’inscription terminée, la page Vue d’ensemble de l’application affiche les identificateurs nécessaires dans le code source de l’application.

Connectez-vous au centre d’administration de Microsoft Entra au minimum en tant que Développeur d’application.
Si vous avez accès à plusieurs clients, utilisez l’icône Paramètres dans le menu supérieur pour basculer vers le client dans lequel vous voulez inscrire l’application à partir du menu Répertoires + abonnements.
Accédez à Identité>Applications>Inscriptions d’applications.
Sélectionnez Nouvel enregistrement.
Attribuez un Nom à l’application, par exemple NewWebAPI1.
Pour les Types de comptes pris en charge, sélectionnez Comptes dans cet annuaire organisationnel. Pour plus d’informations sur les différents types de comptes, sélectionnez l’option M’aider à choisir.
Sélectionnez Enregistrer.
Le Vue d’ensemble de l’application s’affiche une fois l’inscription terminée. Enregistrez l’ID du répertoire (client) et l’ID d’application (client) à utiliser dans le code source de votre application.

Remarque

Il est possible de modifier les Types de comptes pris en charge. Pour cela, reportez-vous à Modifier les comptes pris en charge par une application.

Exposer une API

Une fois l’API inscrite, vous pouvez configurer son autorisation en définissant les étendues qu’elle expose aux applications clientes. Les applications clientes demandent l’autorisation d’effectuer des opérations en transmettant un jeton d’accès avec leurs demandes à l’API web protégée. Votre API web effectue ensuite l’opération demandée uniquement si le jeton d’accès qu’elle reçoit contient les étendues nécessaires.

Sous Gérer, sélectionnez Exposer une API > Ajouter une étendue. Acceptez l’URI d’ID d’application (api://{clientId})proposée en sélectionnant Enregistrer et continuer. {clientId} est la valeur enregistrée depuis la page Vue d’ensemble. Entrez ensuite les informations suivantes :
1. Pour Nom de l’étendue, entrez Forecast.Read.
2. Pour Qui peut donner son consentement, vérifiez que l’option Administrateurs et utilisateurs est sélectionnée.
3. Dans la zone Nom d’affichage du consentement administrateur, entrez Read forecast data.
4. Dans Description du consentement de l’administrateur, entrez Allows the application to read weather forecast data.
5. Dans la zone Nom d’affichage du consentement utilisateur, entrez Read forecast data.
6. Dans la zone Description du consentement de l’utilisateur, entrez Allows the application to read weather forecast data.
7. Vérifiez que l’État défini est Activé.
Sélectionnez Ajouter une étendue. Si l’étendue a été entrée correctement, elle figure dans le volet Exposer une API.

Cloner ou télécharger l’exemple d’application

Pour obtenir l’exemple d’application, vous pouvez le cloner à partir de GitHub ou le télécharger sous la forme d’un fichier .zip.

Pour cloner l’exemple, ouvrez une invite de commandes, accédez à l’emplacement où vous souhaitez créer le projet, puis entrez la commande suivante :
```
git clone https://github.com/Azure-Samples/ms-identity-docs-code-dotnet.git
```
Téléchargez le fichier .zip. Extrayez-la dans un chemin d’accès de fichier où la longueur du nom est inférieure à 260 caractères.

Configurer l’exemple d’application ASP.NET Core

Dans votre IDE, ouvrez le dossier de projet ms-identity-docs-code-dotnet/web-api, qui contient l’exemple.
Ouvrez le fichier appsettings.json, qui contient l’extrait de code suivant :
```
{
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "TenantId": "Enter the tenant ID obtained from the Microsoft Entra admin center",
    "ClientId": "Enter the client ID obtained from the Microsoft Entra admin center",
    "Scopes": "Forecast.Read"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}
```
Recherchez la key suivante :
- ClientId – Identificateur de l’application, également appelé client. Remplacez le texte value entre guillemets par l’ID d’application (client) enregistré précédemment à partir de la page Vue d’ensemble de l’application inscrite.
- TenantId – Identificateur du locataire où l’application est inscrite. Remplacez le texte value entre guillemets par l’ID de l’annuaire (client) enregistré précédemment à partir de la page Vue d’ensemble de l’application inscrite.

Exécuter l’exemple d’application

Exécutez la commande suivante pour démarrer l’application :
```
dotnet run
```
Un résultat semblable à l’exemple suivant s’affiche :
```
...
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:{port}
...
```
Enregistrez le numéro de port dans l’URL http://localhost:{port}.
Pour vérifier que le point de terminaison est protégé, mettez à jour l’URL de base dans la commande cURL suivante pour qu’elle corresponde à celle que vous avez reçue à l’étape précédente, puis exécutez la commande :
```
curl -X GET https://localhost:5001/weatherforecast -ki
```
La réponse attendue est 401 Non autorisée avec une sortie similaire à :
```
user@host:~$ curl -X GET https://localhost:5001/weatherforecast -ki
HTTP/2 401
date: Fri, 23 Sep 2023 23:34:24 GMT
server: Kestrel
www-authenticate: Bearer
content-length: 0
```

Étapes suivantes

Passez à l’article suivant pour apprendre à appeler l’API web protégée à l’aide de cURL.

Guide pratique : Appeler une API web ASP.NET Core avec cURL

Partage via