教程:Microsoft Entra 单一登录 (SSO) 与 Coralogix 的集成
本教程介绍如何将 Coralogix 与 Microsoft Entra ID 相集成。 将 Coralogix 与 Microsoft Entra ID 集成后,可以:
- 在 Microsoft Entra ID 中控制谁有权访问 Coralogix。
- 使用户能够使用其 Microsoft Entra 帐户自动登录到 Coralogix。
- 在中心位置管理帐户。
若要了解有关 SaaS 应用与 Microsoft Entra ID 集成的详细信息,请参阅 Microsoft Entra ID 的应用程序访问与单一登录是什么。
先决条件
若要开始操作,需备齐以下项目:
- 一个 Microsoft Entra 订阅。 如果没有订阅,可以获取一个免费帐户。
- 已启用 Coralogix 单一登录 (SSO) 的订阅。
方案描述
在本教程中,将在测试环境中配置并测试 Microsoft Entra SSO。
- Coralogix 支持 SP 发起的 SSO
注意
此应用程序的标识符是一个固定字符串值,因此只能在一个租户中配置一个实例。
从库中添加 Coralogix
若要配置 Coralogix 与 Microsoft Entra ID 的集成,需要从库中将 Coralogix 添加到托管 SaaS 应用列表。
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
- 在“从库中添加”部分的搜索框中,键入 Coralogix 。
- 在结果面板中选择 Coralogix,然后添加该应用 。 在该应用添加到租户时等待几秒钟。
或者,也可以使用企业应用配置向导。 在此向导中,可以将应用程序添加到租户、将用户/组添加到应用、分配角色,以及逐步完成 SSO 配置。 详细了解 Microsoft 365 向导。
配置并测试 Coralogix 的 Microsoft Entra 单一登录
使用名为 B.Simon 的测试用户配置并测试 Coralogix 的 Microsoft Entra SSO。 若要正常完成 SSO,需要在 Microsoft Entra 用户与 Coralogix 中的相关用户之间建立链接关系。
若要配置并测试 Coralogix 的 Microsoft Entra SSO,请完成以下构建基块:
- 配置 Microsoft Entra SSO - 使用户能够使用此功能。
- 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
- 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
- 配置 Coralogix SSO - 在应用程序端配置单一登录设置。
- 创建 Coralogix 测试用户 - 在 Coralogix 中创建 B.Simon 的对应用户,并将其链接到该用户的 Microsoft Entra 表示形式。
- 测试 SSO - 验证配置是否正常工作。
配置 Microsoft Entra SSO
按照以下步骤启用 Microsoft Entra SSO。
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”>“Coralogix”>“单一登录”。
在“选择单一登录方法”页上选择“SAML” 。
在“使用 SAML 设置单一登录”页上,单击“基本 SAML 配置”的编辑/笔形图标以编辑设置 。
在“基本 SAML 配置”部分,输入以下字段的值:
a. 在“登录 URL”框中,使用以下模式输入 URL:
https://<SUBDOMAIN>.coralogix.com
。b. 在“标识符(实体 ID)”文本框中输入 URL,例如:
https://api.coralogix.com/saml/metadata.xml
或
https://aws-client-prod.coralogix.com/saml/metadata.xml
注意
登录 URL 值不是实际值。 请使用实际登录 URL 更新该值。 请联系 Coralogix 客户端支持团队获取该值。 还可参考“基本 SAML 配置”部分中的模式。
Coralogix 应用程序需要特定格式的 SAML 断言。 请为此应用程序配置以下声明。 可以在应用程序集成页的“用户属性”部分管理这些属性的值。 在“使用 SAML 设置单一登录”页上,选择“编辑”按钮打开“用户属性”对话框。
在“用户声明”部分的“用户属性”对话框中,使用“编辑”图标编辑声明。 还可以使用“添加新声明”来添加声明,以配置 SAML 令牌属性,如上图所示。 然后执行以下步骤:
a. 选择“编辑”图标打开“管理用户声明”对话框。
b. 从“选择名称标识符格式”列表中,选择“电子邮件地址”。
c. 在“源属性”列表中,选择 user.mail。
d. 选择“保存”。
在“使用 SAML 设置单一登录”页的“SAML 签名证书”部分中找到“联合元数据 XML”,选择“下载”以下载该证书并将其保存在计算机上 。
在“设置 Coralogix”部分,根据要求复制相应的 URL。
创建 Microsoft Entra 测试用户
在本部分,你将创建名为 B.Simon 的测试用户。
- 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
- 浏览到“标识”>“用户”>“所有用户”。
- 选择屏幕顶部的“新建用户”>“创建新用户”。
- 在“用户”属性中执行以下步骤:
- 在“显示名称”字段中输入
B.Simon
。 - 在“用户主体名称”字段中,输入 username@companydomain.extension。 例如
B.Simon@contoso.com
。 - 选中“显示密码”复选框,然后记下“密码”框中显示的值。
- 选择“查看 + 创建”。
- 在“显示名称”字段中输入
- 选择“创建”。
分配 Microsoft Entra 测试用户
在本部分中,你将通过授予 B.Simon 访问 Coralogix 的权限,允许其使用单一登录。
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”>“Coralogix”。
在应用的概述页中,找到“管理”部分,选择“用户和组” 。
选择“添加用户”,然后在“添加分配”对话框中选择“用户和组”。
在“用户和组”对话框中,从“用户”列表中选择“B.Simon”,然后单击屏幕底部的“选择”按钮。
如果在 SAML 断言中需要任何角色值,请在“选择角色”对话框的列表中为用户选择合适的角色,然后单击屏幕底部的“选择”按钮。
在“添加分配”对话框中,单击“分配”按钮。
配置 Coralogix SSO
若要在 Coralogix 端配置单一登录,需要将下载的“联合元数据 XML”以及从应用程序配置复制的相应 URL 发送给 Coralogix 支持团队。 他们会对此进行设置,使两端的 SAML SSO 连接均正确设置。
创建 Coralogix 测试用户
在本部分,将在 Coralogix 中创建一个名为“Britta Simon”的用户。 与 Coralogix 支持团队协作,在 Coralogix 平台中添加用户。 使用单一登录前,必须先创建并激活用户。
测试 SSO
本部分需使用访问面板测试 Microsoft Entra 单一登录配置。
单击访问面板中的 Coralogix 磁贴时,应会自动登录到为其设置了 SSO 的 Coralogix。 有关访问面板的详细信息,请参阅 Introduction to the Access Panel(访问面板简介)。