Självstudie: Skapa och konfigurera ett ASP.NET Core-projekt för autentisering

Artikel
04/02/2024

I den här självstudien får du lära dig hur du skapar ett ASP.NET Core-projekt med hjälp av en IDE och konfigurerar det för autentisering och auktorisering. Den här självstudien är den andra delen i en serie som visar hur du skyddar ett webb-API med hjälp av Microsofts identitetsplattform. I föregående artikel registrerade du ett program i din Microsoft Entra-ID-klientorganisation. I den här artikeln, du;

Skapa ett ASP.NET Core Empty-projekt i din IDE
Konfigurera inställningarna för programmet
Identifiera och installera nödvändiga NuGet-paket

Förutsättningar

Slutförande av förutsättningarna och stegen i Självstudie: Registrera webb-API med Microsofts identitetsplattform.
Du kan ladda ned de ID:er som används i den här självstudien från sidan Nedladdningar .
- Visual Studio 2022
- Visual Studio-koden
- Visual Studio 2022 för Mac

Ett minimikrav för .NET 6.0 SDK.

Skapa ett ASP.NET Core-projekt

Använd följande flikar för att skapa ett ASP.NET Core-projekt i en IDE.

Öppna Visual Studio och välj sedan Skapa ett nytt projekt.
Sök efter och välj mallen ASP.NET Core Empty och välj sedan Nästa.
Ange ett namn för projektet, till exempel NewWebAPILocal.
Välj en plats för projektet eller acceptera standardalternativet och välj sedan Nästa.
Acceptera standardinställningen för Ramverk och Konfigurera för HTTPS.
Välj Skapa.

Öppna Visual Studio Code, välj Arkiv > Öppna mapp.... Navigera till och välj den plats där projektet ska skapas.
Öppna en ny terminal genom att välja Terminal i det övre fältet och sedan Ny terminal.
Skapa en ny mapp med ikonen Ny mapp... i utforskarfönstret. Ange ett namn som liknar det som registrerats tidigare, till exempel NewWebAPILocal.
Öppna en ny terminal genom att välja Terminal > Ny terminal.
Om du vill skapa en ASP.NET Core Empty-mall kör du följande kommandon i terminalen för att ändra till katalogen och skapa projektet:
```
cd NewWebAPILocal
dotnet new web
```

Konfigurera ASP.NET Core-projektet

Värdena som registrerats tidigare används i appsettings.json för att konfigurera programmet för autentisering. appsettings.json är en konfigurationsfil som används för att lagra programinställningar som används under körningen.

Öppna appsettings.json och ersätt filinnehållet med följande kodfragment:
```
{
  "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 – Slutpunkten för molnleverantören. Kontrollera med de olika tillgängliga slutpunkterna i nationella moln.
- TenantId – Identifieraren för klientorganisationen där programmet är registrerat. Ersätt texten inom citattecken med värdet katalog-ID (klientorganisation) som registrerades tidigare från översiktssidan för det registrerade programmet.
- ClientId - Identifieraren för programmet, även kallad klienten. Ersätt texten inom citattecken med det program-ID-värde (klient)-ID som spelades in tidigare från översiktssidan för det registrerade programmet.
- Scopes – Omfånget som används för att begära åtkomst till programmet. För den här självstudien är Forecast.Readomfånget .
Spara ändringarna i filen.

Installera identitetspaket

Identitetsrelaterade NuGet-paket måste installeras i projektet för att autentisering av användare ska kunna aktiveras.

På den översta menyn väljer du Verktyg>NuGet Package Manager>Hantera NuGet-paket för lösning.
Med fliken Bläddra markerad söker du efter Microsoft.Identity.Web, markerar Microsoft.Identity.Web paketet, markerar kryssrutan Projekt och väljer sedan Installera.
Välj Ok eller Jag accepterar för andra fönster som kan visas.

Nästa steg

Självstudie: Implementera en skyddad slutpunkt i ditt API

Dela via