Udostępnij za pośrednictwem


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

Tworzenie projektu platformy ASP.NET Core

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

  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.

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.

  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.

Następne kroki