共用方式為

教學課程：Microsoft Entra 單一登入 (SSO) 與 EasySSO for Jira 整合

  • 發行項

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

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

必要條件

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

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

案例描述

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

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

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

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

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

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

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

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

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

設定 Microsoft Entra SSO

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

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

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

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

  4. 在 [以 SAML 設定單一登入] 頁面上，按一下 [基本 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 Jira 應用程式需要特定格式的 SAML 判斷提示，因此您必須將自訂屬性對應新增至 SAML 權杖屬性設定。 下列螢幕擷取畫面顯示預設屬性的清單。

    image

  8. 除了上述屬性外，EasySSO for Jira 應用程式還需要在 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] 選項的 [下載] 連結，並擇一或全部儲存至您的電腦。 您之後將會使用該資料設定 Jira EasySSO。

    憑證下載連結

    若要使用憑證手動執行 EasySSO for Jira 設定，必須從下列區段中，複製 登入 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 測試使用者

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

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

設定 EasySSO for Jira SSO

  1. 使用系統管理員權限登入您的 Atlassian Jira 執行個體，然後瀏覽至 [管理應用程式] 區段。

    管理應用程式

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

    EasySSO

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

    SAML

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

    中繼資料 URL

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

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

    OR

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

    OR

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

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

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

    外觀及風格

    注意

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

建立 EasySSO for Jira 測試使用者

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

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

使用者佈建

測試 SSO

IdP 起始的工作流程

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

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

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

SP 起始的工作流程

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

使用者 SAML 登入

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

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

EasySSO 失敗畫面

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

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

下一步

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