設定 GitHub Enterprise Server 以使用 Microsoft Entra ID 自動佈建使用者

本文說明您需要在 GitHub Enterprise Server 和 Microsoft Entra ID 中執行的步驟，以設定自動使用者佈建。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務自動佈建和取消佈建使用者和/或群組至 GitHub Enterprise Server。 如需此服務用途、運作方式和常見問題的重要詳細資料，請參閱 使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式。

支援的功能

先決條件

本文中所述的案例假設您已經具備下列必要條件：

• 具有作用中訂用帳戶的 Microsoft Entra 使用者帳戶。 如果您還沒有帳戶，您可以 免費建立帳戶。
• 下列其中一個角色：
  • 應用程式系統管理員
  • 雲端應用程式系統管理員
  • 應用程式擁有者。

• GitHub Enterprise Server，已完全 初始化 並設定為透過 Microsoft Entra 租使用者使用 SAML SSO 登入。

步驟 1：規劃您的配置部署

1. 了解佈建服務的工作原理。
2. 判斷在 範圍內應配置的人員。
3. 決定要 在 Microsoft Entra ID 與 GitHub Enterprise Server 之間對應哪些資料。

步驟 2：設定 GitHub Enterprise Server 以支援使用 Microsoft Entra ID 布建

在這裡了解如何啟用 GitHub Enterprise Server 的佈建。

步驟 3：從 Microsoft Entra 應用程式資源庫新增 GitHub Enterprise Server

從 Microsoft Entra 應用程式資源庫新增 GitHub Enterprise Server，以開始管理 GitHub Enterprise Server 的布建。 如果您先前已設定 GitHub Enterprise Server 的 SSO，則可以使用相同的應用程式。 不過，我們建議您在一開始測試整合時建立個別的應用程式。 了解有關從圖庫添加應用程序的更多信息 請點擊這裡.

步驟 4：定義布建範圍中的人員

Microsoft Entra 布建服務可讓您根據指派給應用程式，或根據使用者或群組的屬性來設定布建的人員範圍。 如果您選擇根據指派來設定布建至應用程式的人員範圍，您可以使用 步驟將使用者和群組指派給應用程式。 如果您選擇僅依據使用者或群組的屬性來設定布建範圍，則可以 使用範圍篩選。

• 從小規模開始。 在向所有人推出之前，先使用一組小型的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。

• 如果您需要額外的角色，您可以 更新應用程式指令清單 以新增角色。

步驟 5：設定 GitHub Enterprise Server 的自動使用者佈建

本節會引導您完成設定 Microsoft Entra 布建服務的步驟，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 TestApp 中建立、更新和停用使用者和/或群組。

若要在 Microsoft Entra ID 中設定 GitHub Enterprise Server 的自動使用者佈建：

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

2. 瀏覽至 Entra ID>Enterprise 應用程式

   

3. 在應用程式清單中，選取 [GitHub Enterprise Server]。

   

4. 選擇 佈建 分頁。

   

5. 將佈 建模式 設定為 自動。

   

6. 在 [管理員認證] 區段下，輸入您的 GitHub Enterprise Server 租用戶 URL 和 秘密權杖。 欄位的值採用下列格式：

   • 租戶 URL： https://<your-github-server-domain>/api/v3/scim
   • 秘密權杖：您在 GitHub Enterprise Server 執行個體中為布建帳戶建立的個人存取權杖 （PAT）。

   選取 [測試連線] 以確定 Microsoft Entra ID 可以連線到 GitHub Enterprise Server。 如果連線失敗，請確定您的 GitHub Enterprise Server 帳戶具有管理員權限，然後再試一次。

   

7. 在 [通知電子郵件 ] 欄位中，輸入應接收佈建錯誤通知的人員或群組的電子郵件地址，然後選取 [ 發生失敗時傳送電子郵件通知] 核取方塊。

   

8. 選取 [儲存]。

9. 在 [ 對應] 區段下，選取 [佈建 Microsoft Entra ID 使用者]。

10. 在 [屬性對應] 區段中檢閱從 Microsoft Entra ID 同步處理至 GitHub Enterprise Server 的使用者屬性。 選取為 [比對屬性] 的屬性可用來比對 GitHub Enterprise Server 中的使用者帳戶以進行更新作業。 如果您選擇變更 相符的目標屬性，則需要確保 GitHub Enterprise Server API 支援根據該屬性篩選使用者。 點擊 儲存 按鈕以儲存所有變更。

    Attribute	類型
    userName	繩子
    externalId	繩子
    emails[type eq "work"].value	繩子
    active	布林值
    name.givenName	繩子
    name.familyName	繩子
    name.formatted	繩子
    displayName	繩子

11. 在 [ 對應] 區段下，選取 [佈建 Microsoft Entra ID 群組]。

12. 檢閱從 Microsoft Entra ID 同步處理至 GitHub Enterprise Server 的群組屬性，請參閱 [屬性對應 ] 區段。 選取為 [相符屬性] 的屬性可用來比對 GitHub Enterprise Server 中的群組以進行更新作業。 點擊 儲存 按鈕以儲存所有變更。

    Attribute	類型
    displayName	繩子
    externalId	繩子
    members	Reference

13. 若要設定範圍篩選，請參閱範圍篩選 一文中提供的下列指示。

14. 若要啟用 GitHub Enterprise Server 的 Microsoft Entra 布建服務，請在 [設定] 區段中將 [佈建狀態] 變更為 [開啟]。

    

15. 定義您要佈建至 GitHub Enterprise Server 的使用者和/或群組，方法是在 [設定] 區段的 [範圍] 中選擇所需的值。

    

16. 準備好佈建時，請選擇 儲存。

    

此作業會啟動 [設定] 區段中 [範圍] 中定義的所有使用者和/或群組的初始同步處理週期。 初始週期的執行時間比後續週期更長，只要 Microsoft Entra 布建服務正在執行，大約每 40 分鐘就會發生一次。

步驟 6：監視您的部署

設定佈建後，請使用下列資源來監視部署：

1. 使用 佈建記錄 可以判斷使用者是否已順利完成佈建
2. 檢查 進度列 以查看配置週期的狀態，以及該週期接近完成的程度。
3. 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 深入瞭解 應用程式的布建隔離狀態，請參閱文章 №。

變更紀錄

• 2021 年 2 月 18 日 - 新增了對群組佈建的支援。
• 2025 年 8 月 19 日 - 更新了「GitHub AE」至「GitHub Enterprise Server」的連結和提及，以反映目前的產品名稱。

其他資源

• 管理企業應用程式的使用者帳戶佈建
• 什麼是使用 Microsoft Entra ID 進行應用程式存取和單一登入？

相關內容

• 瞭解如何針對佈建活動檢閱記錄和取得報告