使用 Microsoft Entra ID 配置 KnowledgeOwl 进行单一登录

本文介绍如何将 KnowledgeOwl 与 Microsoft Entra ID 集成。 将 KnowledgeOwl 与 Microsoft Entra ID 集成后，可以：

• 在 Microsoft Entra ID 中控制谁有权访问 KnowledgeOwl。
• 让用户使用其 Microsoft Entra 帐户自动登录到 KnowledgeOwl。
• 在一个中心位置管理帐户。

先决条件

本文中概述的方案假定你已具备以下先决条件：

• 具有活动订阅的 Microsoft Entra 用户帐户。 如果还没有帐户，可以 免费创建帐户。
• 以下角色之一：
  • 应用程序管理员
  • 云应用程序管理员
  • 应用程序所有者。

• 启用了 KnowledgeOwl 单一登录 (SSO) 的订阅。

方案说明

本文中，您将在测试环境中配置并测试 Microsoft Entra SSO。

• KnowledgeOwl 支持 SP 和 IDP 发起的 SSO。
• KnowledgeOwl 支持实时用户预配。

从库中添加 KnowledgeOwl

要配置 KnowledgeOwl 与 Microsoft Entra ID 的集成，需要从库中将 KnowledgeOwl 添加到托管 SaaS 应用列表。

1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。
2. 浏览到 Entra ID>企业应用>新应用。
3. 在“从库中添加”部分的搜索框中，键入“KnowledgeOwl” 。
4. 从结果面板中选择“KnowledgeOwl”，然后添加该应用 。 请稍等几秒钟，应用程序将被添加到您的租户中。

或者，也可以使用 企业应用配置向导。 在此向导中，还可以将应用程序添加到租户、将用户/组添加到应用、分配角色以及演练 SSO 配置。 详细了解Microsoft 365 向导。

配置并测试 KnowledgeOwl 的 Microsoft Entra SSO

使用名为 B.Simon 的测试用户配置并测试 KnowledgeOwl 的 Microsoft Entra SSO。 若要使 SSO 正常工作，需要在 Microsoft Entra 用户与 KnowledgeOwl 中的相关用户之间建立关联。

若要配置并测试 KnowledgeOwl 的 Microsoft Entra SSO，请执行以下步骤：

1. 配置 Microsoft Entra SSO - 使用户能够使用此功能。
   1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
   2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
2. 配置 KnowledgeOwl SSO - 在应用程序端配置单一登录设置。
   1. 创建 KnowledgeOwl 测试用户 - 为 B.Simon 在 KnowledgeOwl 中创建一个对应用户，并将该用户链接到 Microsoft Entra 中的用户表示形式。
3. 测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

按照以下步骤启用 Microsoft Entra SSO。

1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。

2. 访问 Entra ID>Enterprise 应用>KnowledgeOwl>单点登录。

3. 在“选择单一登录方法”页上选择“SAML” 。

4. 在 “使用 SAML 设置单一登录 ”页上，选择 基本 SAML 配置的 铅笔图标以编辑设置。

   

5. 在 “基本 SAML 配置 ”部分中，如果要在 IDP 发起的模式下配置应用程序，请输入以下字段的值：

   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
   

6. 若要在 SP 启动模式下配置应用程序，请选择“设置其他 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 和 Sign-On URL 中更新这些值，后文中会对此进行详细说明。

7. KnowledgeOwl 应用程序需要特定格式的 SAML 断言，这要求向 SAML 令牌属性配置添加自定义属性映射。 以下屏幕截图显示了默认属性的列表。

   

8. 除了上述属性，KnowledgeOwl 应用程序还要求在 SAML 响应中传递回更多的属性，如下所示。 这些属性也是预先填充的，但可以根据要求查看它们。

   名称	源属性	Namespace
   ssoid	用户邮箱	http://schemas.xmlsoap.org/ws/2005/05/identity/claims

9. 在 “使用 SAML 设置单一登录 ”页上的 “SAML 签名证书 ”部分中，找到 “证书”（原始）， 然后选择“ 下载 ”以下载证书并将其保存在计算机上。

   

10. 在“设置 KnowledgeOwl”部分，根据要求复制相应 URL 。

    

创建和分配 Microsoft Entra 测试用户

请按照创建和分配用户帐户快速入门中的指引，创建一个名为 B.Simon 的测试用户帐户。

配置 KnowledgeOwl SSO

1. 在另一个 Web 浏览器窗口中，以管理员身份登录到 KnowledgeOwl 公司站点。

2. 选择 “设置” ，然后选择 “SSO”。

   

3. 滚动到“SAML 设置”选项卡，执行以下步骤：

   

   a。 选择“启用 SAML SSO” 。

   b. 复制“SP 实体 ID”值，并将其粘贴到 Azure 门户上“基本 SAML 配置”部分的“标识符(实体 ID)”中 。

   选项c. 复制“SP 登录 URL”值并将其粘贴到 Azure 门户上“基本 SAML 配置”部分的“登录 URL 和答复 URL”文本框中 。

   d。 在“IDP 实体 ID”文本框中，粘贴之前复制的“Microsoft Entra 标识符”值。

   e。 在 IdP 登录 URL 文本框中，粘贴之前复制的 登录 URL 值。

   f。 在 IdP 注销 URL 文本框中，粘贴之前复制的 注销 URL 值。

   g。 通过选择 IdP 证书下的“上传”链接，将下载的证书上传到 Azure 门户。

   h. 选择页面底部的“保存” 。

   

   一. 打开“SAML 属性映射”选项卡以映射属性并执行以下操作：

   

   • 在“SSO ID”文本框中输入 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid。
   • 在“用户名/电子邮件”文本框中输入 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress 。
   • 在“名字”文本框中输入 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname 。
   • 在“姓氏”文本框中输入 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname 。

   j. 选择页面底部的“保存” 。

   

创建 KnowledgeOwl 测试用户

在本部分，我们将在 KnowledgeOwl 中创建一个名为 B.Simon 的用户。 KnowledgeOwl 支持默认启用的实时用户预配。 本节中没有需要你完成的事项。 如果 KnowledgeOwl 中尚不存在用户，身份验证后会创建一个新用户。

测试 SSO

在本部分，你将使用以下选项测试 Microsoft Entra 单一登录配置。

SP 启动的

• 选择“ 测试此应用程序”，此选项将重定向到 KnowledgeOwl 登录 URL，可在其中启动登录流。

• 直接转到 KnowledgeOwl 登录 URL，并从那里启动登录流。

IDP 启动的

• 选择“ 测试此应用程序”，在 Azure 门户中，应会自动登录到为其设置了 SSO 的 KnowledgeOwl 应用程序。

还可以使用 Microsoft“我的应用”门户在任何模式下测试此应用程序。 在“我的应用”门户中选择 KnowledgeOwl 磁贴时，如果是在 SP 模式下配置的，则会重定向到应用程序登录页来启动登录流;如果是在 IDP 模式下配置的，则应会自动登录到为其设置了 SSO 的 KnowledgeOwl 应用程序。 有关“我的应用”门户的详细信息，请参阅 “我的应用简介”。

相关内容

配置 KnowledgeOwl 后，即可强制实施会话控制，实时防止组织的敏感数据发生外泄和渗透。 会话控制是条件访问的延伸。 了解如何使用 Microsoft Defender for Cloud Apps 强制实施会话控制。