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

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

Visual Studio

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.

Visual Studio Code

1. Öppna Visual Studio Code, välj Arkiv > Öppna mapp.... Navigera till och välj den plats där projektet ska skapas.

2. Öppna en ny terminal genom att välja Terminal i det övre fältet och sedan Ny terminal.

3. Skapa en ny mapp med ikonen Ny mapp... i utforskarfönstret. Ange ett namn som liknar det som registrerats tidigare, till exempel NewWebAPILocal.

4. Öppna en ny terminal genom att välja Terminal > Ny terminal.

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

Visual Studio för Mac

1. Öppna Visual Studio och välj sedan Nytt.
2. Under Webb och konsol i det vänstra navigeringsfältet väljer du App.
3. Under ASP.NET Core väljer du API och ser till att C# är markerat i den nedrullningsbara menyn och väljer sedan Fortsätt.
4. Acceptera standardvärdet för Target Framework och Avancerat och välj sedan Fortsätt.
5. Ange ett namn för projektnamnet. Detta visas i Lösningsnamn. Ange ett liknande namn som det som är registrerat i administrationscentret för Microsoft Entra, till exempel NewAPI1.
6. Acceptera standardplatsen för projektet eller välj en annan plats och välj sedan Skapa.

Kommentar

Visual Studio för Mac beräknas gå i pension senast den 31 augusti 2024 i enlighet med Microsofts policy för modern livscykel. Visual Studio för Mac 17.6 fortsätter att stödjas fram till den 31 augusti 2024, med serviceuppdateringar för säkerhetsproblem och uppdaterade plattformar från Apple. Mer information finns i Vad som händer med Visual Studio för Mac.

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.

Visual Studio

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.

Visual Studio Code

1. I terminalen som öppnades i föregående avsnitt anger du följande kommando:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio för Mac

1. På den översta menyn väljer du Verktyg>Hantera NuGet-paket.
2. Sök efter Microsoft.Identity.Web, välj Microsoft.Identity.Web paketet, välj Projekt och välj sedan Lägg till paket.
3. Kontrollera att rätt projekt är markerat i popup-fönstret och välj sedan Ok.
4. Välj Acceptera om andra fönster för godkännande av licenser visas.

Nästa steg

Självstudie: Implementera en skyddad slutpunkt i ditt API