Настройка Hoxhunt для автоматического создания учётных записей пользователей

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

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

Предпосылки

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

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

• Клиент Hoxhunt.
• Ключ API SCIM и URL-адрес конечной точки SCIM для вашей организации (настроена поддержкой Hoxhunt).

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

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

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

Обратитесь в службу поддержки Hoxhunt, чтобы получить ключ API SCIM и URL-адрес конечной точки SCIM, чтобы настроить Hoxhunt для поддержки предоставления с помощью Microsoft Entra ID.

Шаг 3. Добавление Hoxhunt из коллекции приложений Microsoft Entra

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

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

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

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

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

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

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

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

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

2. Перейдите в Идентификация>Приложения>Корпоративные приложения

   

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

   

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

   

5. Для параметра Режим подготовки к работе выберите значение Automatic (Автоматически).

   

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

   

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

   

8. Выберите Сохранить.

9. В разделе Сопоставления выберите Синхронизировать пользователей Microsoft Entra с Hoxhunt.

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

    Атрибут	Тип	Поддерживается для фильтрации	Требуется от Hoxhunt
    userName	Струна	✓	✓
    emails[type eq "рабочий"].value	Струна		✓
    активный	булевый
    имя.данноеИмя	Струна
    имя_фамилия	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:отдел	Струна
    адреса[тип равен "работа"].страна	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:подразделение	Струна
    предпочитаемый язык	Струна
    адреса[тип eq "рабочий"].местоположение	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:пользователь:менеджер	Ссылка

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

12. Чтобы включить службу подготовки Microsoft Entra для Hoxhunt, измените состояния подготовки на Onв разделе "Параметры".

    

13. Определите пользователей и/или группы, которым вы хотите предоставить доступ в Hoxhunt, выбрав нужные значения в Область в разделе "Параметры".

    

14. Когда будете готовы настроить, нажмите Сохранить.

    

Эта операция запускает начальный цикл синхронизации всех пользователей и групп, определенных в разделе "Область" в разделе "Параметры". Начальный цикл занимает больше времени, чем последующие циклы, которые происходят примерно каждые 40 минут, при условии, что служба подготовки Microsoft Entra работает.

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

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

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

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

• 20.04.2021. Добавлена поддержка основного атрибута пользователя предпочитаемого языка и атрибута корпоративного расширения urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.
• 08.08.2023 — добавлена поддержка основных атрибутов пользователя адреса[тип eq "work"].locality|Атрибут строкового и корпоративного расширения urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.

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

• Управление подготовкой учетных записей пользователей для корпоративных приложений
• Что такое доступ к приложению и единый вход с помощью идентификатора Microsoft Entra?

Связанный контент

• Узнайте, как просматривать журналы и получать отчеты об активности по предоставлению ресурсов