使用 Microsoft Entra ID 設定 RStudio Server Pro 進行單一登錄

2025-05-20

在本文中，您將瞭解如何整合 RStudio Server Pro （RSP）與 Microsoft Entra 識別符。在整合 RSP 與 Microsoft Entra 識別時，您可以：

在 Microsoft Entra 識別碼中控制可存取 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 Authentication 新增到受控 SaaS 應用程式清單。

以至少雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。
請流覽至 Entra ID>企業應用程式>新增應用程式。
在 [從圖庫 新增] 區段中，於搜尋方塊中輸入 RStudio Server Pro SAML Authentication。
從結果面板選取 [RStudio Server Pro SAML Authentication]，然後新增應用程式。將應用程式新增至您的租戶時，請稍等幾秒鐘。

或者，您也可以使用企業應用程式設定精靈。在此精靈中，您可以將應用程式新增至租戶，將使用者或群組新增至應用程式，指派角色，以及完成 SSO 設定。深入瞭解Microsoft 365 精靈。

設定及測試 Microsoft Entra SSO 以用於 RStudio Server Pro

以名為 B.Simon的測試用戶設定及測試 Microsoft Entra SSO 與 RSP 的搭配運作。若要讓 SSO 能夠運作，您必須建立 Microsoft Entra 使用者與 RSP 中相關使用者之間的連結關聯性。

若要設定及測試 Microsoft與 RStudio Server Pro SAML Authentication 搭配運作的 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>Enterprise 應用程式>RStudio Server Pro SAML Authentication>單一登入。
在 [選取單一登錄方法] 頁面上，選取 [SAML]。
在 [ 使用 SAML 設定單一登錄 ] 頁面上，選取 [基本 SAML 組態 ] 的編輯/手寫筆圖示以編輯設定。
如果您想要以 IDP 起始模式設定應用程式，請在 [基本 SAML 組態] 區段上，輸入下列欄位的值：

一個。在 [標識符] 文字框中，使用下列模式輸入 URL： https://<RSP-SERVER>/<PATH>/saml/metadata

b。在 [回覆 URL] 文字框中，輸入符合下列模式的 URL： https://<RSP-SERVER>/<PATH>/saml/acs
如果您想要以 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 Authentication 登入 URL，然後從該處起始登入流程。

IDP 開始：

選取 [測試此應用程式]，然後您應該會自動登入您已經透過 SSO 設定的 RStudio Server Pro SAML 身分驗證。

您也可以使用 Microsoft 存取面板，在任何模式中測試應用程式。當您在存取面板中選取 [RStudio Server Pro SAML Authentication] 圖格時，如果是在 SP 模式中設定，您會重新導向至應用程式登入頁面來起始登入流程，如果在 IDP 模式中設定，則應該會自動登入您已設定 SSO 的 RStudio Server Pro SAML Authentication。如需存取面板的詳細資訊，請參閱存取面板簡介。

設定 RStudio Server Pro SAML Authentication 後，您可以強制執行會話控件，以即時防止組織的敏感數據遭到外洩和滲透。會話控制擴展自條件式存取。瞭解如何使用適用於 Cloud Apps 的 Microsoft Defender強制執行會話控制。