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

Руководство. Регистрация и настройка приложения MAUI .NET в внешнем клиенте

  • Статья

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

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

  • Зарегистрируйте приложение .NET MAUI для настольных ПК в арендаторе клиента.
  • Создайте поток пользователя для входа и выхода в среде арендатора клиентов.
  • Свяжите настольное приложение .NET MAUI с потоком пользователей.

Предварительные требования

  • Внешний арендатор. Если у вас нет, создайте пробный клиент или клиент с подпиской перед началом работы.
  • Эта учетная запись Azure должна иметь разрешения на управление приложениями. Любые из следующих ролей Microsoft Entra включают необходимые разрешения:
    • Администратор приложений
    • Разработчик приложения
    • Администратор облачных приложений

Регистрация настольного приложения .NET MAUI

Чтобы ваше приложение могло выполнять вход пользователей с помощью Microsoft Entra, внешняя идентификация Microsoft Entra должна быть осведомлена о создаваемом вами приложении. Регистрация приложения устанавливает отношение доверия между приложением и Microsoft Entra. При регистрации приложения внешний идентификатор создает уникальный идентификатор, известный как идентификатор приложения (клиента), значение, используемое для идентификации приложения при создании запросов проверки подлинности.

Ниже показано, как зарегистрировать приложение в Центре администрирования Microsoft Entra:

  1. Войдите в Центр администрирования Microsoft Entra в качестве как минимум разработчика приложений.

  2. Если у вас есть доступ к нескольким клиентам, используйте значок параметров в верхнем меню, чтобы переключиться на внешний клиент из меню каталогов и подписок.

  3. Перейдите к Идентификация>Приложения>Регистрация приложений.

  4. Выберите + Создать регистрацию.

  5. На отображаемой странице регистрации приложения;

    1. Введите понятное имя приложения, отображаемое пользователям приложения, например ciam-client-app.
    2. В разделе Поддерживаемые типы учетных записей выберите Учетные записи только в этом каталоге организации.

  6. Выберите Зарегистрировать.

  7. Панель обзора приложения отображается при успешной регистрации. Запишите идентификатор приложения (клиента), который будет использоваться в исходном коде приложения.

Чтобы указать тип приложения для регистрации приложения, выполните следующие действия.

  1. В разделе Управление выберите Проверка подлинности.
  2. На странице конфигураций платформы выберите "Добавить платформу", а затем выберите пункт "Мобильные и классические приложения".
  3. msalEnter_the_Application_Id_Here://auth, замените Enter_the_Application_Id_Here идентификатором приложения (клиента), скопированным ранее, а затем нажмите кнопку "Настроить".
  4. Выберите Сохранить, чтобы сохранить изменения.

После регистрации ваше приложение получает разрешение User.Read. Однако, поскольку клиент является внешним клиентом, сами пользователи клиента не могут согласиться с этим разрешением. Вы, как администратор клиента, должны предоставить это разрешение от имени всех пользователей в клиенте:

  1. На странице Регистрация приложений выберите созданное приложение (например, ciam-client-app), чтобы открыть страницу обзора.

  2. В разделе Управление выберите Разрешения API.

    1. Выберите "Предоставить согласие администратора" для <имени> клиента, а затем нажмите кнопку "Да".
    2. Выберите Обновить, а затем убедитесь, что предоставлено для <имя клиента> отображается в Состояние для разрешения.

Создание потока пользователей

Выполните следующие действия, чтобы создать поток пользователя, который клиент может использовать для входа в систему или регистрации в приложении.

  1. Войдите в центр администрирования Microsoft Entra как минимум с ролью Администратора потока пользователей внешних идентификаторов.

  2. Если у вас есть доступ к нескольким клиентам, используйте значок параметров в верхнем меню, чтобы переключиться на внешний клиент из меню каталогов и подписок.

  3. Перейдите к Идентификация>Внешние удостоверения>Потоки пользователей.

  4. Выберите + Новый поток пользователя.

  5. На странице создания:

    1. Введите имя потока пользователя, например SignInSignUpSample.

    2. В списке поставщиков удостоверений личности выберите учетные записи электронной почты. Этот поставщик удостоверений позволяет пользователям входить или регистрироваться с помощью своего адреса электронной почты.

      Примечание.

      Дополнительные поставщики удостоверений будут перечислены здесь только после настройки федеративной связи с ними. Например, если вы настроили федерацию с Google, Facebook, Apple или поставщиком удостоверений OIDC , вы сможете выбрать этих дополнительных поставщиков удостоверений здесь.

    3. В разделе "Учетные записи электронной почты" можно выбрать один из двух вариантов. В этом руководстве выберите "Электронная почта с паролем".

      • Электронная почта с паролем: позволяет новым пользователям регистрироваться и входить в систему с помощью адреса электронной почты в качестве имени входа и пароля в качестве их первых учетных данных фактора.
      • Одноразовый секретный код электронной почты: позволяет новым пользователям регистрироваться и выполнять вход с помощью адреса электронной почты в качестве имени входа и однократного секретного кода электронной почты в качестве учетных данных первого фактора. Одноразовый пароль для электронной почты должен быть включен на уровне клиента (все поставщики удостоверений>Одноразовый пароль для электронной почты), чтобы этот параметр был доступен для потока пользователя.

    4. В разделе "Атрибуты пользователя" выберите атрибуты, которые необходимо собрать от пользователя при регистрации. Выбрав "Показать больше", можно выбрать атрибуты и утверждения для страны или региона, отображаемого имени и почтового индекса. Нажмите ОК. (Пользователей запрашивают атрибуты только при первой регистрации.)

  6. Нажмите кнопку создания. Новый поток пользователя появится в списке Потоки пользователей. Если потребуется, обновите страницу.

Чтобы включить самостоятельный сброс пароля, выполните действия, описанные в статье "Включение самостоятельного сброса пароля".

Связывание настольного приложения .NET MAUI с потоком пользователя

Чтобы пользователи клиента видели возможность регистрации или входа при использовании приложения, необходимо связать приложение с потоком пользователя. Хотя многие приложения могут быть связаны с потоком пользователя, одно приложение может быть связано только с одним потоком пользователя.

  1. В меню боковой панели выберите "Удостоверение".

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

  3. На странице "Потоки пользователей" выберите имя потока пользователя, созданное ранее, например SignInSignUpSample.

  4. В разделе "Использование" выберите "Приложения".

  5. Выберите Добавить приложение.

  6. Выберите приложение из списка, например ciam-client-app или используйте поле поиска для поиска приложения, а затем выберите его.

  7. Выберите Select.

Связав приложение с потоком пользователей, вы можете протестировать поток пользователя, имитируя процесс регистрации или входа пользователя с приложением из Центра администрирования Microsoft Entra. Для этого выполните действия, описанные в разделе "Тестирование регистрации и входа в поток пользователя".

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

Часть 2: Создание shell-приложения .NET MAUI, добавление пакета SDK MSAL и включение ресурса изображения