Поделиться через


Интеграция единого входа Microsoft Entra с Postman

Из этой статьи вы узнаете, как интегрировать Postman с идентификатором Microsoft Entra. Интеграция Postman с идентификатором Microsoft Entra позволяет:

  • Контролируйте, кто имеет доступ к Postman, через Microsoft Entra ID.
  • Включите автоматический вход пользователей в Postman с помощью учетных записей Microsoft Entra.
  • Управляйте своими аккаунтами централизованно.

Предпосылки

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

  • Подписка Postman с включенной поддержкой единого входа.

Примечание.

Эта интеграция также доступна для использования из облачной среды Microsoft Entra для государственных организаций США. Это приложение можно найти в коллекции облачных приложений Microsoft Entra для государственных организаций США и настроить его так же, как и в общедоступном облаке.

Описание сценария

В этой статье описана настройка и проверка единого входа Microsoft Entra в тестовой среде.

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

Примечание.

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

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

  1. Войдите в Центр администрирования Microsoft Entra с учетной записью не ниже администратора облачных приложений.
  2. Перейдите в раздел Идентификация>Приложения>Корпоративные приложения>Новое приложение.
  3. В разделе "Добавление из коллекции " в поле поиска введите Postman .
  4. Выберите Postman на панели результатов и добавьте это приложение. Подождите несколько секунд, пока приложение будет добавлено в ваш арендный объект.

Кроме того, можно также использовать мастер конфигурации корпоративных приложений. В этом мастере настройки вы можете добавить приложение в домен клиента, добавить пользователей и группы в приложение, назначить роли и также выполнить настройку единой аутентификации (SSO). Подробнее о мастерах Microsoft 365.

Настройка и проверка единого входа Microsoft Entra для Postman

Настройте и проверьте единый вход Microsoft Entra в Postman с помощью тестового пользователя B.Simon. Для обеспечения работы единого входа необходимо установить связь между пользователем Microsoft Entra и соответствующим пользователем на платформе Postman.

Чтобы настроить и протестировать SSO Microsoft Entra с Postman, выполните следующие действия.

  1. Настройте Microsoft Entra SSO - чтобы ваши пользователи могли использовать эту функцию.
    1. Создайте тестового пользователя Microsoft Entra для тестирования единого входа Microsoft Entra с помощью B.Simon.
    2. Назначьте тестового пользователя Microsoft Entra, чтобы Б.Саймон мог использовать функцию единого входа Microsoft Entra.
  2. Настройте SSO в Postman, чтобы установить параметры единого входа на стороне приложения.
    1. Создайте тестового пользователя в Postman, чтобы иметь аналог B.Simon в Postman, связанный с представлением пользователя Microsoft Entra.
  3. Тест SSO - для проверки, работает ли конфигурация.

Настройте SSO в Microsoft Entra

Выполните следующие действия, чтобы активировать Microsoft Entra SSO.

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

  2. Перейдите к Identity>Applications>Enterprise applications>Postman>Single sign-on.

  3. На странице Выбор метода единого входа выберите SAML.

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

    Изменить базовую конфигурацию SAML

  5. В разделе Базовая конфигурация SAML выполните следующие действия, если вы хотите настроить приложение в режиме, инициируемом IDP:

    В текстовом поле URL-адрес ответа введите URL-адрес в следующем формате: https://identity.getpostman.com/sso/<INSTANCE_NAME>/callback.

  6. Выберите "Задать дополнительные URL-адреса " и выполните следующий шаг, если вы хотите настроить приложение в режиме, инициированном поставщиком служб :

    В текстовом поле URL-адрес входа введите URL-адрес в формате https://identity.getpostman.com/sso/<INSTANCE_NAME>/init.

    Примечание.

    Эти значения не являются реальными. Измените их на фактические значения URL-адреса ответа и URL-адреса входа. Чтобы получить эти значения, обратитесь в службу поддержки клиентов Postman . Вы также можете ссылаться на шаблоны, показанные в разделе Базовая конфигурация SAML.

  7. Приложение Postman ожидает утверждения SAML в определенном формате, который требует добавления настраиваемых сопоставлений атрибутов в конфигурацию атрибутов токена SAML. На следующем снимке экрана показан пример этого. Значение по умолчанию уникального идентификатора пользователя — user.userprincipalname , но Postman ожидает, что это сопоставляется с адресом электронной почты пользователя. Для этого можно использовать атрибут user.mail из списка или соответствующее значение атрибута, основанное на конфигурации организации.

    изображение

  8. На странице Настройка единого входа с помощью SAML в разделе Сертификат подписи SAML найдите Федеративные метаданные XML и выберите Скачать, чтобы скачать сертификат и сохранить его на компьютере.

    Ссылка для скачивания сертификата

  9. В разделе "Настройка Postman " скопируйте соответствующие URL-адреса в соответствии с вашим требованием.

    Скопировать URL-адреса настроек

Создание и назначение тестового пользователя Microsoft Entra

Следуйте инструкциям из краткого руководства «Создание и назначение учетной записи пользователя», чтобы создать тестовую учетную запись пользователя с именем B.Simon.

Настройка единого входа Postman

Чтобы настроить единый вход на стороне Postman, необходимо загрузить скачанный XML-файл метаданных федерации и обновить соответствующие скопированные URL-адреса в Postman. Инструкцию по настройке единого входа Postman см. в пошаговом руководстве.

Создание тестового пользователя Postman

В этом разделе пользователь с именем Britta Simon создается в Postman. Postman поддерживает подготовку пользователей по требованию, которая может быть включена установкой флажка «Автоматически добавлять новых пользователей». При этом, если пользователь еще не существует в Postman, он создается после проверки подлинности.

Тестирование SSO

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

Инициировано Поставщиком Услуг

  • Выберите "Протестировать это приложение", этот параметр ведет на URL для входа в Postman, где вы можете начать процесс входа.

  • Перейдите непосредственно по URL-адресу входа в Postman и начните процесс входа оттуда.

Инициатор IDP:

  • Выберите "Тестировать это приложение", и вы автоматически войдете в Postman, для которого настроили SSO.

Вы также можете использовать Microsoft My Apps для тестирования приложения в любом режиме. При выборе плитки Postman в разделе "Мои приложения", если она настроена в режиме службы провайдера (SP), вы будете перенаправлены на страницу входа приложения для инициации процесса входа, а если настроена в режиме поставщика удостоверений (IDP), вы автоматически войдете в Postman, для которого настроили единый вход (SSO). Дополнительные сведения о моих приложениях см. в разделе Введение в"Мои приложения".

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