Kurz: Vytvoření a konfigurace projektu ASP.NET Core pro ověřování
V tomto kurzu se dozvíte, jak vytvořit projekt ASP.NET Core pomocí integrovaného vývojového prostředí (IDE) a nakonfigurovat ho pro ověřování a autorizaci. Tento kurz je druhou částí série, která ukazuje, jak zabezpečit webové rozhraní API pomocí platformy Microsoft Identity Platform. V předchozím článku jste zaregistrovali aplikaci v tenantovi Microsoft Entra ID. V tomto článku, vy;
- Vytvoření projektu ASP.NET Core Empty v integrovaném vývojovém prostředí
- Konfigurace nastavení pro aplikaci
- Identifikace a instalace požadovaných balíčků NuGet
Požadavky
- Dokončení požadavků a kroků v kurzu: Registrace webového rozhraní API na platformě Microsoft Identity Platform
- IdEs použité v tomto kurzu si můžete stáhnout ze stránky Stažené soubory .
- Visual Studio 2022
- Visual Studio Code
- Visual Studio 2022 pro Mac
- Minimální požadavek sady .NET 6.0 SDK.
Vytvoření projektu ASP.NET Core
Následující karty slouží k vytvoření projektu ASP.NET Core v integrovaném vývojovém prostředí (IDE).
- Otevřete Visual Studio a pak vyberte Vytvořit nový projekt.
- Vyhledejte a zvolte šablonu ASP.NET Prázdné jádro a pak vyberte Další.
- Zadejte název projektu, například NewWebAPILocal.
- Zvolte umístění projektu nebo přijměte výchozí možnost a pak vyberte Další.
- Přijměte výchozí hodnotu pro architekturu a nakonfigurujte pro PROTOKOL HTTPS.
- Vyberte Vytvořit.
Konfigurace projektu ASP.NET Core
Hodnoty zaznamenané dříve se použijí v appsettings.json ke konfiguraci aplikace pro ověřování. appsettings.json je konfigurační soubor, který slouží k ukládání nastavení aplikace používaných během běhu.
Otevřete appsettings.json a nahraďte obsah souboru následujícím fragmentem kódu:
{ "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
– Koncový bod poskytovatele cloudu. Zkontrolujte různé dostupné koncové body v národních cloudech.TenantId
– Identifikátor tenanta, ve kterém je aplikace zaregistrovaná. Nahraďte text v uvozovkách hodnotou ID adresáře (tenanta), která byla zaznamenána dříve na stránce přehledu registrované aplikace.ClientId
– Identifikátor aplikace, označovaný také jako klient. Text v uvozovkách nahraďte hodnotou ID aplikace (klienta), která byla zaznamenána dříve na stránce přehledu registrované aplikace.Scopes
– Obor, který se používá k vyžádání přístupu k aplikaci. Pro účely tohoto kurzu jeForecast.Read
rozsah .
Uložte změny souboru.
Instalace balíčků identit
Aby bylo možné povolit ověřování uživatelů, musí být v projektu nainstalované balíčky NuGet související s identitou.
- V horní nabídce vyberte Nástroje>NuGet Správce balíčků> Nabídky NuGet pro řešení.
- Pokud je vybraná karta Procházet, vyhledejte Microsoft.Identity.Web, vyberte
Microsoft.Identity.Web
balíček, zaškrtněte políčko Projekt a pak vyberte Nainstalovat. - Vyberte OK nebo Přijímám pro jiná okna, která se můžou zobrazit.