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

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

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

Предпосылки

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

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

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

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

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

Прежде чем приступить к настройке Postman для поддержки подготовки с помощью идентификатора Microsoft Entra, необходимо создать маркер API SCIM в консоли администрирования Postman.

1. Перейдите в консоль администрирования Postman , войдите в учетную запись Postman.

2. После входа в систему выберите "Команда " справа и выберите "Параметры команды".

3. Выберите проверку подлинности на боковой панели и включите переключатель подготовки SCIM .

   

4. Появится всплывающее сообщение с вопросом о том, нужно ли включить подготовку SCIM, нажмите кнопку "Включить", чтобы включить подготовку SCIM.

   

5. Чтобы создать ключ API SCIM, выполните следующие действия.

   1. Выберите "Создать ключ API SCIM" в разделе подготовки SCIM .

      

   2. Введите имя ключа и нажмите кнопку "Создать".

   3. Скопируйте новый ключ API для последующего использования и нажмите кнопку "Готово".

   Примечание.

   Вы можете вернуться к этой странице для управления ключами API SCIM. При повторном создании существующего ключа API вы можете сохранить первый ключ активным при переключении.

   Примечание.

   Чтобы продолжить включение обеспечения SCIM, см. статью Настройка SCIM с Microsoft Entra ID. Для получения дополнительных сведений или справки по настройке SCIM обратитесь в службу поддержки Postman.

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

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

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

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

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

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

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

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

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

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

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

   

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

   

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

   

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

   

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

   

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

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

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

   

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

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

    Атрибут	Тип	Поддерживается для фильтрации	Требуется для Postman
    userName	Струна	✓	✓
    активный	булевый		✓
    имя.имяОтчество	Струна		✓
    имя_фамилия	Струна		✓

12. Выберите сопоставление атрибутов на левой панели и выберите группу.

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

    Атрибут	Тип	Поддерживается для фильтрации	Требуется для Postman
    отображаемое имя	Струна	✓	✓
    члены	Ссылка

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

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

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

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

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

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

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

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

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

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