分享方式：

教學課程：Microsoft Entra 單一登入 (SSO) 與 GitHub Enterprise Managed User 整合

  • 文章

在本教學課程中，您將了解如何整合 GitHub Enterprise Managed User (EMU) 與 Microsoft Entra ID。 整合 GitHub Enterprise Managed User 與 Microsoft Entra ID 後，您可以：

  • 在 Microsoft Entra ID 中控制誰可以存取 GitHub Enterprise Managed User。
  • 讓您的使用者可以使用其 Microsoft Entra 帳戶自動登入 GitHub Enterprise Managed User。
  • 在一個集中式位置管理您的帳戶。

注意

GitHub Enterprise Managed User 是 GitHub Enterprise Cloud 的功能，與 GitHub Enterprise 的標準 SAML SSO 實作不同。 如果未特別要求 EMU 執行個體，則您具有標準 GitHub Enterprise Cloud 方案。 在此情況下，請參閱相關文件，以設定您的非 EMU 組織或企業帳戶，來使用 Microsoft Entra ID 進行驗證。

必要條件

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

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

案例描述

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

  • GitHub Enterprise Managed User 支援SP 和 IDP 起始的 SSO。
  • GitHub Enterprise Managed User 需要自動化的使用者佈建。

若要設定將 GitHub Enterprise Managed User 整合至 Microsoft Entra ID，您必須從資源庫將 GitHub Enterprise Managed User 新增至受控 SaaS 應用程式清單。

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
  3. 在搜尋方塊中輸入 GitHub Enterprise Managed User。
  4. 從結果面板選取 [GitHub Enterprise Managed User]，然後按一下 [建立] 按鈕。 將應用程式新增至您的租用戶時，請稍候幾秒鐘。

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

設定及測試適用於 GitHub Enterprise Managed User 的 Microsoft Entra SSO

若要設定及測試與 GitHub Enterprise Managed User 搭配運作的 Microsoft Entra SSO，請執行下列步驟：

  1. 設定 Microsoft Entra SSO - 在Microsoft Entra 租用戶中啟用 SAML 單一登入。
  2. 設定 GitHub Enterprise Managed User SSO - 在您的 GitHub Enterprise 中設定單一登入設定。

設定 Microsoft Entra SSO

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

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

  2. 瀏覽至 [身分識別] >[應用程式] >[企業應用程式] >[GitHub Enterprise Managed User] >[單一登入]。

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

  4. 在 [以 SAML 設定單一登入] 頁面上，按一下 [基本 SAML 設定] 的鉛筆圖示，以編輯設定。

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

  5. 開始之前，請確定您有 Enterprise URL。 以下所述的實體欄位是已啟用 EMU 的 Enterprise URL 的 Enterprise 名稱。 例如，https://github.com/enterprises/contoso - contoso 是實體。 在 [基本 SAML 設定] 區段上，如果您想要以 IDP 起始模式設定應用程式，請輸入下列欄位的值：

    a. 在 [識別碼] 文字方塊中，使用下列模式來輸入 URL：https://github.com/enterprises/<ENTITY>

    注意

    請注意，識別碼格式與應用程式的建議格式不同 - 請遵循上述格式。 此外，請確定 **識別碼不包含結尾斜線。

    b. 在 [回覆 URL] 文字方塊中，使用下列模式來輸入 URL：https://github.com/enterprises/<ENTITY>/saml/consume

  6. 如果您想要以 SP 起始模式設定應用程式，請按一下 [設定其他 URL]，然後執行下列步驟：

    在 [登入 URL] 文字方塊中，以下列模式輸入 URL︰https://github.com/enterprises/<ENTITY>/sso

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

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

  8. 在 [設定 GitHub Enterprise Managed User] 區段中，複製底下 URL 並加以儲存，以在下面設定 GitHub。

    顯示複製設定 URL 的螢幕擷取畫面。

指派 Microsoft Entra 測試使用者

在本節中，您會將帳戶指派給 GitHub Enterprise Managed User，以便完成 SSO 設定。

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至 [身分識別] >[應用程式] >[企業應用程式] >[GitHub Enterprise Managed User]。
  3. 在應用程式的 [概觀] 頁面中，尋找 [管理] 區段，然後選取 [使用者和群組]。
  4. 選取 [新增使用者]，然後在 [新增指派] 對話方塊中選取 [使用者和群組]。
  5. 在 [使用者和群組] 對話方塊中，從使用者清單選取您的帳戶，然後按一下畫面底部的 [選取] 按鈕。
  6. 在 [選取角色] 對話方塊中，選取 [Enterprise 擁有者] 角色，然後按一下畫面底部的 [選取] 按鈕。 當您在下一個教學課程中佈建帳戶時，系統會將您的帳戶指派為 GitHub 執行個體的 Enterprise 擁有者。
  7. 在 [新增指派] 對話方塊中，按一下 [指派] 按鈕。

設定 GitHub Enterprise Managed User SSO

若要在 GitHub Enterprise Managed User 端設定單一登入，您需要下列項目：

  1. 來自上述 Microsoft Entra Enterprise Managed User 應用程式的 URL：登入 URL；Microsoft Entra 識別碼；以及登出 URL
  2. GitHub Enterprise 第一個管理員使用者的帳戶名稱和密碼。 認證是密碼重設電子郵件所提供，而這封電子郵件來自您的 GitHub 解決方案工程連絡人。

啟用 GitHub Enterprise Managed User SAML SSO

在本節中，您將取得上述 Microsoft Entra ID 所提供的資訊，並將其輸入至您的 Enterprise 設定，以啟用 SSO 支援。

  1. 請前往 https://github.com
  2. 按一下右上角的 [登入]
  3. 輸入第一個管理員使用者帳戶的認證。 登入控制代碼的格式應為：<your enterprise short code>_admin
  4. 瀏覽至 https://github.com/enterprises/ <your enterprise name>。 此資訊應該由您的解決方案工程連絡人提供。
  5. 在左側導覽功能表上，選取 [設定]，然後選取 [驗證安全性]。
  6. 按一下 [要求 SAML 驗證] 核取方塊
  7. 輸入登入 URL。 此 URL 是您從上述 Microsoft Entra ID 複製的登入 URL。
  8. 輸入簽發者。 此 URL 是您從上述 Microsoft Entra ID 複製的 Microsoft Entra 識別碼。
  9. 輸入公開憑證。 請開啟您先前下載的 base64 憑證，並將該檔案的文字內容貼入此對話方塊中。
  10. 按一下 [測試 SAML 設定]。 這會開啟一個對話方塊，讓您使用 Microsoft Entra 認證登入，以驗證是否已正確設定 SAML SSO。 使用您的 Microsoft Entra 認證登入。 驗證成功時您會收到已通過：已成功驗證您的 SAML SSO 身分識別訊息。
  11. 按一下 [儲存] 以持續保存這些設定。
  12. 請將復原碼儲存 (下載、列印或複製) 在安全的地方。
  13. 按一下 [啟用 SAML 驗證] 。
  14. 此時，只有具有 SSO 的帳戶才能登入您的 Enterprise。 請遵循下列文件中的佈建指示，以便佈建 SSO 所支援的帳戶。

下一步

GitHub Enterprise Managed User 要求透過自動使用者佈建來建立所有帳戶。您可以在這裡找到更多有關如何設定自動使用者佈建的詳細資料。