共用方式為

教學課程：設定 GitHub Enterprise Managed User (OIDC) 的自動使用者佈建

  • 發行項

本教學課程說明在 GitHub Enterprise Managed User (OIDC) 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，對 GitHub Enterprise Managed User (OIDC) 自動佈建和取消佈建使用者和群組。 如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。

注意

GitHub Enterprise Managed User (EMU) 為另一種 GitHub Enterprise 帳戶類型。 如果未特別要求 EMU 執行個體，則您具有標準 GitHub Enterprise 帳戶。 在此情況下，請參閱此文件，以在非 EMU 組織中設定使用者佈建。 標準 GitHub Enterprise 帳戶不支援使用者佈建，但其下的組織支援此功能。

支援的功能

  • 在 GitHub Enterprise Managed User (OIDC) 中建立使用者
  • 將再也不需要存取權的使用者從 GitHub Enterprise Managed User (OIDC) 中移除
  • 讓 Microsoft Entra ID 與 GitHub Enterprise Managed User (OIDC) 的使用者屬性保持同步
  • 在 GitHub Enterprise Managed User (OIDC) 中佈建群組和群組成員資格
  • 以單一登入方式登入 GitHub Enterprise Managed User (OIDC) (建議方法)。

必要條件

本教學課程中概述的案例假設您已經具有下列必要條件：

注意

此整合也可從 Microsoft Entra US Government 雲端環境使用。 您可以在 Microsoft Entra US Government 雲端應用程式資源庫中找到此應用程式，並以您從公用雲端所做的相同方式進行設定。

步驟 1：規劃佈建部署

  1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
  2. 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
  3. 判斷哪些資料要在 Microsoft Entra ID 與 GitHub Enterprise Managed User 之間對應。

步驟 2：準備使用 Microsoft Entra 標識符設定布建

  1. 識別您的租使用者 URL。 這是您在 GitHub Enterprise 受控使用者應用程式的 [布建] 索引卷標的 [租使用者 URL] 字段中輸入的值。

    • 針對 GitHub.com 上的企業，租使用者URL為 https://api.github.com/scim/v2/enterprises/{enterprise}。
    • 針對 GHE.com 上的企業，租使用者 URL 為 https://api.{subdomain}.ghe.com/scim/v2/enterprises/{subdomain}

  2. 請確定您已為企業設定使用者建立具有scim：enterprise範圍的令牌。 此值會在 GitHub Enterprise 受控使用者應用程式的 [布建] 索引卷標的 [秘密令牌] 字段中輸入。 請參閱 開始使用 GitHub Docs 上的企業管理使用者 。

從 Microsoft Entra 應用程式資源庫新增 GitHub Enterprise Managed User (OIDC)，藉此開始管理對 GitHub Enterprise Managed User (OIDC) 的佈建。 如果您之前已設定 GitHub Enterprise Managed User (OIDC) 的 SSO，則可使用相同的應用程式。 不過，建議您在一開始測試整合時，建立個別的應用程式。 在此深入了解從資源庫新增應用程式。

步驟 4：定義佈建範圍內的人員

Microsoft Entra 佈建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。

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

  • 如需其他角色，可以更新應用程式資訊清單以新增角色。

步驟 5：設定 GitHub Enterprise Managed User (OIDC) 的自動使用者佈建

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

在 Microsoft Entra ID 中設定 GitHub Enterprise Managed User (OIDC) 的自動使用者佈建：

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

  2. 瀏覽至 [身分識別]>[應用程式]>[企業應用程式]

    企業應用程式刀鋒視窗

  3. 在應用程式清單中，選取 [GitHub Enterprise Managed User (OIDC)]。

    應用程式清單中的 GitHub Enterprise Managed User (OIDC) 連結

  4. 選取 [佈建] 索引標籤。

    佈建索引標籤

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

    佈建索引標籤 [自動]

  6. 在 [管理員認證] 區段下，輸入 GitHub Enterprise Managed User (OIDC) 的租用戶 URL 和秘密權杖。 按一下 [測試連線]，確保 Microsoft Entra ID 可以連線至 GitHub Enterprise Managed User (OIDC)。 如果連線失敗，請確認您的 GitHub Enterprise Managed User (OIDC) 帳戶已建立具備企業擁有者身分的秘密權杖，然後再試一次。

    • 針對 [租使用者 URL]，輸入您稍早識別的租使用者 URL。

      例如，若您的 Enterprise 帳戶 URL 為 https://github.com/enterprises/octo-corp，則 Enterprise 帳戶的名稱即為 octo-corp。

    • 針對 「秘密令牌」，貼上您稍早建立的 GitHub 個人存取令牌。

      Token

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

    通知電子郵件

  8. 選取 [儲存]。

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

  10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 GitHub Enterprise Managed User (OIDC) 的使用者屬性。 如果該屬性已選為 [比對] 屬性，就會在更新作業中用於比對 GitHub Enterprise Managed User (OIDC) 中的使用者帳戶。 如果您選擇變更 相符的目標屬性，您必須確定 GitHub Enterprise 受控使用者 （OIDC） API 支援根據該屬性篩選使用者。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    externalId String ✓
    userName String
    作用中 布林值
    roles String
    displayName String
    name.givenName String
    name.familyName String
    name.formatted String
    emails[type eq "work"].value String
    emails[type eq "home"].value String
    emails[type eq "other"].value String

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

  12. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 GitHub Enterprise Managed User (OIDC) 的群組屬性。 如果該屬性已選為 [比對] 屬性，就會在更新作業中用於比對 GitHub Enterprise Managed User (OIDC) 中的群組。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    externalId String ✓
    displayName String
    成員 參考

  13. 若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。

  14. 若要對 GitHub Enterprise Managed User (OIDC) 啟用 Microsoft Entra 佈建服務，請在 [設定]區段中，將 [佈建狀態] 變更為 [開啟]。

    佈建狀態已切換為開啟

  15. 在 [設定] 區段的 [範圍] 中選擇需要的值，即可定義要佈建到 GitHub Enterprise Managed User (OIDC) 的使用者和/或群組。

    佈建範圍

  16. 當您準備好要佈建時，按一下 [儲存]。

    儲存雲端佈建設定

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

步驟 6：監視您的部署

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

  1. 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
  2. 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
  3. 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。

更多資源

下一步