本文介绍如何将 HubSpot 与 Microsoft Entra ID 集成。 将 HubSpot 与 Microsoft Entra ID 集成后,可以:
- 在 Microsoft Entra ID 中控制谁有权访问 HubSpot。
- 让用户能够使用其 Microsoft Entra 帐户自动登录到 HubSpot。
- 在一个中心位置管理帐户。
先决条件
本文中概述的方案假定你已具备以下先决条件:
- 已启用单一登录的 HubSpot 订阅。
方案说明
在本文中,您将配置和测试 Microsoft Entra 单点登录,并在测试环境中将 HubSpot 与 Microsoft Entra ID 集成。
HubSpot 支持以下功能:
- SP 发起的单一登录。
- IDP 发起的单一登录。
从库中添加 HubSpot
若要配置 HubSpot 与 Microsoft Entra ID 的集成,需要从库中将 HubSpot 添加到托管 SaaS 应用列表。
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 请导航到 Entra ID>企业应用>新应用。
- 在“从库中添加”部分的搜索框中,键入“HubSpot” 。
- 从结果面板中选择“HubSpot”,然后添加该应用。 请稍等几秒钟,应用程序将被添加到您的租户中。
或者,也可以使用企业应用配置向导。 在此向导中,还可以将应用程序添加到租户、将用户/组添加到应用、分配角色以及演练 SSO 配置。 详细了解 Microsoft 365 向导。
配置并测试 HubSpot 的 Microsoft Entra SSO
使用名为 B.Simon 的测试用户配置并测试 HubSpot 的 Microsoft Entra SSO。 若要使 SSO 正常工作,需要在 Microsoft Entra 用户与 HubSpot 中的相关用户之间建立关联。
若要配置并测试 HubSpot 的 Microsoft Entra SSO,请执行以下步骤:
-
配置 Microsoft Entra SSO - 使用户能够使用此功能。
- 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
- 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
-
配置 HubSpot SSO - 在应用程序端配置单一登录设置。
- 创建 HubSpot 测试用户 - 在 HubSpot 中创建 B.Simon 的对应账户,该账户与此用户的 Microsoft Entra 表示形式相链接。
- 测试 SSO - 验证配置是否正常工作。
配置 Microsoft Entra SSO
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到 Entra ID>Enterprise Apps>HubSpot 应用程序集成页,找到 “管理 ”部分并选择 “单一登录”。
在“选择单一登录方法”页上选择“SAML” 。
在 “配置 SAML 单点登录”页上,选择 “基本 SAML 配置”中的铅笔图标以编辑设置。
在“基本 SAML 配置”窗格中,若要配置“IDP 发起模式”,请执行以下步骤:
在“标识符”框中,输入采用以下模式的 URL:CUSTOMER IDhttps://api.hubspot.com/login-api/v1/saml/login?portalId=<。
在“回复 URL”框中,输入采用以下模式的 URL:CUSTOMER IDhttps://api.hubspot.com/login-api/v1/saml/acs?portalId=<。
注释
若要设置 URL 的格式,还可参考“基本 SAML 配置”窗格中显示的模式。。
若要在 SP 发起模式下配置应用程序,请执行以下操作:
选择“设置其他 URL” 。
在“登录 URL”框中,输入 。
在“设置 SAML 单一登录”窗格的“SAML 签名证书”部分中,选择“证书 (Base64)”旁边的“下载” 。 根据需要选择下载选项。 将证书保存在计算机上。
在“设置 HubSpot”部分,根据要求复制以下 URL :
创建和分配 Microsoft Entra 测试用户
请遵循创建和分配用户帐户快速指南中的指引,创建一个名为 B.Simon 的测试用户帐户。
配置 HubSpot SSO
在浏览器中打开新选项卡并登录到 HubSpot 管理员帐户。
选择页面右上角的 “设置” 图标。
选择“帐户默认值” 。
向下滚动到“安全”部分,然后选择“设置” 。
在“设置单一登录”部分中,执行以下步骤:
在“受众 URl (服务提供程序实体 ID)”框中,选择“复制”以复制值 。 在 Azure 门户的“基本 SAML 配置”窗格中,将值粘贴到“标识符”框中 。
在“登录 URL、ACS、收件人或重定向”框中,选择“复制”以复制值 。 在 Azure 门户的“基本 SAML 配置”窗格中,将值粘贴到“回复 URL”框中 。
在 HubSpot 的“标识提供者或证书颁发者 URL”框中,粘贴复制的“Microsoft Entra 标识符”值。
在 HubSpot 的“标识提供者单一登录 URL”框中,粘贴复制的“登录 URL”值。
在 Windows 记事本中,打开下载的“证书(Base64)”文件。 选择并复制文件的内容。 然后在 HubSpot 中将其粘贴到“X.509 证书”框中 。
选择“ 验证”。
创建 HubSpot 测试用户
若要使 Microsoft Entra ID 用户能够登录到 HubSpot,必须在 HubSpot 中预配该用户。 在 HubSpot 中,预配是一项手动任务。
若要在 HubSpot 中预配用户帐户,请执行以下操作:
以管理员身份登录 HubSpot 公司站点。
选择页面右上角的 “设置” 图标。
选择 用户和团队。
选择“创建用户”。
在“添加电子邮件地址”框中,按 brittasimon@contoso.com 的格式输入用户的电子邮件地址,然后选择“下一步”。
在“创建用户”部分中,选择每个选项卡 。在每个选项卡上,为用户设置相关选项和权限。 然后选择下一步。
若要向用户发送邀请,请选择“发送” 。
注释
用户接受邀请后,将激活用户。
测试 SSO
在本部分,你将使用以下选项测试 Microsoft Entra 单一登录配置。
由 SP 发起:
选择“ 测试此应用程序”,此选项将重定向到 HubSpot 登录 URL,可在其中启动登录流。
直接转到 HubSpot 登录 URL,并从那里启动登录流。
IDP 已被启动:
- 选择“ 测试此应用程序”,应会自动登录到为其设置了 SSO 的 HubSpot。
还可以使用Microsoft“我的应用”在任何模式下测试应用程序。 在“我的应用”中选择 HubSpot 磁贴时,如果是在 SP 模式下配置的,则会重定向到应用程序登录页来启动登录流;如果是在 IDP 模式下配置的,则应会自动登录到为其设置了 SSO 的 HubSpot。 有关“我的应用”的详细信息,请参阅“我的应用”简介。
相关内容
配置 HubSpot 后,可以强制实施会话控制,以实时防止组织的敏感数据发生外泄和渗透。 会话控制是条件访问的延伸。 了解如何通过 Microsoft Defender for Cloud Apps 强制实施会话控制。