共用方式為


設定 GitHub Enterprise Server 以使用 Microsoft Entra ID 進行單一登入

在本文中,您將瞭解如何將 GitHub Enterprise Server 與 Microsoft Entra ID 整合。 當您將 GitHub Enterprise Server 與 Microsoft Entra ID 整合時,您可以:

  • 在 Microsoft Entra ID 中控制誰有權存取 GitHub Enterprise Server。
  • 讓您的使用者能夠使用其 Microsoft Entra 帳戶自動登入 GitHub Enterprise Server。
  • 在一個中央位置管理您的帳戶。

先決條件

若要開始,您需要下列項目:

  • Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶,可以取得免費帳戶
  • GitHub Enterprise Server,準備初始
  • 除了雲端應用程式管理員外,應用程式管理員也可以在 Microsoft Entra ID 中新增或管理應用程式。 如需詳細資訊,請參閱<Azure 內建角色>。

案例描述

在本文中,您會在測試環境中進行 Microsoft Entra SSO 的設定和測試。

  • GitHub Enterprise Server 支援 SPIDP 起始的 SSO。
  • GitHub Enterprise Server 支援 Just In Time 使用者佈建。
  • GitHub Enterprise Server 支援 自動化使用者佈建

若要設定 GitHub Enterprise Server 與 Microsoft Entra ID 的整合,您必須將資源庫中的 GitHub Enterprise Server 新增至受控 SaaS 應用程式清單。

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

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

設定和測試適用於 GitHub Enterprise Server 的 Microsoft Entra SSO

使用名為 B.Simon 的測試使用者,使用 GitHub Enterprise Server 設定和測試 Microsoft Entra SSO。 若要讓 SSO 運作,您必須在 Microsoft Entra 使用者與 GitHub Enterprise Server 中的相關使用者之間建立連結關聯性。

若要使用 GitHub Enterprise Server 設定和測試 Microsoft Entra SSO,請執行下列步驟:

  1. 設定 Microsoft Entra SSO - 讓使用者能夠使用此功能。
    1. 建立 Microsoft Entra 測試使用者 - 以使用 B.Simon 測試 Microsoft Entra 單一登入。
    2. 指派 Microsoft Entra 測試使用者 - 讓 B.Simon 使用 Microsoft Entra 單一登入。
  2. 設定 GitHub Enterprise Server SSO - 在應用程式端設定單一登入設定。
    1. 建立 GitHub Enterprise Server 測試使用者 - 在 GitHub Enterprise Server 中擁有 B.Simon 的對應專案,連結至使用者的 Microsoft Entra 表示法。
  3. 測試 SSO - 確認組態是否正常運作。

設定 Microsoft Entra SSO

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

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

  2. 瀏覽至 Entra ID>Enterprise 應用程式>GitHub Enterprise Server>單一登入

  3. 選取單一登錄方法 頁面上,選取 SAML

  4. 在 [設定使用 SAML 單一登入] 頁面上,選取 [基本 SAML 組態] 的鉛筆圖示來編輯設定。

    螢幕擷取畫面顯示如何編輯基本 SAML 設定。

  5. 基本SAML組態 區段中,如果您要在 IDP 啟動模式下設定應用程式,請執行以下步驟:

    一。 在 [識別碼 (實體 ID)] 文字方塊中,使用下列模式輸入 URL: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b。 在 [回覆 URL ] 文字方塊中,使用下列模式輸入 URL: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

  6. 選取 設定 其他 URL, 如果您想要在 SP 啟動模式中設定應用程式,請執行下列步驟:

    登入 URL 文字方塊中,使用下列模式輸入 URL: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    備註

    這些價值觀不是真實的。 使用實際的 Identifier、回覆 URL 和登入 URL 更新這些值。 請連絡 GitHub Enterprise Server 用戶端支援小組 以取得這些值。 您也可以參閱 基本 SAML 組態 一節中顯示的模式。

  7. GitHub Enterprise Server 應用程式需要特定格式的 SAML 宣告,這需要您將自訂屬性對應新增至 SAML 權杖屬性設定。 下列螢幕擷取畫面顯示預設屬性清單。

    螢幕截圖顯示了企業伺服器應用程式的圖像。

  8. 編輯 使用者屬性和宣告

  9. 選取 [ 新增宣告 ],然後輸入文字方塊中的名稱 administrator (值 administrator 區分大小寫)。

  10. 展開 [索賠條件],然後從 [使用者類型] 中選取 [成員]。

  11. 選取 選取群組 ,然後搜尋您要包含此宣告的 群組 ,其中其成員應該是 GHES 的管理員。

  12. 選取 [來源] 的 [屬性],然後輸入 true (不含引號) 值。

  13. 選取 [儲存]。

    螢幕擷取畫面顯示管理屬性宣告。

  14. 在 [ 使用 SAML 設定單一登入 ] 頁面的 [ SAML 簽署憑證 ] 區段中,尋找 [憑證 (Base64)] ,然後選取 [ 下載 ] 以下載憑證並將其儲存在您的電腦上。

    螢幕擷取畫面顯示憑證下載連結。

  15. [設定 GitHub Enterprise Server ] 區段上,根據您的需求複製適當的 URL。

    螢幕擷取畫面顯示複製適當的組態 U R. L。

建立並指派 Microsoft Entra 測試使用者

請遵循 建立並指派用戶帳戶 快速入門中的指導方針,以建立名為 B.Simon 的測試用戶帳戶。

設定 GitHub Enterprise Server SSO

若要在 GitHub Enterprise Server 端設定 SSO,您必須遵循 此處所述的指示。

建立 GitHub Enterprise Server 測試使用者

在本節中,會在 GitHub Enterprise Server 中建立名為 B.Simon 的使用者。 GitHub Enterprise Server 支援 Just-In-Time 使用者佈建,預設會啟用。 本節中沒有適合您的動作項目。 如果使用者尚未存在於 GitHub Enterprise Server 中,則會在驗證後建立新的使用者。

GitHub Enterprise Server 也支援自動使用者佈建。 您可以在這裡找到有關如何設定自動使用者佈 建的更多 詳細資訊。

測試 SSO

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

SP 發起:

  • 選取 [ 測試此應用程式],此選項會重新導向至 GitHub Enterprise Server 登入 URL,您可以在其中起始登入流程。

  • 直接移至 GitHub Enterprise Server 登入 URL,並從該處起始登入流程。

IDP 發起:

  • 選取 [ 測試此應用程式],您應該會自動登入您設定 SSO 的 GitHub Enterprise Server。

您也可以使用 Microsoft 我的應用程式 在任何模式下測試應用程式。 當您在 [我的應用程式] 中選取 [GitHub Enterprise Server] 磚時,如果設定為 SP 模式,系統會將您重新導向至應用程式登入頁面以起始登入流程,如果設定為 IDP 模式,您應該會自動登入您設定 SSO 的 GitHub Enterprise Server。 如需詳細資訊,請參閱 Microsoft Entra My Apps