Share via

教學課程：Microsoft Entra 單一登入 （SSO） 與 GitHub Enterprise 受控使用者整合

  • 發行項

在本教學課程中，您將瞭解如何整合 GitHub Enterprise 受控使用者 （EMU） 與 Microsoft Entra ID。 在整合 GitHub Enterprise 受控使用者與 Microsoft Entra ID 時，您可以.

  • 在 Microsoft Entra 識別碼中控制可存取 GitHub Enterprise 受控使用者的人員。
  • 讓使用者使用其 Microsoft Entra 帳戶自動登入 GitHub Enterprise 受控使用者。
  • 在一個中央位置管理您的帳戶。

注意

GitHub Enterprise 受控使用者 是 GitHub Enterprise Cloud 的功能，與 GitHub Enterprise 的標準 SAML SSO 實作不同。 如果您尚未特別要求 EMU 實例，您有標準的 GitHub Enterprise Cloud 方案。 在此情況下，請參閱相關檔，以設定您的非 EMU 組織 或 企業帳戶 ，以使用 Microsoft Entra 識別碼進行驗證。

必要條件

若要開始使用，您需要下列專案：

  • Microsoft Entra 訂用帳戶。 如果您沒有訂用帳戶，可以取得免費帳戶。
  • 已啟用 GitHub Enterprise 受控使用者單一登入 （SSO） 的訂用帳戶。

案例描述

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

  • GitHub Enterprise 受控使用者支援 由 SP 和 IDP 起始的 SSO。
  • GitHub Enterprise 受控使用者需要 自動 使用者布建 。

若要設定將 GitHub Enterprise 受控使用者整合到 Microsoft Entra ID 中，您需要從資源庫將 GitHub Enterprise 受控使用者新增到受控 SaaS 應用程式清單。

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

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

設定及測試 GitHub Enterprise 受控使用者的 Microsoft Entra SSO

若要設定及測試與 GitHub Enterprise 受控使用者搭配運作的 Microsoft Entra SSO，請執行下列步驟：

  1. 設定 Microsoft Entra SSO - 在 Microsoft Entra 租使用者中啟用 SAML 單一登入。
  2. 設定 GitHub Enterprise 受控使用者 SSO - 在 GitHub Enterprise 中設定單一登入設定。

設定 Microsoft Entra SSO

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

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

  2. 流覽至 [ 身分 > 識別應用程式企業應用程式 >> ][GitHub Enterprise 受控使用者 > 單一登入]。

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

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

    Edit Basic SAML Configuration

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

    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 簽署憑證 ] 區段中，尋找 [憑證] [Base64] ，然後選取 [下載 ] 以下載憑證並儲存在電腦上。

    The Certificate download link

  8. 在 [ 設定 GitHub Enterprise 受控使用者 ] 區段上，複製下方的 URL，並將其儲存在下方以設定 GitHub。

    Copy configuration URLs

指派 Microsoft Entra 測試使用者

在本節中，您會將您的帳戶指派給 GitHub Enterprise 受控使用者，以完成 SSO 設定。

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

設定 GitHub Enterprise 受控使用者 SSO

若要在 GitHub Enterprise 受控使用者 端設定 單一登入，您需要下列專案：

  1. 上述 Microsoft Entra Enterprise 受控使用者應用程式的 URL：登入 URL;Microsoft Entra Identifier;和登出 URL
  2. GitHub Enterprise 第一個系統管理員使用者的帳戶名稱和密碼。 認證是由 GitHub 解決方案工程連絡人的密碼重設電子郵件所提供。

啟用 GitHub Enterprise 受控使用者 SAML SSO

在本節中，您將取得上述 Microsoft Entra ID 所提供的資訊，並將其輸入到您的企業設定中，以啟用 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 的帳戶能夠登入您的企業版。 請遵循下列檔中關於布建的指示，以布建 SSO 所支援的帳戶。

下一步

GitHub Enterprise 受控使用者 需要 透過自動使用者布建建立所有帳戶，您可以在這裡 找到有關如何設定自動使用者布建的詳細資訊 。