教學課程：Microsoft Entra 單一登入 (SSO) 與適用於 Bamboo 的 EasySSO 整合

在本教學課程中，您將瞭解如何整合適用於 Bamboo 的 EasySSO 與 Microsoft Entra ID。 在整合適用於 Bamboo 的 EasySSO 與 Microsoft Entra ID 時，您可以：

• 在 Microsoft Entra ID 中控制可存取 Bamboo 的人員。
• 讓使用者使用其 Microsoft Entra 帳戶自動登入 Bamboo。
• 在一個集中式位置管理您的帳戶。

必要條件

若要開始使用，您需要下列項目：

• Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶，可以取得免費帳戶。
• 已啟用 EasySSO for Bamboo 單一登入 (SSO) 的訂用帳戶。

案例描述

在本教學課程中，您會在測試環境中設定並測試 Microsoft Entra SSO。

• EasySSO for Bamboo 支援由 SP 和 IDP 起始的 SSO。
• EasySSO for Bamboo 支援 Just In Time 使用者佈建。

從資源庫新增 EasySSO for Bamboo

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

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

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

設定及測試適用於適用於 Bamboo 的 EasySSO 的 Microsoft Entra SSO

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

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

1. 設定 Microsoft Entra SSO - 讓使用者能夠使用此功能。
   1. 建立 Microsoft Entra 測試使用者 - 以使用 B.Simon 測試 Microsoft Entra 單一登入。
   2. 指派 Microsoft Entra 測試使用者 - 讓 B.Simon 使用 Microsoft Entra 單一登入。
2. 設定 EasySSO for Bamboo SSO - 在應用程式端設定單一登入設定。
   1. 建立適用於 Bamboo 的 EasySSO 測試使用者 - 在適用於 Bamboo 的 EasySSO 中建立 B.Simon 的對應項目，且該項目與 Microsoft Entra 中代表使用者的項目連結。
3. 測試 SSO - 確認組態是否正常運作。

設定 Microsoft Entra SSO

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

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

2. 瀏覽至 [身分識別]> [應用程式]> [企業應用程式]> [適用於 Bamboo 的 EasySSO]> [單一登入]。

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

4. 在 [以 SAML 設定單一登入] 頁面上，按一下 [基本 SAML 設定] 的鉛筆圖示，以編輯設定。

   

5. 在 [基本 SAML 設定] 區段上，如果您想要以 IDP 起始模式設定應用程式，請執行下列步驟：

   a. 在 [識別碼] 文字方塊中，使用下列模式來輸入 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 Bamboo 應用程式需要特定格式的 SAML 判斷提示，因此您必須將自訂屬性對應新增至 SAML 權杖屬性設定。 下列螢幕擷取畫面顯示預設屬性的清單。

   

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

   名稱	來源屬性
   urn:oid:0.9.2342.19200300.100.1.1	user.userprincipalname
   urn:oid:0.9.2342.19200300.100.1.3	user.mail
   urn:oid:2.16.840.1.113730.3.1.241	user.displayname
   urn:oid:2.5.4.4	user.surname
   urn:oid:2.5.4.42	user.givenname

   若 Microsoft Entra 使用者設定了 sAMAccountName，您就必須將 urn:oid:0.9.2342.19200300.100.1.1 對應到 sAMAccountName 屬性。

9. 在 [使用 SAML 設定單一登入] 頁面上的 [SAML 簽署憑證] 區段中，按一下 [憑證 (Base64)] 或 [同盟中繼資料 XML] 選項的 [下載] 連結，並擇一或全部儲存至您的電腦。 您之後將會使用該資料設定 Bamboo EasySSO。

   

   若要使用憑證手動執行適用於 Bamboo 的 EasySSO 設定，必須從下列區段中，複製 登入 URL 與 Microsoft Entra 識別碼，並將其儲存在您的電腦上。

建立 Microsoft Entra 測試使用者

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

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

指派 Microsoft Entra 測試使用者

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

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

設定 EasySSO for Bamboo SSO

1. 在不同的 Web 瀏覽器視窗中，以系統管理員身分登入 Zoom 公司網站

2. 瀏覽至 [管理應用程式] 區段。

   

3. 從左側找出 EasySSO，然後按一下。

   

4. 選取 [SAML] 選項。 這會帶您前往 [SAML 設定] 區段。

   

5. 選取頂端的 [憑證] 索引標籤，下列畫面會隨即顯示：

   

6. 現在，請找出您先前在設定 Microsoft Entra SSO 步驟中儲存的憑證 (Base64) 或中繼資料檔案。 您有下列選項可以繼續進行：

   a. 使用您下載到電腦上本機檔案的應用程式同盟 [中繼資料檔案]。 選取 [上傳] 選項按鈕，然後遵循您的作業系統專用的上傳檔案對話方塊執行作業。

   OR

   b. 開啟應用程式同盟 [中繼資料檔案]，以查看檔案的內容 (在任何純文字編輯器中)，並將其複製到剪貼簿。 選取 [輸入] 選項，並將剪貼簿內容貼到文字欄位中。

   OR

   c. 完全手動設定。 開啟應用程式同盟 [憑證 (Base64)]，以查看檔案的內容 (在任何純文字編輯器中)，並將其複製到剪貼簿。 將其貼入 [IdP 權杖簽署憑證] 文字欄位中。 然後瀏覽至 [一般] 索引標籤，並分別在 [POST 繫結 URL] 和 [實體識別碼] 欄位中填入先前所儲存的 [登入 URL ] 和 [Microsoft Entra 識別碼] 值。

7. 按一下頁面底部的 [儲存] 按鈕。 您便會看到中繼資料或憑證檔案的內容剖析到設定欄位中。 EasySSO for Bamboo 設定完成。

8. 若要獲得最佳測試體驗，請瀏覽至 [外觀及風格] 索引標籤，然後將 [SAML 登入按鈕] 選項核取為開啟狀態。 這會在 Bamboo 登入畫面上啟用個別的按鈕，以專門用來端對端測試您的 Microsoft Entra SAML 整合。 您可以讓此按鈕保持開啟狀態，並且也將其位置、色彩和轉譯設定為生產模式。

   

   注意

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

建立 EasySSO for Bamboo 測試使用者

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

不過，如果您不想要在使用者第一次登入時啟用自動使用者佈建，則使用者必須存在於後端使用者目錄中，以供 Bamboo 執行個體使用，例如 LDAP 或 Atlassian Crowd 等。

測試 SSO

IdP 起始的工作流程

在本節中，您會使用「我的應用程式」來測試 Microsoft Entra 單一登入設定。

當您按一下「我的應用程式」中的 [EasySSO for Bamboo] 圖格時，應該會自動登入您已設定 SSO 的 Bamboo 執行個體。 如需「我的應用程式」的詳細資訊，請參閱我的應用程式簡介。

SP 起始的工作流程

在本節中，您將使用 Bamboo 的 [SAML 登入] 按鈕，測試 Microsoft Entra 單一登入設定。

此案例假設您已在 Bamboo EasySSO 設定頁面 (如上所示) 的 [Look & Feel] (外觀與風格) 索引標籤中，啟用了 [SAML Login] (SAML 登入) 按鈕。 在瀏覽器的 incognito 模式中，開啟您的 Bamboo 登入 URL，以免干擾您現有的工作階段。 按一下 [SAML 登入] 按鈕。您將會被重新導向至 Microsoft Entra 使用者驗證流程。 成功完成之後，您將會以通過 SAML 驗證的使用者身分，再被重新導向回您的 Bamboo 執行個體。

從 Microsoft Entra ID 重新導向回來之後，可能會出現下列畫面。

在此情況下，您必須遵循該頁面上的指示，取得 atlassian-bamboo.log 檔案的存取權。 您可以使用錯誤的參考識別碼，在 EasySSO 錯誤頁面上找到該錯誤的詳細資料。

您如有任何有關於摘要記錄訊息的問題，請連絡 EasySSO 支援小組。

下一步

設定 EasySSO for Bamboo 後，您可以強制執行工作階段控制項，以即時防止組織的敏感資料遭到外洩和滲透。 工作階段控制項會從條件式存取延伸。 了解如何使用適用於雲端的 Microsoft Defender 應用程式來強制執行工作階段控制項。