本文介绍如何将 OneStream 与 Microsoft Entra ID 集成。 将 OneStream 与 Microsoft Entra ID 集成后，可以：
- 在 Microsoft Entra ID 中控制谁有权访问 OneStream。
- 让用户能够使用其 Microsoft Entra 帐户自动登录到 OneStream。
- 在中心位置管理帐户。
先决条件
本文中概述的方案假定你已具备以下先决条件：
- 已启用 OneStream 单一登录 (SSO) 的订阅。
方案描述
本文中，您将在测试环境中配置并测试 Microsoft Entra SSO。
- OneStream 仅支持 SP 发起的 SSO。
从库中添加 OneStream
若要配置 OneStream 与 Microsoft Entra ID 的集成，需要从库中将 OneStream 添加到托管 SaaS 应用程序列表。
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 请导航到 Entra ID>企业应用>新应用。
- 在“从库中添加”部分的搜索框中，键入“OneStream”。
- 从结果面板中选择“OneStream”，然后添加该应用。 在该应用添加到租户时等待几秒钟。
或者，也可以使用企业应用配置向导。 在此向导中，可以将应用程序添加到租户，将用户/组添加到应用，分配角色，并逐步完成 SSO 配置。 详细了解 Microsoft 365 向导。
配置并测试 OneStream 的 Microsoft Entra SSO
使用名为 B.Simon 的测试用户配置并测试 OneStream 的 Microsoft Entra SSO。 若要使 SSO 正常工作，需要在 Microsoft Entra 用户与 OneStream 中的相关用户之间建立关联。
若要配置并测试 OneStream 的 Microsoft Entra SSO，请执行以下步骤：
-
配置 Microsoft Entra SSO - 使用户能够使用此功能。
- 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
- 创建 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
-
配置 OneStream SSO - 在应用程序端配置单一登录设置。
- 创建 OneStream 测试用户 - 在 OneStream 中拥有一个与 B.Simon 对应的用户，该用户链接到 Microsoft Entra ID 的用户表示形式。
- 测试 SSO - 验证配置是否正常工作。
配置 Microsoft Entra SSO
按照以下步骤在 Microsoft Entra 管理中心启用 Microsoft Entra SSO。
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>企业应用>OneStream>单点登录。
在“选择单一登录方法”页上选择“SAML” 。
在 “使用 SAML 设置单一登录 ”页上，选择 基本 SAML 配置的 铅笔图标以编辑设置。
在“基本 SAML 配置” 部分中，按照以下步骤操作：
a。 在“标识符(实体 ID)”文本框中，使用以下模式键入 URL：
b. 在“回复 URL”文本框中，使用以下模式键入 URL：
选项c. 在“登录 URL”文本框中，使用以下模式键入 URL：
注意
这些值不是真实的。 使用实际标识符、回复 URL 和登录 URL 更新这些值。 在 OneStream 标识和访问管理门户中 创建新的 SAML 提供程序，以获取这些值，稍后在 “配置 OneStream SSO ”部分中对此进行了介绍。 还可参考 Microsoft Entra 管理中心的“基本 SAML 配置”部分中显示的模式。
OneStream 应用程序需要特定格式的 SAML 断言，这要求向 SAML 令牌属性配置添加自定义属性映射。 以下屏幕截图显示了默认属性的列表。
除上述属性外，OneStream 应用程序还要求在 SAML 响应中传回其他几个属性（如下所示）。 这些属性也是预先填充的，但可以根据要求查看它们。
名称 源属性 名 用户的名字 姓 用户姓氏 电子邮件 用户邮箱 在“ 设置 SAML 单一登录 ”页上的“ SAML 签名证书 ”部分中，选择“复制”按钮以复制 应用联合元数据 URL 并将其保存在计算机上。
创建和分配 Microsoft Entra 测试用户
请遵循创建和分配用户帐户快速指南中的指引，创建一个名为 B.Simon 的测试用户帐户。
配置 OneStream SSO
以管理员身份登录到 OneStream 公司网站。
转到“Identity and Access Management”，然后选择“Manage Identity Providers”磁贴。
在 “管理标识提供者 ”页上，选择“ +添加 SAML 提供程序”。
在以下页面中执行以下步骤：
在“Name”文本框中输入标识提供者的唯一名称。
选择“Metadata URL”作为 SAML 配置模式。
在“Metadata URL”文本框中，粘贴从 Microsoft Entra 管理中心复制的应用联合元数据 URL。
选择“ 保存 ”按钮。
注意
有关更多详细信息，请参阅 OneStream 文档网站中“System Guides”“Identity and Access Management”下的内容>。
创建 OneStream 测试用户
在另一个 Web 浏览器窗口中，以管理员身份登录到 OneStream 公司网站。
转到 “系统>安全性> ”选择 “创建用户 ”并执行以下步骤：
在“Name”字段中输入有效的用户名。
根据要求输入用户类型。
从下拉列表中选择“External Authentication Provider”。
在“External Provider User Name”字段中输入 Microsoft Entra ID 的用户主体名称。
注意
有关详细信息，请参阅 OneStream 文档网站，并导航到“Design and Reference”“About Managing Users and Groups”>“Creating and Managing Users”>。
测试 SSO
在本部分，你将使用以下选项测试 Microsoft Entra 单一登录配置。
在 Microsoft Entra 管理中心选择 测试此应用程序 。 此选项重定向到 OneStream 登录 URL，可在其中启动登录流。
直接转到 OneStream 登录 URL，从那里启动登录流。
相关内容
配置 OneStream 后，即可强制实施会话控制，实时防止组织的敏感数据发生外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。