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

Применяется: Внешние клиенты (дополнительные сведения)

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

Изучив это руководство, вы:

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

• Зарегистрируйте новое клиентское веб-приложение в Центре администрирования Microsoft Entra, настроенное для учетных записей в любом каталоге организации и личных учетных записях Майкрософт. Дополнительные сведения см. в статье "Регистрация приложения ". Запишите следующие значения на странице обзора приложения для последующего использования:
  • Идентификатор приложения (клиента)
  • Идентификатор каталога (арендатора)
• Добавьте следующие URI перенаправления с помощью конфигурации платформы мобильных и классических приложений . Дополнительные сведения см. в статье о добавлении URI перенаправления в приложение .
  • URI перенаправления: msal{client_id}://auth где {client_id} находится идентификатор приложения (клиента) приложения.
• пакет SDK для .NET
• Visual Studio 2022 с установленной рабочей нагрузкой MAUI:
  • инструкции по настройке Visual Studio

Создание оболочного приложения на .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 с помощью 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. Выберите Добавить.

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