Руководство по интеграции единого входа Microsoft Entra с KnowledgeOwl

Статья
09/22/2023

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

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

Предварительные требования

Чтобы приступить к работе, потребуется следующее.

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

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

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

KnowledgeOwl поддерживает единый вход, инициированный поставщиком услуг и поставщиком удостоверений.
KnowledgeOwl поддерживает JIT-подготовку пользователей.

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

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

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

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

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

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

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

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

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

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

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

а. В текстовом поле Идентификатор введите URL-адрес, используя один из следующих шаблонов:
```
https://app.knowledgeowl.com/sp
https://app.knowledgeowl.com/sp/id/<unique ID>
```
b. В текстовом поле 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-адрес входа введите 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-адрес для входа. Это описано ниже.
Приложение KnowledgeOwl ожидает проверочные утверждения SAML в определенном формате, который требует добавить настраиваемые сопоставления атрибутов в вашу конфигурацию атрибутов токена SAML. На следующем снимке экрана показан список атрибутов по умолчанию.
В дополнение к описанному выше приложение KnowledgeOwl ожидает несколько дополнительных атрибутов в ответе SAML, как показано ниже. Эти атрибуты также заранее заполнены, но вы можете изменить их в соответствии со своими требованиями.

Имя Исходный атрибут Пространство имен

ssoid user.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims
На странице Настройка единого входа с помощью SAML в разделе Сертификат подписи SAML найдите элемент Сертификат (необработанный) и щелкните Скачать, чтобы скачать сертификат и сохранить его на компьютере.
Скопируйте требуемые URL-адреса из раздела Настройка KnowledgeOwl.

Имя	Исходный атрибут	Пространство имен
ssoid	user.mail	`http://schemas.xmlsoap.org/ws/2005/05/identity/claims`

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

В этом разделе описано, как создать тестового пользователя B.Simon.

Войдите в Центр администрирования Microsoft Entra как минимум от имени администратора пользователей.
Перейдите к удостоверению>Пользователи>Все пользователи.
Выберите Создать пользователя>Создать пользователя в верхней части экрана.
В разделе Свойства пользователя выполните следующие действия.
1. В поле Отображаемое имя введите B.Simon.
2. В поле Имя участника-пользователя введите username@companydomain.extension. Например, B.Simon@contoso.com.
3. Установите флажок Показать пароль и запишите значение, которое отображается в поле Пароль.
4. Выберите Review + create (Просмотреть и создать).
Нажмите кнопку создания.

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

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

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

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

В другом окне веб-браузера войдите на корпоративный сайт KnowledgeOwl в качестве администратора.
Выберите Параметры и Единый вход.
На вкладке Параметры SAML выполните следующие действия.

а. Выберите Enable SAML SSO (Включить единый вход SAML).

b. Скопируйте SP Entity ID (Идентификатор сущности пакета обновления) и вставьте его в Identifier (Entity ID) (Идентификатор (сущности)) в разделе Базовая конфигурация SAML на портале Azure.

c. Скопируйте значение SP Login URL (URL-адрес входа с помощью пакета обновления) и вставьте его в текстовые поля "URL-адрес входа" и "URL-адрес ответа" в разделе Базовая конфигурация SAML на портале Azure.

d. В текстовое поле IdP entityID вставьте значение идентификатора Microsoft Entra, скопированное ранее.

д) В текстовое поле IdP Login URL (URL-адрес входа поставщика удостоверений ) вставьте скопированное ранее значение URL-адреса входа .

е) В текстовое поле IdP Logout URL (URL-адрес выхода поставщика удостоверений ) вставьте скопированное ранее значение URL-адрес выхода .

ж. Отправьте скачанный сертификат с портала Azure, выбрав Отправить под пунктом Сертификат поставщика удостоверений.

h. В нижней части страницы нажмите кнопку Сохранить .

i. Откройте вкладку Сопоставить атрибуты SAML, чтобы сопоставить атрибуты, и выполните следующие действия.
- Введите http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid в текстовом поле Идентификатор единого входа.
- Введите http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress в текстовом поле Username/Email (Имя пользователя/электронная почта).
- Введите http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname в текстовом поле First Name (Имя).
- Введите http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname в текстовом поле Last Name (Фамилия).
j. В нижней части страницы нажмите кнопку Сохранить .

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

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

Примечание

Чтобы создать пользователя вручную, обратитесь к группе поддержки KnowledgeOwl.

Проверка единого входа

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

Вход, инициированный поставщиком услуг

Щелкните Тестировать приложение. Вы будете перенаправлены по URL-адресу для входа в KnowledgeOwl, где можно инициировать поток входа.
Перейдите по URL-адресу для входа в KnowledgeOwl и инициируйте поток входа.

Вход, инициированный поставщиком удостоверений

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

Вы можете также использовать портал "Мои приложения" корпорации Майкрософт для тестирования приложения в любом режиме. Щелкнув плитку KnowledgeOwl на портале "Мои приложения", вы будете перенаправлены на страницу входа приложения для инициации потока входа (при настройке в режиме поставщика службы) или автоматически войдете в приложение KnowledgeOwl, для которого настроен единый вход (при настройке в режиме поставщика удостоверений). Дополнительные сведения о портале "Мои приложения" см. в статье Общие сведения о портале "Мои приложения".

Дальнейшие действия

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