教學課程：Microsoft Entra 單一登錄 （SSO） 與 EasySSO for BitBucket 整合

在本教學課程中，您將瞭解如何整合 EasySSO for BitBucket 與 Microsoft Entra ID。 在整合 EasySSO for BitBucket 與 Microsoft Entra ID 時，您可以.

• 在 Microsoft Entra 識別符中控制可存取 EasySSO for BitBucket 的人員。
• 讓使用者使用其 Microsoft Entra 帳戶自動登入 EasySSO for BitBucket。
• 在一個集中位置管理您的帳戶：Azure 入口網站。

必要條件

若要開始使用，您需要：

• Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶，可以取得免費帳戶。
• 已啟用單一登錄 （SSO） 的 EasySSO for BitBucket 訂用帳戶。

案例描述

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

• EasySSO for BitBucket 支援由 SP 起始和 IdP 起始的 SSO。
• EasySSO for BitBucket 支援「Just-In-Time」使用者布建。

從資源庫新增 EasySSO for BitBucket

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

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

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

設定及測試 EasySSO for BitBucket 的 Microsoft Entra SSO

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

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

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

設定 Microsoft Entra SSO

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

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

2. 流覽至 [身分>識別應用程式>企業應用程式>EasySSO for BitBucket] 應用程式整合頁面，尋找 [管理] 區段。 選取 [單一登錄]。

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. 選取 [ 設定其他 URL]，如果您想要以 SP 起始模式設定應用程式，請執行下列步驟：

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

   注意

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

7. EasySSO for BitBucket 應用程式需要特定格式的 SAML 判斷提示，因此您必須將自定義屬性對應新增至 SAML 令牌屬性組態。 下列螢幕快照顯示預設屬性的清單。

   

8. EasySSO for BitBucket 應用程式還需要在 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] 選項的下載連結。 將任一或兩者儲存到您的電腦。 您稍後將需要它來設定 BitBucket EasySSO。

   

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

建立 Microsoft Entra 測試使用者

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

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

指派 Microsoft Entra 測試使用者

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

1. 流覽至 [身分>識別應用程式企業應用程式]。>
2. 在應用程式清單中，選取 [EasySSO for BitBucket]。
3. 在應用程式的 [概觀] 頁面中，尋找 [ 管理] 區段，然後選取 [ 使用者和群組]。
4. 選取新增使用者。 在 [ 新增指派] 對話框中，選取 [ 使用者和群組]。
5. 在 [使用者和群組] 對話框中，從 [使用者] 列表中選取 B.Simon，然後選擇畫面底部的 [選取]。
6. 如果您預期將角色指派給使用者，您可以從 [選取角色] 下拉式清單中選取該 角色 。 如果未為此應用程式設定任何角色，您會看到已選取 [預設存取] 角色。
7. 在 [ 新增指派 ] 對話框中，選取 [ 指派]。

設定 EasySSO for BitBucket SSO

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

2. 移至 管理員 istration 區段。

   

3. 找出並選取 [EasySSO]。

   

4. 選取 [SAML]。 這會帶您前往 [SAML 組態] 區段。

   

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

   

6. 找出您在本教學課程上一節中儲存的憑證 （Base64） 或元數據檔案。 您可以透過下列其中一種方式繼續進行：

   • 使用您下載到電腦上本機檔案的應用程式同盟 元數據檔案 。 選取 [ 上傳] 單選按鈕，然後遵循操作系統特有的路徑。

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

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

7. 選取 頁面底部的 [儲存 ]。 您會看到元數據或憑證檔案的內容剖析成組態欄位。 EasySSO for BitBucket 設定已完成。

8. 若要測試設定，請移至 [ 外觀與風格 ] 索引標籤，然後選取 [ SAML 登入按鈕]。 這可在 BitBucket 登入畫面上啟用個別按鈕，特別是測試 Microsoft Entra SAML 整合端對端。 您也可以讓此按鈕保持開啟狀態，並設定其生產模式的放置、色彩和翻譯。

   

   注意

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

建立 EasySSO for BitBucket 測試使用者

在本節中，您會在 BitBucket 中建立名為 Britta Simon 的使用者。 EasySSO for BitBucket 支援依預設停用的 Just-In-Time 使用者布建。 若要啟用此功能，您必須在 EasySSO 外掛程式元件組態的 [一般] 區段中明確檢查 [在成功登入時建立使用者]。 如果 BitBucket 中還沒有任何使用者存在，在驗證之後就會建立新的使用者。

不過，如果您不想在使用者第一次登入時啟用自動使用者布建，用戶必須存在於 BitBucket 實例所使用的使用者目錄中。 例如，此目錄可能是LDAP或 Atlassian Crowd。

測試 SSO

在本節中，您會使用下列選項來測試您的 Microsoft Entra 單一登錄設定。

SP 起始：

• 按兩下 [ 測試此應用程式]，這會重新導向至 EasySSO for BitBucket 登入 URL，您可以在其中起始登入流程。

• 直接移至 EasySSO for BitBucket 登入 URL，然後從該處起始登入流程。

IDP 起始：

• 按兩下 [ 測試此應用程式]，您應該會自動登入您已設定 SSO 的 EasySSO for BitBucket

您也可以使用 Microsoft 我的應用程式 在任何模式中測試應用程式。 當您在 我的應用程式 中按下 EasySSO for BitBucket 圖格時，如果是在 SP 模式中設定，您會重新導向至應用程式登入頁面以起始登入流程，如果在 IDP 模式中設定，則應該會自動登入您已設定 SSO 的 EasySSO for BitBucket。 如需 我的應用程式 的詳細資訊，請參閱 我的應用程式 簡介。

下一步

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