Руководство. Создание и настройка проекта ASP.NET Core для проверки подлинности

Мақала
10/24/2023

После завершения регистрации можно создать проект ASP.NET Core с помощью интегрированной среды разработки (IDE). В этом руководстве показано, как создать проект ASP.NET Core с помощью интегрированной среды разработки и настроить для проверки подлинности и авторизации.

В этом руководстве рассматриваются следующие темы:

Создание пустого ядра ASP.NET
Настройка параметров для приложения
Определение и установка необходимых пакетов NuGet

Необходимые компоненты

Завершение предварительных требований и шагов в руководстве. Регистрация веб-API с помощью платформа удостоверений Майкрософт.
Вы можете скачать идентификаторы, используемые в этом руководстве, на странице "Загрузки".
- Visual Studio 2022 год
- Visual Studio Code
- Visual Studio 2022 для Mac

Минимальное требование пакета SDK для .NET Core 6.0.

Создание проекта ASP.NET Core

Используйте следующие вкладки, чтобы создать проект ASP.NET Core в интегрированной среде разработки.

Откройте Visual Studio и нажмите кнопку "Создать проект".
Найдите и выберите шаблон ASP.NET Core Empty , а затем нажмите кнопку "Далее".
Введите имя проекта, например NewWebAPILocal.
Выберите расположение проекта или примите параметр по умолчанию, а затем нажмите кнопку "Далее".
Примите значение по умолчанию для платформы и настройте для HTTPS.
Нажмите кнопку создания.

Откройте Visual Studio Code, выберите "Открыть папку" > .... Перейдите к папке и выберите расположение, в котором нужно создать проект.
Откройте новый терминал, выбрав терминал в верхней строке, а затем новый терминал.
Создайте новую папку с помощью значка "Новая папка..." в области Обозреватель. Укажите имя, аналогичное зарегистрированной ранее, например NewWebAPILocal.
Откройте новый терминал, выбрав терминал > "Новый терминал".
Чтобы создать шаблон ASP.NET Core Empty , выполните следующие команды в терминале, чтобы перейти в каталог и создать проект:
```
cd NewWebAPILocal
dotnet new web
```

Настройка проекта ASP.NET Core

Значения, записанные ранее, будут использоваться в appsettings.json для настройки приложения для проверки подлинности. appsettings.json — это файл конфигурации, используемый для хранения параметров приложения, используемых во время выполнения.

Откройте appsettings.json и замените содержимое файла следующим фрагментом кода:
```
{
  "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 — конечная точка поставщика облачных служб. Ознакомьтесь с различными доступными конечными точками в национальных облаках.
- TenantId — идентификатор клиента, в котором зарегистрировано приложение. Замените текст в кавычках значением идентификатора каталога (клиента), записанного ранее на странице обзора зарегистрированного приложения.
- ClientId — идентификатор приложения, который также называется клиентом. Замените текст в кавычках значением идентификатора приложения (клиента), записанным ранее на странице обзора зарегистрированного приложения.
- Scopes— область, которая используется для запроса доступа к приложению. В этом руководстве используется Forecast.Readобласть.
Сохраните изменения в файле.

Установка пакетов удостоверений

Пакеты NuGet, связанные с удостоверениями, должны быть установлены в проекте для включения проверки подлинности пользователей.

В верхнем меню выберите Сервис>NuGet диспетчер пакетов> Manage NuGet Packages for Solution.
На вкладке "Обзор" найдите Microsoft.Identity.Web, выберите Microsoft.Identity.Web пакет, выберите папку Project проверка box и нажмите кнопку "Установить".
Нажмите кнопку "ОК " или "Принять " для других окон, которые могут появиться.

В верхнем меню выберите "Сервис>управления пакетами NuGet".
Найдите Microsoft.Identity.Web, выберите Microsoft.Identity.Web пакет, выберите проект и нажмите кнопку "Добавить пакет".
В всплывающем окне убедитесь, что выбран правильный проект, а затем нажмите кнопку "ОК".
Выберите "Принять", если отображаются другие окна принятия лицензий.

Следующие шаги

Руководство. Реализация защищенной конечной точки в API

Бөлісу құралы: