Поделиться через


Руководство: Создание приложения оболочки .NET MAUI

Это руководство является частью 2 серии, демонстрирующей создание приложения оболочки .NET Multi-platform App UI (.NET MAUI) и подготовка его к проверке подлинности с помощью Центра администрирования Microsoft Entra. В части 1 этой сериивы зарегистрировали приложение и настроили потоки пользователей во внешнем клиенте. В этом руководстве вы добавите пользовательский вспомогательный модуль клиента Microsoft Authentication Library (MSAL) для инициализации MSAL SDK, установите необходимые библиотеки и включите ресурс изображения.

В этом руководстве описано, как это сделать.

  • Создайте приложение оболочки .NET MAUI.
  • Добавьте поддержку пакета SDK MSAL с помощью вспомогательных классов MSAL.
  • Установите необходимые пакеты.
  • Добавьте ресурс изображения.

Необходимые условия

Создайте приложение оболочки .NET MAUI

  1. В окне запуска Visual Studio 2022 выберите Создать проект.
  2. В окне Создание нового проекта выберите MAUI в раскрывающемся списке "Все типы проектов", выберите шаблон приложения .NET MAUI и выберите далее.
  3. В окне Настройка нового проекта имя проекта должно иметь значение SignInMaui. Обновите имя решения , чтобы войти в maui и выбрать Next.
  4. В окне Дополнительные сведения выберите последнюю версию пакета SDK для .NET и выберите Создать.

Подождите, пока проект будет создан и восстановлены его зависимости.

Добавление поддержки пакета SDK MSAL с помощью вспомогательных классов MSAL

Клиент MSAL позволяет разработчикам получать маркеры безопасности от внешнего клиента для проверки подлинности и доступа к защищенным веб-API. В этом разделе вы скачиваете файлы, составляющие MSALClient.

Скачайте следующие файлы в папку на компьютере:

  • AzureAdConfig.cs . Этот файл получает и задает уникальные идентификаторы приложения Microsoft Entra из файла конфигурации приложения.
  • DownStreamApiConfig.cs . Этот файл получает и задает области для вызова Microsoft Graph.
  • DownstreamApiHelper.cs — этот файл обрабатывает исключения, возникающие при вызове нижестоящего API.
  • Exception.cs . Этот файл предлагает несколько методов расширения, связанных с вызовом исключений и обработкой.
  • IdentityLogger.cs — этот дескриптор файла показывает, как использовать ведение журнала MSAL.NET.
  • MSALClientHelper.cs . Этот файл содержит методы инициализации пакета SDK MSAL.
  • PlatformConfig.cs — этот файл содержит методы для обработки конкретной платформы. Например, Windows.
  • PublicClientSingleton.cs . Этот файл содержит единую реализацию для оболочки MSALClient и связанных классов для поддержки статической модели инициализации для платформ.
  • WindowsHelper.cs . Этот файл содержит методы для получения хэндла окна.

Важный

Не пропускайте скачивание файлов MSALClient, они необходимы для выполнения этого руководства.

Перемещение файлов MSALClient с помощью Visual Studio

  1. В области обозревателя решений щелкните правой кнопкой мыши проект SignInMaui и выберите Добавить>Новая папка. Присвойте папке имя MSALClient.
  2. Щелкните правой кнопкой мыши папку MSALClient, выберите Добавить>Существующий элемент....
  3. Перейдите в папку, содержащую скачанные файлы MSALClient, скачанные ранее.
  4. Выберите все скачанные файлы MSALClient, а затем выберите Добавить

Установка необходимых пакетов

Необходимо установить следующие пакеты:

  • Microsoft.Identity.Client . Этот пакет содержит двоичные файлы библиотеки проверки подлинности Майкрософт для .NET (MSAL.NET).
  • Microsoft.Extensions.Configuration.Json . Этот пакет содержит реализацию поставщика конфигурации JSON для Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Binder . Этот пакет содержит функциональные возможности для привязки объекта к данным в поставщиках конфигураций для Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Abstractions. Этот пакет содержит абстракции конфигурации, основанной на парах "ключ-значение".
  • Microsoft.Identity.Client.Extensions.Msal . Этот пакет содержит расширения библиотеки проверки подлинности Майкрософт для .NET (MSAL.NET).

Диспетчер пакетов NuGet

Чтобы использовать диспетчер пакетов NuGet для установки пакета Microsoft.Identity.Client в Visual Studio, выполните следующие действия.

  1. Выберите Инструменты>Диспетчер пакетов NuGet>Управление пакетами NuGet для решения....
  2. На вкладке Обзор найдите Microsoft.Identity.Client.
  3. Выберите Microsoft.Identity.Client в списке.
  4. Выберите SignInMaui в области списка Project.
  5. Выберите Установить.
  6. Если вам будет предложено проверить установку, нажмите кнопку ОК.

Повторите процесс, чтобы установить оставшиеся необходимые пакеты.

Добавление ресурса изображения

В этом разделе вы скачайте образ, используемый в приложении, чтобы улучшить взаимодействие пользователей с ним.

Скачайте следующий образ:

  • Значок : Microsoft Entra ID. Это изображение используется в качестве значка на главной странице.

Перемещение изображения с помощью Visual Studio

  1. В панели обозревателя решений Visual Studio раскройте папку ресурсов, чтобы открыть папку изображений.
  2. Щелкните правой кнопкой мыши на Изображения и выберите Добавить>существующий элемент....
  3. Перейдите в папку, содержащую скачанные изображения.
  4. Измените фильтр на фильтр по типу файла: файлы изображений.
  5. Выберите скачанный образ.
  6. Выберите Добавить.

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