Руководство по интеграции единого входа Azure Active Directory с KnowledgeOwl

В этом руководстве описано, как интегрировать KnowledgeOwl с Azure Active Directory (Azure AD). Интеграция KnowledgeOwl с Azure AD обеспечивает следующие возможности.

  • C помощью Azure AD вы можете контролировать доступ к KnowledgeOwl.
  • Вы можете включить автоматический вход пользователей в KnowledgeOwl с помощью учетных записей Azure AD.
  • Централизованное управление учетными записями через портал Azure.

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

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

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

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

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

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

  1. Войдите на портал Azure с помощью личной учетной записи Майкрософт либо рабочей или учебной учетной записи.
  2. В области навигации слева выберите службу Azure Active Directory.
  3. Перейдите в колонку Корпоративные приложения и выберите Все приложения.
  4. Чтобы добавить новое приложение, выберите Новое приложение.
  5. В разделе Добавление из коллекции в поле поиска введите KnowledgeOwl.
  6. Выберите KnowledgeOwl в области результатов и добавьте это приложение. Подождите несколько секунд, пока приложение не будет добавлено в ваш клиент.

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

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

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

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

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

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

  1. На портале Azure на странице интеграции с приложением KnowledgeOwl найдите раздел Управление и выберите Единый вход.

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

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

    Edit Basic SAML Configuration

  4. Если вы хотите настроить приложение в режиме, инициируемом поставщиком удостоверений, в разделе Базовая конфигурация 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
    
  5. Чтобы настроить приложение для работы в режиме, инициируемом поставщиком услуг, щелкните Задать дополнительные 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-адрес для входа. Это описано ниже.

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

    image

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

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

    The Certificate download link

  9. Скопируйте требуемые URL-адреса из раздела Настройка KnowledgeOwl.

    Copy configuration URLs

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

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

  1. На портале Azure в области слева выберите Azure Active Directory, Пользователи, а затем — Все пользователи.
  2. В верхней части экрана выберите Новый пользователь.
  3. В разделе Свойства пользователя выполните следующие действия.
    1. В поле Имя введите .
    2. В поле Имя пользователя введите . Например, B.Simon@contoso.com.
    3. Установите флажок Показать пароль и запишите значение, которое отображается в поле Пароль.
    4. Нажмите кнопку Создать.

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

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

  1. На портале Azure выберите Корпоративные приложения, а затем — Все приложения.
  2. В списке приложений выберите KnowledgeOwl.
  3. На странице "Обзор" приложения найдите раздел Управление и выберите Пользователи и группы.
  4. Выберите Добавить пользователя, а в диалоговом окне Добавление назначения выберите Пользователи и группы.
  5. В диалоговом окне Пользователи и группы выберите B.Simon в списке пользователей, а затем в нижней части экрана нажмите кнопку Выбрать.
  6. Если пользователям необходимо назначить роль, вы можете выбрать ее из раскрывающегося списка Выберите роль. Если для этого приложения не настроена ни одна роль, будет выбрана роль "Доступ по умолчанию".
  7. В диалоговом окне Добавление назначения нажмите кнопку Назначить.

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

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

  2. Выберите Параметры и Единый вход.

    Screenshot shows SSO selected from the Settings menu.

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

    Screenshot shows SAML S S O Integration where you can make the changes described here.

    а. Выберите 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 (Идентификатор сущности для поставщика удостоверений) вставьте значение Идентификатор Azure AD, скопированное на портале Azure.

    д) В текстовое поле IdP Login URL (URL-адрес для входа с помощью IdP) вставьте значение URL-адрес входа, скопированное на портале Azure.

    е) В текстовое поле IdP Logout URL (URL-адрес для выхода с помощью поставщика удостоверений) вставьте URL-адрес выхода, скопированный на портале Azure.

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

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

    Screenshot shows the Save button.

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

    Screenshot shows Map SAML Attributes where you can make the changes described here.

    • Введите 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. В нижней части страницы нажмите кнопку Сохранить .

    Screenshot shows the Save button1.

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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