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

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

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

  • Поддерживается аутентификация через поток Code Auth Grant.
  • Создание пользователей в TravelPerk
  • Удаление пользователей в TravelPerk, когда они больше не требуют доступа
  • Синхронизация атрибутов пользователей между идентификатором Microsoft Entra и TravelPerk
  • Единый вход в TravelPerk (рекомендуется)

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

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

Шаг 1. Запланируйте развертывание предоставления ресурсов

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

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

  1. Войдите в приложение TravelPerk с учетной записью администратора.

  2. Перейдите в параметры компании>интеграции>SCIM

  3. Выберите Включить API SCIM

    Включить

  4. Также можно включить утверждения через SCIM. Утверждения помогают настроить дополнительную систему управления, гарантирующую, что поездки сначала утверждаются заданными утверждающими. Дополнительные сведения об этом см. в документации по TravelPerk.

  5. Параметры можно настроить так, чтобы менеджер каждого человека автоматически становился пользователем, ответственным за утверждение поездок. Поэтому утверждающий назначается в соответствующем процессе автоматического утверждения. TravelPerk сопоставляет значение руководителя Azure с желаемым пользователем утверждающим. Пользователь должен существовать на платформе прежде, чем стать утверждающим доступ для пользователей. Утверждающие не создаются, если они неправильно настроены в TravelPerk.

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

  7. Нажмите кнопку "Сохранить изменения" после настройки необходимого процесса утверждения.

    Автоматизировать

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

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

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

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

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

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

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

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

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

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

    Колонка корпоративных приложений

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

    Ссылка TravelPerk в списке

  4. Перейдите на вкладку "Подготовка ".

    Вкладка

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

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

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

    Учетные данные администратора

    Добро пожаловать

    Доступ

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

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

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

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

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

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

    Атрибут Тип Доступно для фильтрации
    userName Строка
    externalId (внешний идентификатор) Строка
    активный Логический
    имя.почетныйПрефикс Строка
    имя_фамилия Строка
    имя.имяОтчество Строка
    имя.второеИмя Строка
    предпочтительный язык Строка
    локаль Строка
    Номера телефонов [тип равен "работа"]. значение Строка
    externalId (внешний идентификатор) Строка
    заголовок Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:центр_затрат Строка
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Пользователь:менеджер Справочные материалы
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:User:пол Строка
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:User:датаРождения Строка
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:User:invoiceProfiles Массив
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:Пользователь:экстренныйКонтакт.имя Строка
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:User:экстренныйКонтакт.телефон Строка
    urn:ietf:params:scim:schemas:extension:travelperk:2.0:User:travelPolicy Строка
  12. Чтобы настроить фильтры области, ознакомьтесь с инструкциями, приведенными в статье о фильтре области.

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

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

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

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

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

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