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

После завершения регистрации можно создать проект 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

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

Visual Studio Code

1. Откройте Visual Studio Code, выберите "Открыть папку" > .... Перейдите к папке и выберите расположение, в котором нужно создать проект.

2. Откройте новый терминал, выбрав терминал в верхней строке, а затем новый терминал.

3. Создайте новую папку с помощью значка "Новая папка..." в области Обозреватель. Укажите имя, аналогичное зарегистрированной ранее, например NewWebAPILocal.

4. Откройте новый терминал, выбрав терминал > "Новый терминал".

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

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio для Mac

1. Откройте Visual Studio и нажмите кнопку "Создать".
2. В разделе "Веб- и консоль " в левой панели навигации выберите "Приложение".
3. В разделе ASP.NET Core выберите API и убедитесь , что C# выбран в раскрывающемся меню, а затем нажмите кнопку "Продолжить".
4. Примите значение по умолчанию для целевой платформы и дополнительно, а затем нажмите кнопку "Продолжить".
5. Введите имя для имени проекта, оно будет отражено в имени решения. Укажите аналогичное имя, зарегистрированное в портал Azure, например NewAPI1.
6. Примите расположение по умолчанию для проекта или выберите другое расположение, а затем нажмите кнопку "Создать".

Примечание.

Visual Studio для Mac планируется выйти на пенсию к 31 августа 2024 г. в соответствии с корпорацией Майкрософт Современная политика жизненного цикла. Visual Studio для Mac 17.6 будет поддерживаться до 31 августа 2024 г. с обновлениями обслуживания для проблем с безопасностью и обновленными платформами от Apple. Дополнительные сведения см. в статье "Что происходит с Visual Studio для Mac".

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

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

1. Откройте 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область.

2. Сохраните изменения в файле.

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

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

Visual Studio

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

Visual Studio Code

1. В терминале, открывшемся в предыдущем разделе, введите следующую команду:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio для Mac

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

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

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