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

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

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

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

Предпосылки

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

  • Учетная запись пользователя в Atea с разрешениями администратора.

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

  1. Узнайте, как работает служба предоставления.
  2. Определите, кто находится в круге лиц, подпадающих под обеспечение.
  3. Определите, какие данные следует сопоставить между идентификатором Microsoft Entra ID и Atea.

Шаг 2. Настройка Atea для поддержки предоставления с использованием Microsoft Entra ID

Обратитесь в службу поддержки Atea, чтобы настроить Atea для поддержки предоставления с помощью идентификатора Microsoft Entra.

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

Шаг 4. Определите, кто входит в область обеспечения ресурсами.

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

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

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

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

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

Чтобы настроить автоматическую подготовку пользователей для Atea в системе Microsoft Entra ID, выполните следующие действия.

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

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

    Модуль корпоративных приложений

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

    ссылка Atea в списке приложений

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

    вкладка настройки

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

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

  6. В поле URL-адрес клиента введите URL-адрес клиента atea и секретный токен. Выберите Test Connection, чтобы убедиться, что Microsoft Entra ID может подключаться к atea. Если подключение завершается ошибкой, убедитесь, что у вашей учетной записи atea есть необходимые разрешения администратора и повторите попытку.

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

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

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

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

Скриншот свойств Provisioning.

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

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

    Атрибут Тип Поддерживается для фильтрации Предписано LawVu
    userName Струна
    активный булевый
    emails[type eq "рабочий"].value Струна
    имя.givenName Струна
    имя_фамилия Струна
    форматированное имя Струна
    phoneNumbers[type eq "мобильный"].value Струна
    место действия Струна
  3. Чтобы настроить фильтры области, ознакомьтесь со следующими инструкциями, приведенными в статье о фильтре области .

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

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

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

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

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

Журнал изменений

  • 25.10.2022 — удаление основного атрибута пользователя nickName.
  • 25.10.2022. Изменено сопоставление основного атрибута пользователя name.formatted на Join(" ", [givenName], [surname]) —> name.formatted.
  • 25.10.2022 — доменные имена всех URL-адресов конфигурации OAuth в приложении Atea изменены на домен, принадлежащий Atea.

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