Настройка Apex Portal для единого входа с помощью идентификатора Microsoft Entra

2025-04-07

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

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

Предпосылки

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

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

Подписка Apex Portal с активированной функцией единого входа (SSO).

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

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

Apex Portal поддерживает вход в систему, инициированный IDP.
Apex Portal поддерживает подготовку пользователей в режиме точно в срок.

Добавьте Apex Portal из коллекции

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

Войдите в Центр администрирования Microsoft Entra с учетной записью не ниже администратора облачных приложений.
Перейдите к разделу Entra ID>корпоративные приложения>Новое приложение.
В разделе "Добавление из коллекции " в поле поиска введите Apex Portal .
Выберите Apex Portal на панели результатов и добавьте это приложение. Подождите несколько секунд, пока приложение будет добавлено в ваш арендный объект.

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

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

Настройте и проверьте единый вход Microsoft Entra в Apex Portal с помощью тестового пользователя B.Simon. Чтобы единый вход работал, необходимо установить связь между пользователем Microsoft Entra и соответствующим пользователем на портале Apex.

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

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

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

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

Войдите в Центр администрирования Microsoft Entra с учетной записью не ниже администратора облачных приложений.
Перейдите к Entra ID>Приложения для предприятий>Apex Portal>Единая аутентификация.
На странице Выбор метода единого входа выберите SAML.
На странице Настройка единого входа с помощью SAML выберите значок карандаша для базовой конфигурации SAML, чтобы изменить параметры.
На странице Настройка единого входа с помощью SAML введите значения для следующих полей:

a. В текстовом поле Идентификатор введите URL-адрес в следующем формате: https://<customer name>.apexanalytix.com/saml/sso.aspx.

б. В текстовом поле URL-адрес ответа введите URL-адрес в следующем формате: https://<customer name>.apexanalytix.com/saml/sso.aspx.

Примечание.

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

Помимо вышеуказанного, приложение Apex Portal ожидает несколько дополнительных атрибутов, которые должны быть возвращены в ответе SAML, показанном ниже. Эти атрибуты также заранее заполнены, но вы можете изменить их в соответствии со своими требованиями.

Имя	Атрибут источника
ИМЯ	имя_пользователя.givenname
ФАМИЛИЯ	Фамилия пользователя
ПОЧТА	почта_пользователя

На странице Настройка единого входа с помощью SAML в разделе Сертификат подписи SAML найдите Федеративные метаданные XML и выберите Скачать, чтобы скачать сертификат и сохранить его на компьютере.
В разделе "Настройка Apex Portal " скопируйте соответствующие URL-адреса в соответствии с вашим требованием.

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

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

Настройка единого входа на портале Apex

Чтобы настроить единый вход на стороне Apex Portal , необходимо отправить скачанный XML-код метаданных федерации и соответствующие URL-адреса, скопированные из конфигурации приложения, в службу поддержки Apex Portal. Чтобы правильно настроить соединение SAML SSO с обеих сторон, они задали этот параметр.

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

В этом разделе пользователь с именем Britta Simon создается на портале Apex. Apex Portal поддерживает подготовку пользователей по требованию, которая включена по умолчанию. В этом разделе для вас нет пункта действий. Если пользователь еще не существует на портале Apex, он создается после проверки подлинности.

Примечание.

Если вам нужно создать пользователя вручную, обратитесь в службу поддержки Apex Portal.

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

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

Выберите "Тестировать это приложение", и вы автоматически войдете на портал Apex, для которого настроили единый вход.
Вы можете использовать Microsoft My Apps. При выборе плитки Apex Portal в разделе "Мои приложения" вы автоматически войдете на портал Apex, для которого настроили единый вход. Дополнительные сведения о моих приложениях см. в разделе Введение в"Мои приложения".

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