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

Visual Studio

1. Otevřete Visual Studio a pak vyberte Vytvořit nový projekt.
2. Vyhledejte a zvolte šablonu ASP.NET Prázdné jádro a pak vyberte Další.
3. Zadejte název projektu, například NewWebAPILocal.
4. Zvolte umístění projektu nebo přijměte výchozí možnost a pak vyberte Další.
5. Přijměte výchozí hodnotu pro architekturu a nakonfigurujte pro PROTOKOL HTTPS.
6. Vyberte Vytvořit.

Visual Studio Code

1. Otevřete Visual Studio Code a vyberte > Soubor otevřít složku.... Přejděte a vyberte umístění, ve kterém chcete projekt vytvořit.

2. Otevřete nový terminál tak , že v horním panelu vyberete Terminál a pak Nový terminál.

3. Vytvořte novou složku pomocí ikony Nová složka... v podokně Průzkumník . Zadejte název podobný dříve zaregistrované, například NewWebAPILocal.

4. Výběrem možnosti Terminál > nový terminál otevřete nový terminál.

5. Pokud chcete vytvořit ASP.NET prázdnou šablonu jádra, spuštěním následujících příkazů v terminálu přejděte do adresáře a vytvořte projekt:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio pro Mac

1. Otevřete Visual Studio a pak vyberte Nový.
2. V části Web a Konzola v levém navigačním panelu vyberte Aplikaci.
3. V části ASP.NET Core vyberte rozhraní API a ujistěte se, že je v rozevírací nabídce vybraná jazyk C# a pak vyberte Pokračovat.
4. Přijměte výchozí hodnotu pro cílovou architekturu a upřesnit a pak vyberte Pokračovat.
5. Zadejte název projektu, který se projeví v názvu řešení. Zadejte podobný název jako název zaregistrovaný v Centru pro správu Microsoft Entra, například NewAPI1.
6. Přijměte výchozí umístění projektu nebo zvolte jiné umístění a pak vyberte Vytvořit.

Poznámka:

Visual Studio pro Mac plánujeme do 31. srpna 2024 v souladu s Microsoftem Moderní zásady životního cyklu. Visual Studio pro Mac 17.6 bude nadále podporována až do 31. srpna 2024 s servisními aktualizacemi problémů se zabezpečením a aktualizovanými platformami od Společnosti Apple. Další informace najdete v tématu Co se děje Visual Studio pro Mac.

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.

1. 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 je Forecast.Readrozsah .

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

Visual Studio

1. V horní nabídce vyberte Nástroje>NuGet Správce balíčků> Nabídky NuGet pro řešení.
2. 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.
3. Vyberte OK nebo Přijímám pro jiná okna, která se můžou zobrazit.

Visual Studio Code

1. V terminálu otevřeném v předchozí části zadejte následující příkaz:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio pro Mac

1. V horní nabídce vyberte Nástroje>spravovat balíčky NuGet.
2. Vyhledejte Microsoft.Identity.Web, vyberte Microsoft.Identity.Web balíček, vyberte Projekt a pak vyberte Přidat balíček.
3. V automaticky otevíraných otevíraných oknech zkontrolujte, že je vybraný správný projekt, a pak vyberte OK.
4. Vyberte Přijmout , pokud se zobrazí jiná okna přijetí licence.

Další kroky

Kurz: Implementace chráněného koncového bodu do rozhraní API