Oktatóanyag: ASP.NET Core-projekt létrehozása és konfigurálása hitelesítéshez

Ebben az oktatóanyagban megtudhatja, hogyan hozhat létre egy ASP.NET Core-projektet ide használatával, és hogyan konfigurálhatja hitelesítésre és engedélyezésre. Ez az oktatóanyag egy sorozat második része, amely bemutatja, hogyan lehet biztonságossá tenni egy webes API-t a Microsoft Identitásplatform használatával. Az előző cikkben regisztrált egy alkalmazást a Microsoft Entra ID-bérlőjében. Ebben a cikkben Ön;

• ASP.NET Core Empty-projekt létrehozása az IDE-ben
• Az alkalmazás beállításainak konfigurálása
• A szükséges NuGet-csomagok azonosítása és telepítése

Előfeltételek

• Az oktatóanyag előfeltételeinek és lépéseinek elvégzése: Webes API regisztrálása a Microsoft Identitásplatform.
• Az oktatóanyagban használt azonosítókat a Letöltések oldalról töltheti le.
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 for Mac

• A .NET 6.0 SDK minimális követelménye.

ASP.NET Core-projekt létrehozása

Az alábbi fülekkel hozhat létre egy ASP.NET Core-projektet egy IDE-ben.

Visual Studio

1. Nyissa meg a Visual Studiót, majd válassza az Új projekt létrehozása lehetőséget.
2. Keresse meg és válassza ki az üres ASP.NET sablont, majd kattintson a Tovább gombra.
3. Adja meg a projekt nevét, például a NewWebAPILocal nevet.
4. Válasszon egy helyet a projekthez, vagy fogadja el az alapértelmezett beállítást, majd válassza a Tovább gombot.
5. Fogadja el az alapértelmezett keretrendszert, és konfigurálja a HTTPS-t.
6. Válassza a Létrehozás lehetőséget.

Visual Studio Code

1. Nyissa meg a Visual Studio Code-ot, és válassza a Fájl > megnyitása mappa... lehetőséget. Keresse meg és válassza ki azt a helyet, ahol létre szeretné hozni a projektet.

2. Nyisson meg egy új terminált úgy, hogy a felső sávon a Terminál, majd az Új terminál lehetőséget választja.

3. Hozzon létre egy új mappát az Új mappa... ikonnal az Explorer panelen. Adjon meg egy korábban regisztrálthoz hasonló nevet, például a NewWebAPILocal nevet.

4. Nyisson meg egy új terminált az Új terminál terminál >kiválasztásával.

5. Ha ASP.NET Üres alapsablont szeretne létrehozni, futtassa az alábbi parancsokat a terminálban a címtárba való váltáshoz és a projekt létrehozásához:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio for Mac

1. Nyissa meg a Visual Studiót, majd válassza az Új lehetőséget.
2. A bal oldali navigációs sáv Web és Konzol területén válassza az Alkalmazás lehetőséget.
3. A ASP.NET Core alatt válassza az API-t, és győződjön meg arról, hogy a C# ki van jelölve a legördülő menüben, majd válassza a Folytatás lehetőséget.
4. Fogadja el a Cél keretrendszer és a Speciális beállítás alapértelmezett beállítását, majd válassza a Folytatás lehetőséget.
5. Adja meg a projekt nevét, és ez a megoldásnévben is megjelenik. Adjon meg egy hasonló nevet a Microsoft Entra felügyeleti központban regisztrált névhez, például a NewAPI1-hez.
6. Fogadja el a projekt alapértelmezett helyét, vagy válasszon másik helyet, majd válassza a Létrehozás lehetőséget.

Feljegyzés

A Visual Studio for Mac 2024. augusztus 31-ig lesz nyugdíjba vonulva a Microsoft Modern Életciklus Szabályzatának megfelelően. A Visual Studio for Mac 17.6 2024. augusztus 31-ig továbbra is támogatott lesz, az Apple biztonsági problémáinak és frissített platformjainak karbantartási frissítéseivel. További információt a Mac Visual Studióval kapcsolatos információkért talál.

A ASP.NET Core-projekt konfigurálása

A korábban rögzített értékek appsettings.json lesznek használva az alkalmazás hitelesítésre való konfigurálásához. appsettings.json egy konfigurációs fájl, amely a futtatás során használt alkalmazásbeállítások tárolására szolgál.

1. Nyissa meg appsettings.json , és cserélje le a fájl tartalmát a következő kódrészletre:

   {
     "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 - A felhőszolgáltató végpontja. Ellenőrizze a különböző elérhető végpontokat a nemzeti felhőkben.
   • TenantId - Annak a bérlőnek az azonosítója, ahol az alkalmazás regisztrálva van. Cserélje le az idézőjelek szövegét a címtár (bérlő) azonosítójának értékére, amelyet a regisztrált alkalmazás áttekintő oldaláról korábban rögzítettek.
   • ClientId - Az alkalmazás azonosítója, más néven az ügyfél. Cserélje le az idézőjelek szövegét az alkalmazás (ügyfél) azonosítójának értékére, amelyet korábban rögzítettek a regisztrált alkalmazás áttekintő oldaláról.
   • Scopes - Az alkalmazáshoz való hozzáférés kéréséhez használt hatókör. Ebben az oktatóanyagban a hatókör a következő Forecast.Read: .

2. Mentse a fájl módosításait.

Identitáscsomagok telepítése

Az identitással kapcsolatos NuGet-csomagokat telepíteni kell a projektbe a felhasználók hitelesítésének engedélyezéséhez.

Visual Studio

1. A felső menüben válassza a Tools>NuGet Csomagkezelő> Manage NuGet Packages for Solution lehetőséget.
2. A Tallózás lapon keresse meg a Microsoft.Identity.Web webhelyet, jelölje be a Microsoft.Identity.Web csomagot, jelölje be a Project jelölőnégyzetet, majd válassza a Telepítés lehetőséget.
3. Válassza az Ok vagy elfogadom lehetőséget az esetlegesen megjelenő többi ablak esetében.

Visual Studio Code

1. Az előző szakaszban megnyitott terminálban adja meg a következő parancsot:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio for Mac

1. A felső menüben válassza az Eszközök a>NuGet-csomagok kezelése lehetőséget.
2. Keresse meg a Microsoft.Identity.Web webhelyet, jelölje ki a csomagot, válassza a Microsoft.Identity.Web Project elemet, majd a Csomag hozzáadása lehetőséget.
3. Az előugró ablakban győződjön meg arról, hogy a megfelelő projekt van kiválasztva, majd kattintson az Ok gombra.
4. Válassza az Elfogadás lehetőséget, ha más licencelfogadási ablakok is megjelennek.

Következő lépések

Oktatóanyag: Védett végpont implementálása az API-ba