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

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

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

Предпосылки

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

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

• Подписка KnowledgeOwl с поддержкой единого входа.

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

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

• KnowledgeOwl поддерживает единый вход (SSO), инициированный SP (поставщиком услуг) и IDP (поставщиком удостоверений).
• KnowledgeOwl поддерживает предоставление пользователей в формате Just In Time (JIT).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

   a. В текстовом поле Идентификатор введите URL-адрес, используя один из следующих шаблонов:

   https://app.knowledgeowl.com/sp
   https://app.knowledgeowl.com/sp/id/<unique ID>
   

   б. В текстовом поле URL-адрес ответа введите URL-адрес, используя один из следующих шаблонов:

   https://subdomain.knowledgeowl.com/help/saml-login
   https://subdomain.knowledgeowl.com/docs/saml-login
   https://subdomain.knowledgeowl.com/home/saml-login
   https://privatedomain.com/help/saml-login
   https://privatedomain.com/docs/saml-login
   https://privatedomain.com/home/saml-login
   

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

   В текстовом поле URL-адреса входа введите URL-адрес, используя один из следующих шаблонов:

   https://subdomain.knowledgeowl.com/help/saml-login
   https://subdomain.knowledgeowl.com/docs/saml-login
   https://subdomain.knowledgeowl.com/home/saml-login
   https://privatedomain.com/help/saml-login
   https://privatedomain.com/docs/saml-login
   https://privatedomain.com/home/saml-login
   

   Примечание.

   Эти значения не являются реальными. Вам нужно обновить эти значения, используя фактический идентификатор, URL-адрес ответа и URL-адрес Sign-On, который описан далее в статье.

7. Приложение KnowledgeOwl ожидает утверждения SAML в определенном формате, который требует добавления настраиваемых сопоставлений атрибутов в конфигурацию атрибутов токена SAML. На следующем снимке экрана показан список атрибутов по умолчанию.

   

8. В дополнение к вышеупомянутому, приложение KnowledgeOwl ожидает несколько дополнительных атрибутов в ответе SAML, показанных ниже. Эти атрибуты также заранее заполнены, но вы можете изменить их в соответствии со своими требованиями.

   Имя	Атрибут источника	Пространство имен
   ssoid	почта_пользователя	http://schemas.xmlsoap.org/ws/2005/05/identity/claims

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

   

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

    

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

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

Настройка SSO для KnowledgeOwl

1. В другом окне веб-браузера войдите на корпоративный сайт KnowledgeOwl в качестве администратора.

2. Выберите "Безопасность" и "Доступ", а затем выберите единый вход.

3. На вкладке "Параметры SAML" выполните следующие действия.

   

   1. Выберите включить авторизацию чтения SAML SSO.

   

   1. В разделе метаданных поставщика услуг скопируйте значение идентификатора сущности sp и вставьте его в идентификатор (идентификатор сущности) в разделе "Базовая конфигурация SAML " на портале Azure.

   2. В разделе метаданных поставщика услуг скопируйте значение URL-адреса входа поставщика услуг и вставьте его в текстовые поля URL-адреса входа и URL-адреса ответа в разделе "Базовая конфигурация SAML " на портале Azure.

   

   1. В разделе метаданных поставщика идентификационных данных вставьте ранее скопированное значение идентификатора Microsoft Entra в текстовое поле IdP entityID.

   2. Вставьте значение URL-адреса входа , скопированное ранее в URL-адрес входа idP.

   3. Вставьте URL-адрес выхода, скопированный ранее, в текстовое поле IdP logout URL.

   4. Загрузите скачанный сертификат через портал Azure, выбрав ссылку Upload certificate под сертификатом IdP.

   5. Нажмите кнопку "Сохранить " в нижней части раздела.

4. Откройте вкладку сопоставления атрибутов SAML , чтобы сопоставить атрибуты и выполнить следующие действия:

   

   1. Введите https://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid в текстовое поле идентификатора единого входа.

   2. Введите https://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress в текстовое поле для имени пользователя или электронной почты.

   3. Введите https://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname в текстовое поле "Имя".

   4. Введите https://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname в текстовое поле Фамилия.

   5. Выберите Сохранить в нижней части экрана.

   Снимок экрана показывает кнопку «Сохранить».

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

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

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

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

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

• Выберите «Протестируйте это приложение», этот параметр приведет вас на URL-адрес входа в KnowledgeOwl, где вы можете начать процесс входа.

• Перейдите непосредственно на URL для входа в систему KnowledgeOwl и начните процесс входа оттуда.

Запуск инициирован поставщиком удостоверений

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

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

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

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