教程：Microsoft Entra SSO 与 HubSpot 的集成

  • 项目

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

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

先决条件

若要配置 Microsoft Entra 与 HubSpot 的集成，需要以下项：

  • 一个 Microsoft Entra 订阅。 如果没有 Microsoft Entra 订阅，请在开始之前创建一个免费帐户。
  • 已启用单一登录的 HubSpot 订阅。

方案描述

本教程在测试环境中配置和测试 Microsoft Entra 单一登录，并将 HubSpot 与 Microsoft Entra ID 集成。

HubSpot 支持以下功能：

  • SP 发起的单一登录。
  • IDP 发起的单一登录。

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

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

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

配置并测试 HubSpot 的 Microsoft Entra SSO

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

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

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

配置 Microsoft Entra SSO

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

  2. 浏览到“标识”>“应用程序”>“企业应用程序”>“HubSpot”应用程序集成页，找到“管理”部分，然后选择“单一登录”。

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

  4. 在“设置 SAML 单一登录”页面上，单击“基本 SAML 配置”旁边的铅笔图标以编辑设置 。

    Edit Basic SAML Configuration

  5. 在“基本 SAML 配置”窗格中，若要配置“IDP 发起模式”，请执行以下步骤：

    1. 在“标识符”框中，输入采用以下模式的 URL：https://api.hubspot.com/login-api/v1/saml/login?portalId=<CUSTOMER ID>。

    2. 在“回复 URL”框中，输入采用以下模式的 URL：https://api.hubspot.com/login-api/v1/saml/acs?portalId=<CUSTOMER ID>。

    注意

    若要设置 URL 的格式，还可参考“基本 SAML 配置”窗格中显示的模式。。

  6. 若要在 SP 发起模式下配置应用程序，请执行以下操作：

    1. 选择“设置其他 URL” 。

    2. 在“登录 URL”框中，输入 https://app.hubspot.com/login。

  7. 在“设置 SAML 单一登录”窗格的“SAML 签名证书”部分中，选择“证书 (Base64)”旁边的“下载” 。 根据需要选择下载选项。 将证书保存在计算机上。

    The Certificate (Base64) download option

  8. 在“设置 HubSpot”部分，根据要求复制以下 URL ：

    Copy configuration URLs

创建 Microsoft Entra 测试用户

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

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

分配 Microsoft Entra 测试用户

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

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

配置 HubSpot SSO

  1. 在浏览器中打开新选项卡并登录到 HubSpot 管理员帐户。

  2. 选择页面右上角的设置图标。

    The Settings icon in HubSpot

  3. 选择“帐户默认值” 。

    The Account Defaults option in HubSpot

  4. 向下滚动到“安全”部分，然后选择“设置” 。

    The Set up option in HubSpot

  5. 在“设置单一登录”部分中，执行以下步骤：

    1. 在“受众 URl (服务提供程序实体 ID)”框中，选择“复制”以复制值 。 在 Azure 门户的“基本 SAML 配置”窗格中，将值粘贴到“标识符”框中 。

    2. 在“登录 URL、ACS、收件人或重定向”框中，选择“复制”以复制值 。 在 Azure 门户的“基本 SAML 配置”窗格中，将值粘贴到“回复 URL”框中 。

    3. 在 HubSpot 的“标识提供者或证书颁发者 URL”框中，粘贴复制的“Microsoft Entra 标识符”值。

    4. 在 HubSpot 的“标识提供者单一登录 URL”框中，粘贴复制的“登录 URL”值。

    5. 在 Windows 记事本中，打开下载的“证书(Base64)”文件。 选择并复制文件的内容。 然后在 HubSpot 中将其粘贴到“X.509 证书”框中 。

    6. 选择“验证” 。

      The Set up single sign-on section in HubSpot

创建 HubSpot 测试用户

若要使 Microsoft Entra ID 用户能够登录到 HubSpot，必须在 HubSpot 中预配该用户。 在 HubSpot 中，预配是一项手动任务。

若要在 HubSpot 中预配用户帐户，请执行以下操作：

  1. 以管理员身份登录 HubSpot 公司站点。

  2. 选择页面右上角的设置图标。

    The Settings icon in HubSpot

  3. 选择“用户和团队”。

    The Users & Teams option in HubSpot

  4. 选择“创建用户”。

    The Create user option in HubSpot

  5. 在“添加电子邮件地址”框中，按 brittasimon@contoso.com 的格式输入用户的电子邮件地址，然后选择“下一步”。

    The Add email address(es) box in the Create users section in HubSpot

  6. 在“创建用户”部分中，选择每个选项卡 。在每个选项卡上，为用户设置相关选项和权限。 然后，选择“下一步”。

    Tabs in the Create users section in HubSpot

  7. 若要向用户发送邀请，请选择“发送” 。

    The Send option in HubSpot

    注意

    用户接受邀请后，将激活用户。

测试 SSO

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

SP 启动的：

  • 单击“测试此应用程序”，这会重定向到 HubSpot 登录 URL，可以从那里启动登录流。

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

IDP 启动的：

  • 单击“测试此应用程序”后，你应当会自动登录到为其设置了 SSO 的 HubSpot。

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

后续步骤

配置 HubSpot 后，可以强制实施会话控制，以实时防止组织的敏感数据发生外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。