使用 Microsoft Entra ID 配置 RStudio Server Pro 进行单一登录

2025-05-20

本文介绍如何将 RStudio Server Pro （RSP）与 Microsoft Entra ID 集成。将 RSP 与 Microsoft Entra ID 集成后，可以：

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

先决条件

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

具有活动订阅的 Microsoft Entra 用户帐户。如果还没有帐户，可以免费创建帐户。
以下角色之一：

RSP（版本 >= 1.4）安装。

方案说明

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

RSP 支持 SP 和 IDP 发起的 SSO

从库中添加 RStudio Server Pro

若要配置 RSP 与 Microsoft Entra ID 的集成，需要从库中将 RStudio Server Pro SAML 身份验证添加到托管 SaaS 应用列表。

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

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

配置并测试 RStudio Server Pro 的 Microsoft Entra SSO

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

若要配置并测试 RStudio Server Pro SAML 身份验证的 Microsoft Entra SSO，请执行以下步骤：

配置 Microsoft Entra SSO - 使用户能够使用此功能。
1. 创建 Microsoft Entra 测试用户 - 使用 B.Simon 测试 Microsoft Entra 单一登录。
2. 分配 Microsoft Entra 测试用户 - 使 B.Simon 能够使用 Microsoft Entra 单一登录。
配置 RStudio Server Pro SSO - 在应用程序端配置单一登录设置。
1. 创建 RStudio Server Pro 测试用户 - 在 RStudio Server Pro 中为 B.Simon 创建一个等效用户，链接到 Microsoft Entra 中的用户表示形式。
测试 SSO - 验证配置是否正常工作。

配置 Microsoft Entra SSO

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

以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到Entra ID>企业应用>RStudio Server Pro SAML 认证>单点登录。
在“选择单一登录方法”页上选择“SAML” 。
在“设置 SAML 单一登录”页上，选择“基本 SAML 配置”的编辑/笔图标以编辑设置。
在 “基本 SAML 配置 ”部分中，如果要在 IDP 发起的模式下配置应用程序，请输入以下字段的值：

a。在“标识符”文本框中，使用以下模式键入 URL：

b. 在“回复 URL”文本框中，使用以下模式键入 URL：
若要在 SP 启动模式下配置应用程序，请选择“设置其他 URL”，并执行以下步骤：

在 “登录 URL ”文本框中，使用以下模式键入 URL： https://<RSP-SERVER>/<PATH>/

注释

这些值不是真实的。将这些值更新为你的 RSP 安装的实际 URI。还可以参考 “基本 SAML 配置 ”部分中显示的模式。
在“设置 SAML 单一登录”页上的“SAML 签名证书”部分，选择“复制”按钮以复制“应用联合元数据 URL”，并将其保存在计算机上。

创建和分配 Microsoft Entra 测试用户

请遵循创建和分配用户帐户快速入门中的准则，以创建一个名为 B.Simon 的测试用户帐户。

配置 RStudio Server Pro SSO

将 RSP 配置文件 /etc/rstudio/rserver.conf 更新为以下内容：

auth-saml=1
auth-saml-metadata-url=<federation-metadata-URI>
auth-saml-sp-name-id-format=emailaddress
auth-saml-sp-attribute-username=NameID
auth-saml-sp-base-uri=<RSP-Server-URI>

通过运行以下内容重启 RSP：
```
sudo rstudio-server restart
```

创建 RStudio Server Pro 测试用户

必须在服务器上对要使用 RSP 的所有用户进行预配。可以使用 useradd 和 adduser 命令创建用户。

测试 SSO

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

由 SP 发起：

选择“ 测试此应用程序”，此选项将重定向到 RStudio Server Pro SAML 身份验证登录 URL，可在其中启动登录流。
直接转到 RStudio Server Pro SAML 身份验证登录 URL，并从那里启动登录流。

IDP 已被启动：

选择“ 测试此应用程序”，应会自动登录到为其设置了 SSO 的 RStudio Server Pro SAML 身份验证

还可以使用Microsoft访问面板在任何模式下测试应用程序。在访问面板中选择 RStudio Server Pro SAML 身份验证磁贴时，如果是在 SP 模式下配置的，则会重定向到应用程序登录页来启动登录流;如果是在 IDP 模式下配置的，则应会自动登录到为其设置了 SSO 的 RStudio Server Pro SAML 身份验证。有关访问面板的详细信息，请参阅访问面板简介。

配置 RStudio Server Pro SAML 身份验证后，可以强制实施会话控制，实时防止组织的敏感数据外泄和渗透。会话控制是条件访问的延伸。了解如何使用 Microsoft Defender for Cloud Apps 强制实施会话控制。