Samouczek: tworzenie i konfigurowanie projektu ASP.NET Core na potrzeby uwierzytelniania

Z tego samouczka dowiesz się, jak utworzyć projekt ASP.NET Core przy użyciu środowiska IDE i skonfigurować go pod kątem uwierzytelniania i autoryzacji. Ten samouczek jest drugą częścią serii, która pokazuje, jak zabezpieczyć internetowy interfejs API przy użyciu Platforma tożsamości Microsoft. W poprzednim artykule zarejestrowano aplikację w dzierżawie microsoft Entra ID. W tym artykule;

• Tworzenie projektu ASP.NET Core Empty w środowisku IDE
• Konfigurowanie ustawień aplikacji
• Identyfikowanie i instalowanie wymaganych pakietów NuGet

Wymagania wstępne

• Ukończenie wymagań wstępnych i kroków w artykule Samouczek: rejestrowanie internetowego interfejsu API przy użyciu Platforma tożsamości Microsoft.
• Identyfikatory IDE używane w tym samouczku można pobrać ze strony Pliki do pobrania .
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 dla komputerów Mac

• Minimalne wymaganie zestawu .NET 6.0 SDK.

Tworzenie projektu platformy ASP.NET Core

Użyj poniższych kart, aby utworzyć projekt ASP.NET Core w środowisku IDE.

Program Visual Studio

1. Otwórz program Visual Studio, a następnie wybierz pozycję Utwórz nowy projekt.
2. Wyszukaj i wybierz szablon ASP.NET Core Empty , a następnie wybierz przycisk Dalej.
3. Wprowadź nazwę projektu, na przykład NewWebAPILocal.
4. Wybierz lokalizację projektu lub zaakceptuj opcję domyślną, a następnie wybierz przycisk Dalej.
5. Zaakceptuj ustawienie domyślne dla platformyi skonfiguruj dla protokołu HTTPS.
6. Wybierz pozycję Utwórz.

Visual Studio Code

1. Otwórz program Visual Studio Code, wybierz pozycję Plik > Otwórz folder.... Przejdź do i wybierz lokalizację, w której chcesz utworzyć projekt.

2. Otwórz nowy terminal, wybierając pozycję Terminal na górnym pasku, a następnie pozycję Nowy terminal.

3. Utwórz nowy folder przy użyciu ikony Nowy folder... w okienku Eksplorator . Podaj nazwę podobną do nazwy zarejestrowanej wcześniej, na przykład NewWebAPILocal.

4. Otwórz nowy terminal, wybierając pozycję Terminal > Nowy terminal.

5. Aby utworzyć szablon ASP.NET Core Empty , uruchom następujące polecenia w terminalu, aby przejść do katalogu i utworzyć projekt:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio dla komputerów Mac

1. Otwórz program Visual Studio, a następnie wybierz pozycję Nowy.
2. W obszarze Sieć Web i konsola na pasku nawigacyjnym po lewej stronie wybierz pozycję Aplikacja.
3. W obszarze ASP.NET Core wybierz pozycję INTERFEJS API i upewnij się, że język C# jest zaznaczony w menu rozwijanym, a następnie wybierz pozycję Kontynuuj.
4. Zaakceptuj wartość domyślną dla platformy docelowej i pozycji Zaawansowane, a następnie wybierz pozycję Kontynuuj.
5. Wprowadź nazwę projektu. Zostanie to odzwierciedlone w polu Nazwa rozwiązania. Podaj podobną nazwę do tej zarejestrowanej w centrum administracyjnym firmy Microsoft Entra, na przykład NewAPI1.
6. Zaakceptuj domyślną lokalizację projektu lub wybierz inną lokalizację, a następnie wybierz pozycję Utwórz.

Uwaga

Visual Studio dla komputerów Mac ma zostać wycofany do 31 sierpnia 2024 r. zgodnie z przepisami firmy MicrosoftNowoczesne zasady cyklu życia. Visual Studio dla komputerów Mac wersji 17.6 będzie nadal obsługiwana do 31 sierpnia 2024 r. wraz z aktualizacjami obsługi problemów z zabezpieczeniami i zaktualizowanymi platformami firmy Apple. Aby uzyskać więcej informacji, zobacz Co się dzieje z Visual Studio dla komputerów Mac.

Konfigurowanie projektu ASP.NET Core

Zarejestrowane wcześniej wartości będą używane w appsettings.json do konfigurowania aplikacji na potrzeby uwierzytelniania. appsettings.json to plik konfiguracji używany do przechowywania ustawień aplikacji używanych w czasie wykonywania.

1. Otwórz appsettings.json i zastąp zawartość pliku następującym fragmentem kodu:

   {
     "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 — Punkt końcowy dostawcy usług w chmurze. Sprawdź różne dostępne punkty końcowe w chmurach krajowych.
   • TenantId — identyfikator dzierżawy, w której zarejestrowano aplikację. Zastąp tekst w cudzysłowach wartością identyfikatora katalogu (dzierżawy), która została zarejestrowana wcześniej na stronie przeglądu zarejestrowanej aplikacji.
   • ClientId — Identyfikator aplikacji, nazywany również klientem. Zastąp tekst w cudzysłowach wartością identyfikatora aplikacji (klienta), która została zarejestrowana wcześniej na stronie przeglądu zarejestrowanej aplikacji.
   • Scopes — Zakres używany do żądania dostępu do aplikacji. W tym samouczku zakresem jest Forecast.Read.

2. Zapisz zmiany w pliku.

Instalowanie pakietów tożsamości

Pakiety NuGet związane z tożsamościami muszą być zainstalowane w projekcie, aby umożliwić uwierzytelnianie użytkowników.

Program Visual Studio

1. W górnym menu wybierz pozycję Narzędzia>NuGet Menedżer pakietów> Zarządzanie pakietami NuGet dla rozwiązania.
2. Po wybraniu karty Przeglądaj wyszukaj ciąg Microsoft.Identity.Web, wybierz pakiet, zaznacz Microsoft.Identity.Web pole wyboru Projekt, a następnie wybierz pozycję Zainstaluj.
3. Wybierz przycisk OK lub Akceptuję dla innych okien, które mogą być wyświetlane.

Visual Studio Code

1. W terminalu otwartym w poprzedniej sekcji wprowadź następujące polecenie:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio dla komputerów Mac

1. W górnym menu wybierz pozycję Narzędzia>Zarządzaj pakietami NuGet.
2. Wyszukaj ciąg Microsoft.Identity.Web, wybierz Microsoft.Identity.Web pakiet, wybierz pozycję Projekt, a następnie wybierz pozycję Dodaj pakiet.
3. W wyskakującym oknie podręcznym upewnij się, że wybrano prawidłowy projekt, a następnie wybierz przycisk OK.
4. Wybierz pozycję Zaakceptuj , jeśli są wyświetlane inne okna akceptacji licencji .

Następne kroki

Samouczek: implementowanie chronionego punktu końcowego do interfejsu API