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.
- Otwórz program Visual Studio, a następnie wybierz pozycję Utwórz nowy projekt.
- Wyszukaj i wybierz szablon ASP.NET Core Empty , a następnie wybierz przycisk Dalej.
- Wprowadź nazwę projektu, na przykład NewWebAPILocal.
- Wybierz lokalizację projektu lub zaakceptuj opcję domyślną, a następnie wybierz przycisk Dalej.
- Zaakceptuj ustawienie domyślne dla platformyi skonfiguruj dla protokołu HTTPS.
- 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.
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 jestForecast.Read
.
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.
- W górnym menu wybierz pozycję Narzędzia>NuGet Menedżer pakietów> Zarządzanie pakietami NuGet dla rozwiązania.
- 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. - Wybierz przycisk OK lub Akceptuję dla innych okien, które mogą być wyświetlane.