教程:Microsoft Entra SSO 与 Recurly 的集成
本教程介绍如何将 Recurly 与 Microsoft Entra ID 相集成。 将 Recurly 与 Microsoft Entra ID 集成后,可以:
- 在 Microsoft Entra ID 中控制谁有权访问 Recurly。
- 让用户使用其 Microsoft Entra 帐户自动登录到 Recurly。
- 在中心位置管理帐户。
先决条件
若要开始操作,需备齐以下项目:
- 一个 Microsoft Entra 订阅。 如果没有订阅,可以获取一个免费帐户。
- 已启用 Recurly 单一登录 (SSO) 的订阅。
方案描述
在本教程中,将在测试环境中配置并测试 Microsoft Entra SSO。
- Recurly 支持 SP 和 IDP 发起的 SSO。
注意
此应用程序的标识符是一个固定字符串值,因此只能在一个租户中配置一个实例。
从库中添加 Recurly
若要配置 Recurly 与 Microsoft Entra ID 的集成,需要从库中将 Recurly 添加到托管 SaaS 应用列表。
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
- 在“从库中添加”部分的搜索框中,键入“Recurly”。
- 从结果面板中选择“Recurly”,然后添加该应用。 在该应用添加到租户时等待几秒钟。
或者,也可以使用企业应用配置向导。 在此向导中,可以将应用程序添加到租户、将用户/组添加到应用、分配角色,以及逐步完成 SSO 配置。 详细了解 Microsoft 365 向导。
配置并测试 Recurly 的 Microsoft Entra SSO
使用名为 B.Simon 的测试用户配置并测试 Recurly 的 Microsoft Entra SSO。 若要使 SSO 正常工作,需要在 Microsoft Entra 用户与 Recurly 中的相关用户之间建立关联。
若要配置并测试 Recurly 的 Microsoft Entra SSO,请执行以下步骤:
- 配置 Microsoft Entra SSO - 使用户能够使用此功能。
- 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
- 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
- 配置 Recurly SSO - 在应用程序端配置单一登录设置。
- 创建 Recurly 测试用户 - 在 Recurly 中创建 B.Simon 的对应用户,并将其链接到用户的 Microsoft Entra 表示形式。
- 测试 SSO - 验证配置是否正常工作。
配置 Microsoft Entra SSO
按照以下步骤启用 Microsoft Entra SSO。
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”>“Recurly”应用程序集成页,找到“管理”部分,然后选择“单一登录”。
在“选择单一登录方法”页上选择“SAML” 。
在“设置 SAML 单一登录”页面上,单击“基本 SAML 配置”旁边的铅笔图标以编辑设置 。
在“基本 SAML 配置”部分,“标识符”和“回复 URL”值已分别预配置为
https://app.recurly.com
和https://app.recurly.com/login/sso
。 请执行以下步骤以完成配置:a. 在“登录 URL”文本框中,键入 URL:
https://app.recurly.com/login/sso
在“设置 SAML 单一登录”页面上的“SAML 签名证书”部分,单击“编辑”,选择指纹状态旁边的
...
,然后选择“PEM 证书下载”以下载证书并将其保存到计算机上。Recurly 应用程序需要特定格式的 SAML 断言,这要求将自定义属性映射添加到 SAML 令牌属性配置。 以下屏幕截图显示了相关示例。 “唯一用户标识符”的默认值是“user.userprincipalname”,但 Recurly 要求通过用户的电子邮件地址映射此项。 为此,可以使用列表中的 user.mail 属性,或使用基于组织配置的相应属性值。
Recurly 应用程序需要启用令牌加密才能使 SSO 生效。 若要激活令牌加密,请浏览到“标识”>“应用程序”>“企业应用程序”> 选择应用程序 >“令牌加密”。 有关详细信息,请参阅配置 Microsoft Entra SAML 令牌加密一文。
- 请联系 Recurly 支持获取要导入的证书的副本。
- 导入证书后,选择指纹状态旁边的
...
,然后单击“Activate token encryption certificate
”。 - 有关配置令牌加密的详细信息,请参阅此链接。
创建 Microsoft Entra 测试用户
在本部分,你将创建名为 B.Simon 的测试用户。
- 至少以用户管理员身份登录到 Microsoft Entra 管理中心。
- 浏览到“标识”>“用户”>“所有用户”。
- 选择屏幕顶部的“新建用户”>“创建新用户”。
- 在“用户”属性中执行以下步骤:
- 在“显示名称”字段中输入
B.Simon
。 - 在“用户主体名称”字段中,输入 username@companydomain.extension。 例如
B.Simon@contoso.com
。 - 选中“显示密码”复选框,然后记下“密码”框中显示的值。
- 选择“查看 + 创建”。
- 在“显示名称”字段中输入
- 选择“创建”。
分配 Microsoft Entra 测试用户
在本部分中,你将通过授予 B.Simon 访问 Recurly 的权限,允许其使用单一登录。
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 浏览到“标识”>“应用程序”>“企业应用程序”>“Recurly”。
- 在应用的概述页面中,选择“用户和组”。
- 选择“添加用户/组”,然后在“添加分配”对话框中选择“用户和组” 。
- 在“用户和组”对话框中,从“用户”列表中选择“B.Simon”,然后单击屏幕底部的“选择”按钮。
- 如果你希望将某角色分配给用户,可以从“选择角色”下拉列表中选择该角色。 如果尚未为此应用设置任何角色,你将看到选择了“默认访问权限”角色。
- 在“添加分配”对话框中,单击“分配”按钮。
配置 Recurly SSO
请按以下步骤为 Recurly 站点配置单一登录。
以管理员身份登录 Recurly 公司站点。
导航到“管理员”>“用户”。
单击右上方的“配置单一登录”按钮。
在“单一登录”部分,选择“启用”单选按钮,并在“标识提供者”部分执行以下步骤:
a. 在“提供者名称”中,选择“Azure”。
b. 在“SAML 颁发者 ID”文本框中,粘贴“应用程序(客户端 ID)”值。
c. 在“登录 URL”文本框中,粘贴之前复制的“登录 URL”值。
d. 在记事本中打开下载的证书 (PEM),然后将内容粘贴到“证书”文本框中。
e. 单击 “保存更改” 。
创建 Recurly 测试用户
在此部分,需邀请新用户加入你的站点,并要求其使用 SSO 来测试配置。
导航到“管理员”>“用户”,单击“邀请用户”,然后键入之前创建的 Azure 测试用户的电子邮件地址。 邀请会默认要求用户使用 SSO。
测试用户会收到一封来自 Recurly 的电子邮件,邀请其加入你的站点。
接受邀请后,测试用户会在站点中的“公司用户”下列出,并将能够使用 SSO 进行登录。
测试 SSO
在本部分,你将使用以下选项测试 Microsoft Entra 单一登录配置。
SP 启动的:
单击“测试此应用程序”,这会重定向到 Recurly 登录 URL,可以从那里启动登录流。
直接转到 Recurly 登录 URL,并从这里启动登录流。
IDP 启动的:
- 单击“测试此应用程序”后,你应当会自动登录到为其设置了 SSO 的 Recurly。
还可以使用 Microsoft“我的应用”在任何模式下测试此应用程序。 在“我的应用”中单击 Recurly 磁贴时,如果是在 SP 模式下配置的,会重定向到应用程序登录页来启动登录流;如果是在 IDP 模式下配置的,则应会自动登录到为其设置了 SSO 的 Recurly。 有关详细信息,请参阅 Microsoft Entra 我的应用。
后续步骤
配置 Recurly 后,你可以强制实施会话控制,实时防止组织的敏感数据外泄和渗透。 会话控制从条件访问扩展而来。 了解如何通过 Microsoft Cloud App Security 强制实施会话控制。