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.
- Nyissa meg a Visual Studiót, majd válassza az Új projekt létrehozása lehetőséget.
- Keresse meg és válassza ki az üres ASP.NET sablont, majd kattintson a Tovább gombra.
- Adja meg a projekt nevét, például a NewWebAPILocal nevet.
- Válasszon egy helyet a projekthez, vagy fogadja el az alapértelmezett beállítást, majd válassza a Tovább gombot.
- Fogadja el az alapértelmezett keretrendszert, és konfigurálja a HTTPS-t.
- Válassza a Létrehozás lehetőséget.
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.
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
: .
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.
- A felső menüben válassza a Tools>NuGet Csomagkezelő> Manage NuGet Packages for Solution lehetőséget.
- 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. - Válassza az Ok vagy elfogadom lehetőséget az esetlegesen megjelenő többi ablak esetében.