자습서: GitHub Enterprise 서버와 Microsoft Entra SSO 통합

  • 아티클

이 자습서에서는 GitHub Enterprise 서버를 Microsoft Entra ID와 통합하는 방법을 알아봅니다. GitHub Enterprise 서버를 Microsoft Entra ID와 통합하면 다음을 수행할 수 있습니다.

  • GitHub Enterprise 서버에 액세스할 수 있는 Microsoft Entra ID를 제어합니다.
  • 사용자가 Microsoft Entra 계정을 사용하여 GitHub Enterprise 서버에 자동으로 로그인되도록 할 수 있습니다.
  • 하나의 중앙 위치에서 계정을 관리합니다.

필수 조건

시작하려면 다음 항목이 필요합니다.

  • Microsoft Entra 구독. 구독이 없는 경우 무료 계정을 얻을 수 있습니다.
  • GitHub Enterprise 서버, 초기화 준비 완료.
  • 클라우드 애플리케이션 관리자와 함께 애플리케이션 관리자는 Microsoft Entra ID에서 애플리케이션을 추가하거나 관리할 수도 있습니다. 자세한 정보는 Azure 기본 제공 역할을 참조하세요.

시나리오 설명

이 자습서에서는 테스트 환경에서 Microsoft Entra SSO를 구성하고 테스트합니다.

  • GitHub Enterprise 서버에서 SP 및 IDP 시작 SSO를 지원합니다.
  • GitHub Enterprise 서버에서 Just In Time 사용자 프로비저닝을 지원합니다.
  • GitHub Enterprise 서버에서 자동 사용자 프로비저닝을 지원합니다.

GitHub Enterprise 서버를 Microsoft Entra ID에 통합하도록 구성하려면 갤러리의 GitHub Enterprise 서버를 관리 SaaS 앱 목록에 추가해야 합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
  3. 갤러리에서 추가 섹션의 검색 상자에서 GitHub Enterprise 서버를 입력합니다.
  4. 결과 패널에서 GitHub Enterprise 서버를 선택한 다음 앱을 추가합니다. 앱이 테넌트에 추가될 때까지 잠시 동안 기다려 주세요.

또는 Enterprise App Configuration 마법사를 사용할 수도 있습니다. 이 마법사에서는 테넌트에 애플리케이션을 추가하고, 앱에 사용자/그룹을 추가하고, 역할을 할당하고, SSO 구성을 연습할 수 있습니다. Microsoft 365 마법사에 대한 자세한 정보

GitHub Enterprise 서버에 대한 Microsoft Entra SSO 구성 및 테스트

B.Simon이라는 테스트 사용자를 사용하여 GitHub Enterprise 서버에서 Microsoft Entra SSO를 구성하고 테스트합니다. SSO가 작동하려면 Microsoft Entra 사용자와 GitHub Enterprise 서버의 관련 사용자 간의 연결 관계를 설정해야 합니다.

GitHub Enterprise 서버에서 Microsoft Entra SSO를 구성하고 테스트하려면 다음 단계를 수행합니다.

  1. Microsoft Entra SSO 구성 - 사용자가 이 기능을 사용할 수 있도록 합니다.
    1. Microsoft Entra 테스트 사용자 만들기 - B.Simon을 사용하여 Microsoft Entra Single Sign-On을 테스트합니다.
    2. Microsoft Entra 테스트 사용자 할당 - B.Simon이 Microsoft Entra Single Sign-On을 사용할 수 있도록 합니다.
  2. GitHub Enterprise 서버 SSO 구성 - 애플리케이션 쪽에서 Single Sign-On 설정을 구성합니다.
    1. GitHub Enterprise 서버 테스트 사용자 만들기 - B.Simon의 Microsoft Entra 표현과 연결된 해당 사용자를 GitHub Enterprise 서버에 만듭니다.
  3. SSO 테스트 - 구성이 작동하는지 여부를 확인합니다.

Microsoft Entra SSO 구성

다음 단계에 따라 Microsoft Entra SSO를 사용하도록 설정합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.

  2. ID>애플리케이션>엔터프라이즈 애플리케이션>GitHub Enterprise 서버>Single sign-on으로 이동합니다.

  3. Single Sign-On 방법 선택 페이지에서 SAML을 선택합니다.

  4. SAML로 Single Sign-On 설정 페이지에서 기본 SAML 구성에 대한 연필 아이콘을 클릭하여 설정을 편집합니다.

    Screenshot shows to edit Basic S A M L Configuration.

  5. IDP 시작 모드에서 애플리케이션을 구성하려면 기본 SAML 구성 섹션에서 다음 단계를 수행합니다.

    a. 식별자(엔터티 ID) 텍스트 상자에서 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME> 패턴을 사용하는 URL을 입력합니다.

    b. 회신 URL 텍스트 상자에서 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume 패턴을 사용하여 URL을 입력합니다.

  6. SP 시작 모드에서 애플리케이션을 구성하려면 추가 URL 설정을 클릭하고 다음 단계를 수행합니다.

    로그온 URL 텍스트 상자에서 https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso 패턴을 사용하는 URL을 입력합니다.

    참고 항목

    이러한 값은 실제 값이 아닙니다. 해당 값을 실제 식별자, 회신 URL 및 로그온 URL로 업데이트합니다. 이러한 값을 얻으려면 GitHub Enterprise 서버 클라이언트 지원 팀에 문의하세요. 기본 SAML 구성 섹션에 표시된 패턴을 참조할 수도 있습니다.

  7. GitHub Enterprise 서버 애플리케이션에는 특정 형식의 SAML 어설션이 필요하므로, SAML 토큰 특성 구성에 사용자 지정 특성 매핑을 추가해야 합니다. 다음 스크린샷에서는 기본 특성의 목록을 보여 줍니다.

    Screenshot shows the image of Enterprise Server application.

  8. 사용자 특성 및 클레임을 편집 합니다.

  9. 새 클레임 추가를 클릭하고 텍스트 상자에 administrator로 이름을 입력합니다(administrator 값은 대/소문자를 구분함).

  10. 클레임 조건을 확장하고 사용자 유형에서 멤버를 선택합니다.

  11. 그룹 선택을 클릭하고 이 클레임을 포함할 그룹을 검색합니다. 여기에서 멤버는 GHES의 관리자여야 합니다.

  12. 원본에 대한 특성을 선택하고 값에 true(따옴표 없이)를 입력합니다.

  13. 저장을 클릭합니다.

    Screenshot shows to manage claim for attributes.

    참고 항목

    클레임을 추가하는 방법에 대한 지침을 확인하려면 링크를 클릭하세요.

  14. SAML로 Single Sign-On 설정 페이지의 SAML 서명 인증서 섹션에서 인증서(Base64)를 찾은 후 다운로드를 선택하여 인증서를 다운로드하고 컴퓨터에 저장합니다.

    Screenshot shows the Certificate download link.

  15. GitHub Enterprise 서버 설정 섹션에서 요구 사항에 따라 적절한 URL을 복사합니다.

    Screenshot shows to copy appropriate configuration U R L.

Microsoft Entra 테스트 사용자 만들기

이 섹션에서는 B.Simon이라는 사용자를 만듭니다.

  1. 최소한 사용자 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>사용자>모든 사용자로 이동합니다.
  3. 화면 위쪽에서 새 사용자>새 사용자 만들기를 선택합니다.
  4. 사용자 속성에서 다음 단계를 수행합니다.
    1. 표시 이름 필드에서 B.Simon을 입력합니다.
    2. 사용자 계정 이름 필드에서 username@companydomain.extension을 입력합니다. 예: B.Simon@contoso.com.
    3. 암호 표시 확인란을 선택한 다음, 암호 상자에 표시된 값을 적어둡니다.
    4. 검토 + 만들기를 선택합니다.
  5. 만들기를 선택합니다.

Microsoft Entra 테스트 사용자 할당

이 섹션에서는 B.Simon에게 GitHub Enterprise 서버에 대한 액세스 권한을 부여하여 해당 사용자가 Single Sign-On을 사용하도록 설정합니다.

  1. 최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
  2. ID>애플리케이션>엔터프라이즈 애플리케이션>GitHub Enterprise 서버로 이동합니다.
  3. 앱의 개요 페이지에서 사용자 및 그룹을 선택합니다.
  4. 사용자/그룹 추가를 선택한 다음, 할당 추가 대화 상자에서 사용자 및 그룹을 선택합니다.
    1. 사용자 및 그룹 대화 상자의 사용자 목록에서 B.Simon을 선택한 다음, 화면 아래쪽에서 선택 단추를 클릭합니다.
    2. 사용자에게 역할을 할당할 것으로 예상되는 경우 역할 선택 드롭다운에서 선택할 수 있습니다. 이 앱에 대한 역할이 설정되지 않은 경우 "기본 액세스" 역할이 선택된 것으로 표시됩니다.
    3. 할당 추가 대화 상자에서 할당 단추를 클릭합니다.

GitHub Enterprise 서버 SSO 구성

GitHub Enterprise 서버 쪽에서 SSO를 구성하려면 여기에 설명된 지침을 따라야 합니다.

GitHub Enterprise 서버 테스트 사용자 만들기

이 섹션에서는 GitHub Enterprise 서버에서 B.Simon이라는 사용자를 만듭니다. GitHub Enterprise 서버는 Just-In-Time 사용자 프로비저닝을 지원하며 기본적으로 사용하도록 설정됩니다. 이 섹션에 작업 항목이 없습니다. GitHub Enterprise 서버에 사용자가 아직 없는 경우 인증 후에 새 사용자가 만들어집니다.

또한 GitHub Enterprise 서버는 자동 사용자 프로비저닝을 지원합니다. 자동 사용자 프로비저닝을 구성하는 방법에 대한 자세한 내용은 여기서 확인할 수 있습니다.

SSO 테스트

이 섹션에서는 다음 옵션을 사용하여 Microsoft Entra Single Sign-On 구성을 테스트합니다.

SP 시작:

  • 이 애플리케이션 테스트를 클릭하면 로그인 흐름을 시작할 수 있는 GitHub Enterprise 서버 로그온 URL로 리디렉션됩니다.

  • GitHub Enterprise 서버 로그온 URL로 직접 이동하여 해당 위치에서 로그인 흐름을 시작합니다.

IDP 시작:

  • 이 애플리케이션 테스트를 클릭하면 SSO를 설정한 GitHub Enterprise 서버에 자동으로 로그인됩니다.

Microsoft 내 앱을 사용하여 모든 모드에서 애플리케이션을 테스트할 수도 있습니다. 내 앱에서 GitHub Enterprise 서버 타일을 클릭하면 SP 모드로 구성된 경우 로그인 흐름을 시작하기 위해 애플리케이션 로그온 페이지로 리디렉션되고, IDP 모드로 구성된 경우 SSO를 설정한 GitHub Enterprise 서버에 자동으로 로그인됩니다. 자세한 내용은 Microsoft Entra 내 앱을 참조하세요.

다음 단계