使用 Microsoft Entra ID 为 Braze 配置单一登录

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

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

先决条件

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

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

• 已启用 Braze 单一登录 (SSO) 的订阅。

方案说明

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

• Braze 支持 SP 和 IDP 发起的 SSO。

注释

此应用程序的标识符是固定字符串值，因此只能在一个租户中配置一个实例。

从库中添加 Braze

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

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

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

配置并测试 Braze 的 Microsoft Entra SSO

使用名为 B.Simon 的测试用户配置和测试 Microsoft Braze 的 Entra SSO。 要正常使用 SSO，需要在 Microsoft Entra 用户与 Braze 中的相关用户之间建立链接关系。

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

1. 配置 Microsoft Entra SSO - 使用户能够使用此功能。
   1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
   2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
2. 配置 Braze SSO - 在应用程序端配置单一登录设置。
   1. 创建 Braze 测试用户 - 在 Braze 中创建 B.Simon 的对应用户，并将其关联到该用户在 Microsoft Entra 中对应的身份。
3. 测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

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

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

2. 浏览到 Entra ID>企业应用>Braze>单一登录。

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

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

   

5. 在 “基本 SAML 配置 ”部分中，如果要在 IDP 发起的模式下配置应用程序，请执行以下步骤：

   在“回复 URL”文本框中，使用以下模式键入 URL：

6. 若要在由 SP 发起的模式下配置应用程序，请选择“设置其他 URL”，并执行以下步骤：

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

   注释

   对于子域，使用 Braze 实例 URL 中列出的协调子域。 例如，如果实例为 US-01，则 URL 为 https://dashboard-01.braze.com 。 这意味着子域是 dashboard-01。

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

   

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

   名称	源属性
   电子邮件	user.userprincipalname
   first_name	user.givenname
   last_name	用户姓氏

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

   

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

    

创建和分配 Microsoft Entra 测试用户

遵循创建和分配用户帐户快速入门中的指导，以创建名为 B.Simon 的测试用户帐户。

配置 Braze SSO

若要在 Braze 端配置单一登录，需要确保 Braze 帐户管理器为帐户启用了 SAML SSO。 启用后，可转到“公司设置”>“安全设置”，并将 SAML SSO 部分切换为“开”。 在本部分中，需要复制并粘贴下载的 证书（Base64），并添加 SAML 名称。

创建 Braze 测试用户

在本部分，你将在 Braze 中创建名为 B.Simon 的用户。 请与 Braze 支持团队 协作，将用户添加到 Braze 平台中。 在使用单一登录之前，必须先创建和激活用户。

测试 SSO

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

SP 发起：

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

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

IDP 发起：

• 选择“ 测试此应用程序”，应会自动登录到为其设置了 SSO 的 Braze。

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

相关内容

配置 Braze 后，可以强制实施会话控制，实时防止组织的敏感数据外泄和渗透。 会话控制是条件访问的延伸。 了解如何使用 Microsoft Cloud App Security 强制实施会话控制。