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

Статья
03/25/2024

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

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

Необходимые компоненты

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

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

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

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

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

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

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

Войдите в Центр администрирования Microsoft Entra как минимум облачные приложения Администратор istrator.
Перейдите к приложениям>Identity>Applications>Enterprise. Новое приложение.
В разделе Добавление из коллекции в поле поиска введите 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 как минимум облачные приложения Администратор istrator.
Перейдите к приложениям>Identity>Applications>Enterprise KnowledgeOwl>с единым входом.
На странице Выбрать метод единого входа выберите SAML.
На странице Настройка единого входа с помощью SAML щелкните значок карандаша, чтобы открыть диалоговое окно Базовая конфигурация SAML для изменения параметров.
Если вы хотите настроить приложение в режиме, инициируемом поставщиком удостоверений, в разделе Базовая конфигурация SAML введите значения следующих полей.

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

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

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

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

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

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

a. Выберите 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, скопированное ранее.

д) В текстовое поле URL-адреса входа idP вставьте значение 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 для облака.

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