Dela via


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

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

Skapa ett ASP.NET Core-projekt

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

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

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.

  1. Ö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 .
  2. Spara ändringarna i filen.

Installera identitetspaket

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

  1. På den översta menyn väljer du Verktyg>NuGet Package Manager>Hantera NuGet-paket för lösning.
  2. 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.
  3. Välj Ok eller Jag accepterar för andra fönster som kan visas.

Nästa steg