教學課程:Microsoft Entra SSO 與 JIRA SAML SSO by Microsoft (V5.2) 的整合
在此教學課程中,您會了解如何整合 JIRA SAML SSO by Microsoft (V5.2) 與 Microsoft Entra ID。 整合 JIRA SAML SSO by Microsoft (V5.2) 與 Microsoft Entra ID 時,您可以:
- 在 Microsoft Entra ID 中控制可存取 JIRA SAML SSO by Microsoft (V5.2) 的人員。
- 讓使用者使用其 Microsoft Entra 帳戶自動登入 JIRA SAML SSO by Microsoft (V5.2)。
- 在一個集中式位置管理您的帳戶。
使用您的 Microsoft Entra 帳戶搭配 Atlassian JIRA 伺服器來啟用單一登入。 如此一來,所有組織使用者都能使用 Microsoft Entra 認證來登入 JIRA 應用程式。 此外掛程式使用 SAML 2.0 來進行同盟。
若要設定 Microsoft Entra 與 JIRA SAML SSO by Microsoft (V5.2) 整合,您需要下列項目:
- Microsoft Entra 訂用帳戶。
- 應在 Windows 64 位元版本上安裝及設定 JIRA 核心和軟體 5.2。
- 已啟用 HTTPS 的 JIRA 伺服器。
- 請注意下一節提及支援的 JIRA 外掛程式版本。
- 您可從網際網路連線到 JIRA 伺服器,特別是連線至 Microsoft Entra 登入頁面進行驗證,且應該能夠接收來自 Microsoft Entra ID 的權杖。
- 在 JIRA 中已設定管理員認證。
- 在 JIRA 中已停用 WebSudo。
- 在 JIRA 伺服器應用程式中建立的測試使用者。
注意
若要測試本教學課程中的步驟,我們不建議使用 JIRA 的生產環境。 先在應用程式的開發或預備環境中測試整合,然後使用生產環境。
若要測試本教學課程中的步驟,您應該遵循這些建議:
- 除非必要,否則請勿使用生產環境。
- Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶,可以取得免費帳戶。
注意
請注意,我們的 JIRA 外掛程式也適用於 Ubuntu 16.04 版。
在本教學課程中,您會在測試環境中設定及測試 Microsoft Entra 單一登入。
- JIRA SAML SSO by Microsoft (V5.2) 支援由 SP 起始的 SSO。
若要設定以將 JIRA SAML SSO by Microsoft (V5.2) 整合到 Microsoft Entra ID 中,您需要從資源庫將 JIRA SAML SSO by Microsoft (V5.2) 新增到受控的 SaaS 應用程式清單。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
- 在 [從資源庫新增] 區段的搜尋方塊中輸入 [JIRA SAML SSO by Microsoft (V5.2)]。
- 從結果面板中選取 [JIRA SAML SSO by Microsoft (V5.2)],然後新增應用程式。 將應用程式新增至您的租用戶時,請稍候幾秒鐘。
或者,您也可以使用企業應用程式組態精靈。 在此精靈中,您可以將應用程式新增至租用戶、將使用者/群組新增至應用程式、指派角色,以及逐步進行 SSO 設定。 深入了解 Microsoft 365 精靈。
在本節中,您會以名為 Britta Simon 的測試使用者為基礎,設定及測試與 JIRA SAML SSO by Microsoft (V5.2) 搭配運作的 Microsoft Entra 單一登入。 若要讓單一登入能夠運作,必須建立 Microsoft Entra 使用者與 JIRA SAML SSO by Microsoft (V5.2) 中相關使用者之間的連結關聯性。
若要設定並測試與 JIRA SAML SSO by Microsoft (V5.2) 搭配運作的 Microsoft Entra 單一登入,請執行下列步驟:
- 設定 Microsoft Entra SSO - 讓使用者能夠使用此功能。
- 建立 Microsoft Entra 測試使用者:以 Britta Simon 測試 Microsoft Entra 單一登入。
- 指派 Microsoft Entra 測試使用者:讓 Britta Simon 能夠使用 Microsoft Entra 單一登入。
- 設定 JIRA SAML SSO by Microsoft (V5.2) 的 SSO - 在應用程式端設定單一登入設定。
- 建立 JIRA SAML SSO by Microsoft (V5.2) 測試使用者:使 JIRA SAML SSO by Microsoft (V5.2) 中對應的 Britta Simon 連結到該使用者在 Microsoft Entra 中的代表項目。
- 測試 SSO - 確認組態是否正常運作。
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]> [應用程式]> [企業應用程式]> [JIRA SAML SSO by Microsoft (V5.2)] 應用程式整合頁面,尋找 [管理] 區段並選取 [單一登入]。
在 [選取單一登入方法] 頁面上,選取 [SAML]。
在 [以 SAML 設定單一登入] 頁面上,按一下 [基本 SAML 設定] 的鉛筆圖示,以編輯設定。
在 [基本 SAML 組態] 區段上,執行下列步驟:
a. 在 [識別碼] 方塊中,使用下列模式輸入 URL:
https://<domain:port>/
b. 在 [回覆 URL] 文字方塊中,使用下列模式來輸入 URL:
https://<domain:port>/plugins/servlet/saml/auth
c. 在 [登入 URL] 文字方塊中,以下列模式輸入 URL︰
https://<domain:port>/plugins/servlet/saml/auth
注意
這些都不是真正的值。 使用實際的識別碼、回覆 URL 和登入 URL 來更新這些值。 如果連接埠是具名 URL,則為選擇性。 在設定 Jira 外掛程式 (本教學課程稍後會說明) 期間會收到這些值。
在 [以 SAML 設定單一登入] 頁面的 [SAML 簽署憑證] 區段中,按一下 [複製] 按鈕以複製 [應用程式同盟中繼資料 URL],並將其儲存在您的電腦上。
在本節中,您將建立名為 B.Simon 的測試使用者。
- 以至少是使用者管理員的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別]>[使用者]>[所有使用者]。
- 在畫面頂端選取 [新增使用者]>[建立新使用者]。
- 在 [使用者] 屬性中,執行下列步驟:
- 在 [顯示名稱] 欄位中輸入
B.Simon
。 - 在 [使用者主體名稱] 欄位中輸入 username@companydomain.extension。 例如:
B.Simon@contoso.com
。 - 選取 [顯示密碼] 核取方塊,然後記下 [密碼] 方塊中顯示的值。
- 選取 [檢閱 + 建立]。
- 在 [顯示名稱] 欄位中輸入
- 選取 [建立]。
在本節中,您會將 JIRA SAML SSO by Microsoft (V5.2) 的存取權授與 B.Simon,讓她能夠使用單一登入。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別]> [應用程式]> [企業應用程式]> [JIRA SAML SSO by Microsoft (V5.2)]。
- 在應用程式的概觀頁面中,選取 [使用者和群組]。
- 選取 [新增使用者/群組],然後在 [新增指派] 對話方塊中選取 [使用者和群組]。
- 在 [使用者和群組] 對話方塊中,從 [使用者] 列表中選取 [B.Simon],然後按一下畫面底部的 [選取] 按鈕。
- 如果您預期將角色指派給使用者,則可以從 [選取角色] 下拉式清單中選取該角色。 如果未為此應用程式設定任何角色,您會看到已選取 [預設存取權] 角色。
- 在 [新增指派] 對話方塊中,按一下 [指派] 按鈕。
在不同的網頁瀏覽器視窗中,以系統管理員身分登入您的 JIRA 執行個體。
將滑鼠停留在 cog 上,然後按一下 [附加元件]。
在 [附加元件] 索引標籤區段下,按一下 [管理附加元件]。
從 Microsoft 下載中心下載外掛程式。 使用 [上傳附加元件] 功能表來手動上傳 Microsoft 所提供的外掛程式。 外掛程式下載受到 Microsoft 服務合約的規範。
安裝外掛程式之後,它會出現在 [使用者安裝的附加元件] 區段中。 按一下 [設定] 來設定新的外掛程式。
在組態頁面上執行下列步驟:
提示
請確定只有一個對應至應用程式的憑證,解析中繼資料時就不會發生錯誤。 如果有多個憑證,則解析中繼資料時,管理員會遇到錯誤。
a. 在 [中繼資料 URL] 文字輸入框中,貼上您複製的應用程式同盟中繼資料 URL 值,然後按一下 [解析] 按鈕。 這樣會讀取 IdP 中繼資料 URL 並填入所有欄位資訊。
b. 複製 [識別碼]、[回覆 URL] 和 [登入 URL] 值,然後在 [基本 SAML 組態] 區段中,分別貼到 [識別碼]、[回覆 URL] 和 [登入 URL] 文字輸入框中。
c. 在 [登入按鈕名稱] 中,輸入您的組織要讓使用者在登入畫面上看到的按鈕名稱。
d. 在 [SAML 使用者識別碼位置] 中,選取 [使用者識別碼在 Subject 陳述式的 NameIdentifier 元素中] 或 [使用者識別碼在 Attribute 元素中]。 此識別碼必須為 JIRA 使用者識別碼。 如果使用者識別碼不相符,系統就不會允許使用者登入。
注意
預設 SAML 使用者識別碼位置是名稱識別碼。 您可以將它變更為屬性選項,並輸入適當的屬性名稱。
e. 如果您選取 [使用者識別碼在 Attribute 元素中] 選項,請在 [屬性名稱] 文字方塊中,輸入會預期使用者識別碼的屬性名稱。
f. 若使用同盟網域 (例如 ADFS 等) 搭配 Microsoft Entra ID,請按一下 [啟用主領域探索] 選項,並設定 [網域名稱]。
.g 在 [網域名稱] 中,如果是使用以 ADFS 為基礎的登入,請在此輸入網域名稱。
h. 若要在使用者登出 JIRA 時登出 Microsoft Entra ID,請勾選 [啟用單一登出]。
i. 按一下 [儲存] 按鈕以儲存設定。
注意
如需有關安裝和疑難排解的詳細資訊,請瀏覽 MS JIRA SSO 連接器管理指南,另外也有常見問題集可協助您。
若要讓 Microsoft Entra 使用者能夠登入 JIRA 內部部署伺服器,就必須將這些使用者佈建到 JIRA 內部部署伺服器。
若要佈建使用者帳戶,請執行下列步驟:
以系統管理員身分登入您的 JIRA 內部部署伺服器。
將滑鼠停留在 cog 上,然後按一下 [使用者管理]。
系統會將您重新導向至 [系統管理員存取] 頁面,以輸入密碼,然後按一下 [確認] 按鈕。
在 [使用者管理] 索引標籤區段下,按一下 [建立使用者]。
在 [建立新的使用者] 對話方塊中,執行下列步驟:
a. 在 [電子郵件地址] 文字方塊中,輸入像是 Brittasimon@contoso.com 的使用者電子郵件地址。
b. 在 [全名] 文字方塊中,輸入像是 Britta Simon 的使用者全名。
c. 在 [使用者名稱] 文字方塊中,輸入像是 Brittasimon@contoso.com 的使用者電子郵件。
d. 在 [密碼] 文字方塊中,輸入使用者的密碼。
e. 按一下 [建立使用者]。
在本節中,您會使用下列選項來測試您的 Microsoft Entra 單一登入設定。
按一下 [測試此應用程式],這會重新導向至 JIRA SAML SSO by Microsoft (V5.2) 登入 URL,您可以在此處起始登入流程。
直接移至 JIRA SAML SSO by Microsoft (V5.2) 登入 URL,然後從該處起始登入流程。
您可以使用 Microsoft 我的應用程式。 當您按一下「我的應用程式」中的 JIRA SAML SSO by Microsoft (V5.2) 圖格時,將會重新導向至 JIRA SAML SSO by Microsoft (V5.2) 登入 URL。 如需「我的應用程式」的詳細資訊,請參閱我的應用程式簡介。
設定 JIRA SAML SSO by Microsoft (V5.2) 後,您可以強制執行工作階段控制項,以即時防止組織的敏感資料遭到外洩和滲透。 工作階段控制項會從條件式存取延伸。 了解如何使用適用於雲端的 Microsoft Defender 應用程式來強制執行工作階段控制項。