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

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

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

Предпосылки

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

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

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

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

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

Чтобы подключить приложение управления выдачей к вашей учетной записи Gtmhub, необходимо выдать токен SCIM и сформировать URL-адрес арендатора.

Чтобы выдать новый токен SCIM, выполните приведенные действия.

1. Войдите в учетную запись Gtmhub. Перейдите к маркерам > API конфигурации > параметров.

   

2. Выберите Выпустить токен и выберите SCIM. Введите имя маркера и нажмите кнопку "Создать маркер API ".

   

3. После создания маркера можно скопировать и использовать его в приложении предоставления Microsoft Entra.

   

Чтобы скомпилировать URL-адрес клиента, выполните следующие действия.

1. URL-адрес клиента должен иметь следующий формат:

   https://app.gtmhub.com/api/v1/scim/azure/{account_id}

2. Если учетная запись Gtmhub находится в центре обработки данных США, вам также нужно добавить центр обработки данных в URL-адрес:

   https://app.us.gtmhub.com/api/v1/scim/azure/{account_id}

3. Чтобы получить идентификатор учетной записи, перейдите на вкладку "Параметры" , а затем перейдите на вкладку "Маркеры API " и скопируйте идентификатор учетной записи:

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

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

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

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

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

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

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

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

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

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

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

   

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

   

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

   

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

   

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

   

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

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

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

   

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

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

    Атрибут	Тип	Поддерживается для фильтрации
    userName	Струна	✓
    externalId (внешний идентификатор)	Струна	✓
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Пользователь:менеджер	Ссылка

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

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

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

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

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

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

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

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

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

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