教程：Microsoft Entra 与 HappyFox 的集成

本教程介绍如何将 HappyFox 与 Microsoft Entra ID 相集成。将 HappyFox 与 Microsoft Entra ID 集成后，可以：

先决条件

若要开始操作，需备齐以下项目：

在本教程中，你将在测试环境中配置并测试 Microsoft Entra 单一登录。

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

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

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

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

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

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

至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览至“标识”>“应用程序”>“企业应用程序”>“HappyFox”>“单一登录”。
在“选择单一登录方法”页上选择“SAML” 。
在“设置 SAML 单一登录”页面上，单击“基本 SAML 配置”旁边的铅笔图标以编辑设置。
在“基本 SAML 配置” 部分中，按照以下步骤操作：

a. 在“登录 URL”文本框中，使用以下模式键入 URL：https://<SUBDOMAIN>.happyfox.com/

b. 在“标识符(实体 ID)”文本框中，使用以下模式键入 URL：https://<SUBDOMAIN>.happyfox.com/saml/metadata/

注意

这些不是实际值。使用实际登录 URL 和标识符更新这些值。请联系 HappyFox 客户端支持团队来获取这些值。还可参考“基本 SAML 配置”部分中显示的模式。
在“使用 SAML 设置单一登录” 页上，在“SAML 签名证书” 部分中，单击“下载” 以根据要求从给定的选项下载证书(Base64) 并将其保存在计算机上。
在“设置 HappyFox”部分中，根据要求复制相应 URL 。

在本部分，你将创建名为 B.Simon 的测试用户。

至少以用户管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“用户”>“所有用户”。
选择屏幕顶部的“新建用户”>“创建新用户”。
在“用户”属性中执行以下步骤：
1. 在“显示名称”字段中输入 B.Simon。
2. 在“用户主体名称”字段中，输入 username@companydomain.extension。例如 B.Simon@contoso.com。
3. 选中“显示密码”复选框，然后记下“密码”框中显示的值。
4. 选择“查看 + 创建”。
选择“创建”。

在本部分，你将通过授予 B.Simon 访问 HappyFox 的权限，使其能够使用单一登录。

至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”>“HappyFox”。
在应用的概述页面中，选择“用户和组”。
选择“添加用户/组”，然后在“添加分配”对话框中选择“用户和组” 。
1. 在“用户和组”对话框中，从“用户”列表中选择“B.Simon”，然后单击屏幕底部的“选择”按钮。
2. 如果你希望将某角色分配给用户，可以从“选择角色”下拉列表中选择该角色。如果尚未为此应用设置任何角色，你将看到选择了“默认访问权限”角色。
3. 在“添加分配”对话框中，单击“分配”按钮。