Настройте LanSchool Air для автоматического создания пользователей с помощью Microsoft Entra ID

В этой статье описаны шаги, которые необходимо выполнить как в LanSchool Air, так и в идентификаторе Microsoft Entra для настройки автоматической подготовки пользователей. При настройке Microsoft Entra ID автоматически создает и удаляет пользователей и группы в LanSchool Air с помощью службы подготовки Microsoft Entra ID. Важные сведения о том, что делает эта служба, как она работает, а также ответы на часто задаваемые вопросы можно найти в статье Автоматизация предоставления и удаления доступа пользователей к SaaS-приложениям с помощью Microsoft Entra ID.

Поддерживаемые возможности

  • Создайте пользователей в LanSchool Air.
  • Удалите пользователей в LanSchool Air, если они больше не требуют доступа.
  • Синхронизация атрибутов пользователей между идентификатором Microsoft Entra и LanSchool Air.
  • Единый вход в LanSchool Air.
  • Поддерживается аутентификация с использованием долгоживущих токенов типа носителя.

Предпосылки

В сценарии, описанном в этой статье, предполагается, что у вас уже есть следующие условия:

Шаг 1. Планирование развертывания снабжения

  1. Узнайте, как работает служба снабжения.
  2. Определите, кто входит в область предоставления ресурсов.
  3. Определите, какие данные необходимо сопоставить между идентификатором Microsoft Entra и LanSchool Air.

Шаг 2. Настройка LanSchool Air для поддержки подготовки с помощью идентификатора Microsoft Entra

  1. Войдите в LanSchool Air от имени администратора сайта.

  2. Выберите меню в левом верхнем углу и выберите пункт "Параметры".

    Снимок экрана: меню

  3. Выберите конфигурацию единого входа.

    Скриншот страницы настроек конфигурации SSO (единой авторизации).

  4. Нажмите кнопку "Создать". Система создает случайный маркер секрета. Выберите "Копировать".

    Снимок экрана: диалоговое окно создания маркеров SCIM.

Добавьте LanSchool Air из коллекции приложений Microsoft Entra, чтобы начать управление подготовкой в LanSchool Air. Если вы ранее настроили LanSchool Air для единого входа, можно использовать то же приложение. Однако рекомендуется создать отдельное приложение при первоначальном тестировании интеграции. Узнайте больше о добавлении приложения из галереи здесь.

Шаг 4. Определение того, кто подлежит обеспечению

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

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

  • Если вам нужны дополнительные роли, можно обновить манифест приложения , чтобы добавить новые роли.

Шаг 5. Настройка автоматической подготовки пользователей в LanSchool Air

В этом разделе описаны инструкции по настройке службы подготовки Microsoft Entra для создания, обновления и отключения пользователей и (или) групп в LanSchool Air на основе назначений пользователей и (или) групп в идентификаторе Microsoft Entra.

Чтобы настроить автоматическое предоставление пользователей для LanSchool Air в Microsoft Entra ID:

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

  2. Перейдите к Entra ID>приложениям для предприятий

    Снимок экрана панели «Корпоративные приложения».

  3. В списке приложений выберите LanSchool Air.

    Снимок экрана: ссылка LanSchool Air в списке приложений.

  4. Выберите вкладку Подготовка.

    Снимок экрана: вкладка

  5. Выберите + Новая конфигурация.

    Автоматический снимок экрана вкладки

  6. В поле URL-адрес арендатора введите URL-адрес арендатора LanSchool Air и секретный токен. Выберите "Проверить подключение", чтобы убедиться, что идентификатор Microsoft Entra может подключиться к LanSchool Air. Если подключение завершается ошибкой, убедитесь, что учетная запись LanSchool Air имеет необходимые разрешения администратора и повторите попытку.

    Скриншот тестового подключения службы управления.

  7. Нажмите кнопку "Создать", чтобы создать конфигурацию.

  8. Выберите "Свойства " на странице обзора .

  9. Щелкните значок "Изменить ", чтобы изменить свойства. Включите уведомления по электронной почте и предоставьте сообщение электронной почты для получения уведомлений о карантине. Включение предотвращения случайных удалений. Выберите Применить, чтобы сохранить изменения.

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

    Снимок экрана: страница свойств управления конфигурацией.

  11. Выберите сопоставление атрибутов на левой панели и выберите пользователей.

  12. Просмотрите атрибуты пользователя, синхронизированные из Microsoft Entra ID в LanSchool Air, в разделе "Сопоставление атрибутов". Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления учетных записей пользователей в LanSchool Air для операций обновления. Если вы решили изменить соответствующий целевой атрибут, необходимо убедиться, что API LanSchool Air поддерживает фильтрацию пользователей на основе этого атрибута. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Свойство Тип Поддерживается для фильтрации Требуется приложением LanSchool Air
    userName Струна
    активный Булев
    имя.имяОтчество Струна
    имя_фамилия Струна
    externalId (внешний идентификатор) Струна
  13. Чтобы настроить фильтры области, ознакомьтесь с инструкциями, приведенными в статье о фильтре области.

  14. Используйте подготовку по запросу для проверки синхронизации с небольшим количеством пользователей перед развертыванием в организации.

  15. Когда вы будете готовы к подготовке, выберите "Начать подготовку " на странице обзора .

Шаг 6. Мониторинг развертывания

После настройки подготовки используйте следующие ресурсы для мониторинга развертывания:

  1. Используйте журналы подготовки для определения успешной или неудачной подготовки пользователей.
  2. Проверьте индикатор прогресса, чтобы увидеть состояние цикла подготовки и узнать, насколько близко оно к завершению.
  3. Если конфигурация предоставления ресурсов кажется неисправной, приложение переходит в режим изоляции. Узнайте больше о состоянии карантина из статьи о состоянии карантина подготовки приложений .

Дополнительные ресурсы