共用方式為

Microsoft Entra 單一登錄 （SSO） 與 EasySSO for Confluence 整合

  • 發行項

在本文中，您將瞭解如何整合 EasySSO for Confluence 與 Microsoft Entra ID。 在整合 EasySSO for Confluence 與 Microsoft Entra ID 時，您可以：

  • 在 Microsoft Entra ID 中控制誰可以存取 Confluence。
  • 讓使用者使用其Microsoft Entra 帳戶自動登入 Confluence。
  • 在一個中央位置管理您的帳戶。

先決條件

本文中所述的案例假設您已經具備下列必要條件：

  • 已啟用 EasySSO for Confluence 單一登錄 （SSO） 的訂用帳戶。

案例描述

在本文中，您將在測試環境中設定及測試 Microsoft Entra SSO。

  • EasySSO for Confluence 支援 SP 和 IDP 發起的 SSO。
  • EasySSO for Confluence 支援 Just In Time 使用者布建。

若要設定將 EasySSO for Confluence 整合到 Microsoft Entra ID 中，您需要從資源庫將 EasySSO for Confluence 新增到受控 SaaS 應用程式清單。

  1. 以至少 雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。
  2. 流覽至 Identity>應用程式>Enterprise 應用程式>新增應用程式。
  3. 在「從圖庫新增」區段中，於搜尋方塊中輸入 EasySSO for Confluence。
  4. 從結果面板選取 [EasySSO for Confluence]，然後新增應用程式。 將應用程式新增至您的租用戶時，請稍候幾秒鐘。

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

設定並測試 Microsoft Entra SSO 以整合 EasySSO 的 Confluence

使用名為 B.Simon 的測試用戶，配置並測試 Microsoft Entra SSO 與 EasySSO for Confluence 的整合。 若要讓 SSO 能夠運作，您必須建立 Microsoft Entra 使用者與 EasySSO for Confluence 中相關使用者之間的連結關聯性。

若要設定及測試與 EasySSO for Confluence 搭配運作 Microsoft的 Entra SSO，請執行下列步驟：

  1. 設定 Microsoft Entra SSO - 讓用戶能夠使用此功能。
    1. 建立 Microsoft Entra 測試使用者 - 使用 B.Simon 測試Microsoft Entra 單一登錄。
    2. 指派Microsoft Entra 測試使用者 - 讓 B.Simon 能夠使用 Microsoft Entra 單一登錄。
  2. 設定 EasySSO for Confluence SSO - 在應用程式端設定單一登入設定。
    1. 為 Confluence 建立 EasySSO 的測試使用者 - 以便在 EasySSO for Confluence 中的 B.Simon 能連結到該使用者在 Microsoft Entra 中的用戶代表。
  3. 測試 SSO - 確認組態是否正常運作。

設定 Microsoft Entra SSO

請遵循下列步驟來啟用 Microsoft Entra SSO。

  1. 以至少 雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。

  2. 瀏覽至 Identity>Applications>企業應用程式>EasySSO for Confluence>單一登入。

  3. 在 [選取單一登入方法] 頁面上，選取 [SAML]。

  4. 在 [使用 SAML 設定單一登錄] 頁面上，點擊 [基本 SAML 組態] 的鉛筆圖示來編輯設定。

    編輯基本 SAML 組態

  5. 如果您想要以 IDP 起始模式設定應用程式，請在 [基本 SAML 組態] 區段上，輸入下列欄位的值：

    一個。 在 [標識符] 文字框中，使用下列模式輸入 URL： https://<server-base-url>/plugins/servlet/easysso/saml

    b. 在 [回應 URL] 文字框中，使用下列模式輸入 URL： https://<server-base-url>/plugins/servlet/easysso/saml

  6. 如果您想要以 SP 起始模式設定應用程式，請按兩下 [設定其他 URL，然後執行下列步驟：

    在 [登入 URL] 文字方塊中，使用下列模式輸入 URL：https://<server-base-url>/login.jsp

    注意

    這些值不是真實的。 使用實際的標識碼、回復 URL 和登入 URL 來更新這些值。 如有疑問，請連絡 EasySSO 支援小組 以取得這些值。 您也可以參考 基本 SAML 組態 一節中顯示的模式。

  7. EasySSO for Confluence 應用程式需要特定格式的 SAML 聲明，因此您必須將自定義屬性對應新增至 SAML 權杖屬性設定。 下列螢幕快照顯示預設屬性的清單。

    圖片

  8. 除了上述屬性外，EasySSO for Confluence 應用程式還需要在 SAML 回應中多傳回幾個屬性，如下所示。 這些屬性也會預先填入，但您可以根據您的需求檢閱這些屬性。

    名字 來源屬性
    urn：oid：0.9.2342.19200300.100.1.1 使用者.使用者主體名稱 (user.userprincipalname)
    urn：oid：0.9.2342.19200300.100.1.3 使用者.郵件
    urn：oid：2.16.840.1.113730.3.1.241 用戶顯示名稱
    urn：oid：2.5.4.4 使用者.姓氏
    urn：oid：2.5.4.42 使用者.名字

    如果您的Microsoft Entra 使用者已設定 sAMAccountName，您必須將 urn：oid：0.9.2342.19200300.100.1.1 對應到 sAMAccountName 属性。

  9. 在 [設定使用 SAML 單一登錄] 頁面的 [SAML 簽署憑證] 區段中，按一下 [下載 連結]，選擇 [憑證 (Base64)] 或 [同盟中繼資料 XML] 選項，並將其或全部儲存到您的電腦。 您稍後將需要它來設定 Confluence EasySSO。

    憑證下載連結

    如果您打算使用憑證手動執行 EasySSO for Confluence 設定，您也需要從下列區段複製 登入 URL 和 Microsoft Entra Identifier，並將這些專案儲存在您的電腦上。

建立 Microsoft Entra 測試使用者

在本節中，您將建立名為 B.Simon 的測試使用者。

  1. 以至少 使用者管理員的身分登入 Microsoft Entra 系統管理中心。
  2. 流覽至 身分識別>使用者>所有使用者。
  3. 選取畫面頂端的 新增使用者>，建立新使用者。
  4. 在 User 屬性中，遵循下列步驟：
    1. 在 [顯示名稱] 欄位中，輸入 B.Simon。
    2. 在 [使用者主體名稱] 欄位中，輸入 username@companydomain.extension。 例如，B.Simon@contoso.com。
    3. 選取 [顯示密碼] 複選框，然後記下 [密碼] 方塊中顯示的值。
    4. 選取 檢閱 + 建立。
  5. 選取 建立。

指派 Microsoft Entra 測試使用者

在本節中，您會將 EasySSO for Confluence 的存取權授與 B.Simon，讓其能夠使用單一登錄。

  1. 以至少 雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至 身份>應用程式>企業應用程式>EasySSO for Confluence。
  3. 在應用程式的 [概觀] 頁面中，選取 [[使用者和群組]。
  4. 選取 新增使用者/群組，然後在 新增指派 對話框中選取 使用者和群組。
    1. 在 [使用者和群組] 對話框中，從 [使用者] 列表中選取 [B.Simon]，然後按兩下畫面底部的 [選取 ] 按鈕。
    2. 如果您預期將角色指派給使用者，您可以從 選取角色 下拉式清單中加以選取。 如果未為此應用程式設定任何角色，您會看到已選取 [預設存取] 角色。
    3. 在 [新增指派] 對話框中，按兩下 [指派] 按鈕。

設定 EasySSO 以實現 Confluence 單一登入 (SSO)

  1. 在不同的網頁瀏覽器視窗中，以系統管理員身分登入您的 EasySSO for Confluence 公司網站，並流覽至 [管理應用程式] 區段。

    管理應用程式

  2. 在左側找到 EasySSO，然後按兩下它。 然後按下 [配置] 按鈕。

    簡易單一登入系統

  3. 選取 [SAML] 選項。 這會帶您前往 [SAML 設定] 部分。

    SAML

  4. 選取頂端的 [憑證] 索引標籤，您會看到下列畫面：

    元數據 URL

  5. 現在，請定位到您在先前的 Microsoft Entra SSO 組態步驟中儲存的 憑證（Base64） 或 元數據檔案。 您有下列有關如何繼續的選項：

    一個。 使用應用程式同盟 元數據檔案 下載到您電腦上的本機檔案。 選取 上傳 單選按鈕，然後遵循對應作業系統的上傳檔案對話框。

    OR

    b. 開啟應用程式同盟 元數據檔案，以查看檔案的內容（在任何純文本編輯器中），並將其複製到剪貼簿。 選取 [[輸入] 選項，然後將剪貼簿內容貼到文字欄位中。

    OR

    c. 完全手動設定。 開啟應用程式同盟 憑證 （Base64），以查看檔案的內容（在任何純文本編輯器中），並將其複製到剪貼簿。 將它貼到 IdP 令牌簽署憑證 文字欄位。 然後瀏覽至 一般 索引標籤，並填入 POST 連結 URL 和 實體標識符 欄位，其中包含您先前儲存的 登入 URL 和 Microsoft Entra 標識符。

  6. 在頁面底部，按一下 [儲存] 按鈕。 您會看到元數據或憑證檔案的內容剖析成組態欄位。 EasySSO for Confluence 設定已完成。

  7. 如需最佳的測試體驗，請導航至 [查看 & 感覺] 索引標籤，然後核取 [SAML 登入按鈕] 選項。 這會在 Confluence 登入畫面上啟用個別按鈕，特別用來測試您的Microsoft Entra SAML 整合端對端。 您也可以讓此按鈕保持開啟，並設定其生產模式的放置、色彩和翻譯。

    外觀與感受

    注意

    如有任何問題，請連絡 EasySSO 支援小組。

建立 EasySSO for Confluence 測試使用者

本節會在 Confluence 中建立名為 Britta Simon 的使用者。 EasySSO for Confluence 支援即時使用者布建，預設為停用。 若要啟用使用者布建，您必須在 EasySSO 外掛程式設定的 [一般] 區段中，明確勾選 [在成功登入時建立使用者] 選項。 如果 Confluence 中還沒有任何使用者存在，在驗證之後就會建立新的使用者。

不過，如果您不想在使用者第一次登入時啟用自動使用者布建，使用者就必須已存在於 Confluence 實例所使用的後端使用者目錄中，例如 LDAP 或 Atlassian Crowd。

使用者布建

測試 SSO

IdP 啟動的工作流程

在本節中，您會使用 My Apps 來測試您的 Microsoft Entra 單一登錄設定。

當您在 My Apps 中按下 EasySSO for Confluence 圖格時，應該會自動登入您已設定 SSO 的 Confluence 實例。 如需 My Apps 的詳細資訊，請參閱 My Apps簡介。

SP 發起的工作流程

在本節中，您會使用 Confluence SAML Login 按鈕來測試您的 Microsoft Entra 單一登錄設定。

使用者 SAML 登入

此案例假設您已在 Confluence EasySSO 組態頁面的 [Look & Feel] 索引卷標中啟用 SAML 登入按鈕（請參閱上圖）。 在瀏覽器的無痕模式中開啟您的 Confluence 登入網址，以避免影響您目前的會話。 按一下 SAML 登入 按鈕後，您會被導向至 Microsoft Entra 的使用者驗證流程。 成功完成後，您將會通過SAML被重新導回至您的Confluence實例，並以驗證過的使用者身份登入。

從 Microsoft Entra ID 重新導向之後，您可能會遇到下列畫面

EasySSO 失敗畫面

在此情況下，您必須遵循此頁面上的 指示， 以取得 atlassian-confluence.log 檔案的權限。 在 EasySSO 錯誤頁面上找到的參考識別碼將會提供錯誤的詳細數據。

如果您在理解日誌訊息時有任何問題，請連絡 EasySSO 支援小組。

相關內容

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