다음을 통해 공유

GitHub Enterprise Cloud - Enterprise Account와 Microsoft Entra SSO 통합

  • 아티클

이 자습서에서는 GitHub Enterprise Cloud - Enterprise 계정과 Microsoft Entra SAML 통합을 설정하는 방법을 알아봅니다. GitHub Enterprise Cloud - Enterprise Account를 Microsoft Entra ID와 통합하면 다음을 수행할 수 있습니다.

  • GitHub Enterprise 계정 및 엔터프라이즈 계정 내의 모든 조직에 대한 액세스 권한이 있는 사용자를 Microsoft Entra ID에서 제어합니다.

필수 구성 요소

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

  • Microsoft Entra 구독입니다. 구독이 없는 경우 체험 계정얻을 수 있습니다.
  • GitHub Enterprise 계정.
  • 엔터프라이즈 계정 소유자인 GitHub 사용자 계정입니다.

시나리오 설명

이 자습서에서는 GitHub Enterprise 계정에 대한 SAML 통합을 구성하고 엔터프라이즈 계정 소유자 및 엔터프라이즈/조직 구성원 인증 및 액세스를 테스트합니다.

메모

GitHub Enterprise Cloud - Enterprise Account 애플리케이션은 자동 SCIM 프로비저닝 사용하도록 설정할 수 없습니다. GitHub Enterprise Cloud 환경에 대한 프로비저닝을 설정해야 하는 경우 SAML을 조직 수준에서 구성해야 하며 GitHub Enterprise Cloud - Organization Microsoft Entra 애플리케이션을 대신 사용해야 합니다. EMU(Enterprise Managed Users)사용하도록 설정된 엔터프라이즈에 대한 SAML 및 SCIM 프로비저닝 통합을 설정하는 경우 SAML/프로비저닝 통합에 GitHub Enterprise Managed User Microsoft Entra 애플리케이션 또는 OIDC/프로비저닝 통합을 위한 GitHub Enterprise Managed User (OIDC) Microsoft Entra 애플리케이션을 사용해야 합니다.

  • GitHub Enterprise Cloud - Enterprise Account는 SP 및 IDP가 시작한 SSO를 지원합니다.

갤러리에서 GitHub Enterprise Cloud - Enterprise 계정 추가

GitHub Enterprise Cloud - Enterprise 계정의 Microsoft Entra ID 통합을 구성하려면 갤러리의 GitHub Enterprise Cloud - Enterprise 계정을 관리되는 SaaS 앱 목록에 추가해야 합니다.

  1. Microsoft Entra 관리 센터에 적어도 클라우드 애플리케이션 관리자권한으로 로그인합니다.
  2. ID>애플리케이션>엔터프라이즈 애플리케이션>새 애플리케이션으로 이동합니다.
  3. 갤러리에서 추가 섹션의 검색 상자에 GitHub Enterprise Cloud - 엔터프라이즈 계정을 입력합니다.
  4. 결과 패널에서 GitHub Enterprise Cloud - Enterprise Account 선택한 다음, 앱을 추가합니다. 앱이 테넌트에 추가되는 동안 몇 초 정도 기다립니다.

또는 Enterprise 앱 구성 마법사사용할 수도 있습니다. 이 마법사에서는 테넌트에 애플리케이션을 추가하고, 앱에 사용자/그룹을 추가하고, 역할을 할당하고, SSO 구성을 안내할 수 있습니다. Microsoft 365 마법사에 대해 자세히 알아보세요.

GitHub Enterprise Cloud - Enterprise 계정에 대한 Microsoft Entra SSO 구성 및 테스트

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

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

  1. 사용자가 이 기능을 사용할 수 있도록 Microsoft Entra SSO 구성합니다.
    1. Microsoft Entra 테스트 사용자 만들기 - B.Simon에서 Microsoft Entra Single Sign-On을 테스트합니다.
    2. Microsoft Entra 사용자 및 테스트 사용자 계정을 GitHub 앱 할당하여 사용자 계정 및 테스트 사용자 B.Simon Microsoft Entra Single Sign-On을 사용할 수 있도록 합니다.
  2. 엔터프라이즈 계정 및 해당 조직에 대해 SAML을 사용하도록 설정하고 테스트하는 - 애플리케이션 쪽에서 Single Sign-On 설정을 구성합니다.
    1. 다른 엔터프라이즈 계정 소유자 또는 조직 구성원 계정 SSO를 테스트하여 구성이 작동하는지 확인합니다.

Microsoft Entra SSO 구성

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

  1. Microsoft Entra 관리 센터에 적어도 클라우드 애플리케이션 관리자로서 로그인합니다.

  2. Identity>애플리케이션>엔터프라이즈 애플리케이션>GitHub Enterprise Cloud - Enterprise Account>싱글 사인온으로 이동하세요.

  3. Single Sign-On 메서드 페이지에서 SAML선택합니다.

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

    기본 SAML 구성 편집

  5. 기본 SAML 구성 섹션에서 다음 단계를 수행합니다.

    a. 식별자(엔터티 ID) 텍스트 상자에 다음 패턴을 사용하여 URL을 입력합니다. https://github.com/enterprises/<ENTERPRISE-SLUG>

    b. 회신 URL 텍스트 상자에 다음 패턴을 사용하여 URL을 입력합니다. https://github.com/enterprises/<ENTERPRISE-SLUG>/saml/consume

  6. SP 시작 모드에서 애플리케이션을 구성하려면 다음 단계를 수행합니다.

    로그온 URL 텍스트 상자에 다음 패턴을 사용하여 URL을 입력합니다. https://github.com/enterprises/<ENTERPRISE-SLUG>/sso

    메모

    <ENTERPRISE-SLUG>를 GitHub Enterprise 계정의 실제 이름으로 바꿉니다.

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

    인증서 다운로드 링크

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

    구성 URL 복사

Microsoft Entra 테스트 사용자 만들기

이 섹션에서는 Azure Portal에서 B.Simon이라는 테스트 사용자를 만듭니다.

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

GitHub 앱에 Microsoft Entra 사용자 및 테스트 사용자 계정 할당

이 섹션에서는 B.Simon 및 사용자 계정이 Azure Single Sign-On을 사용할 수 있도록 GitHub Enterprise Cloud - Enterprise 계정에 대한 액세스 권한을 부여합니다.

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

엔터프라이즈 계정 및 해당 조직에 SAML 사용 및 테스트

GitHub Enterprise Cloud - Enterprise Account 쪽에서 Single Sign-On을 구성하려면 이 GitHub 설명서 나열된 단계를 수행합니다.

  1. 엔터프라이즈 계정 소유자인 사용자 계정으로 GitHub.com에 로그인하세요.
  2. 앱의 Login URL 필드에서 값을 복사하여 GitHub Enterprise 계정 SAML 설정의 Sign on URL 필드에 붙여넣습니다.
  3. 앱의 Azure AD Identifier 필드에서 값을 복사하여 GitHub Enterprise 계정 SAML 설정의 Issuer 필드에 붙여넣습니다.
  4. Azure Portal에서 위의 단계에서 다운로드한 인증서(Base64) 파일의 내용을 복사하여 GitHub Enterprise 계정 SAML 설정의 적절한 필드에 붙여넣습니다.
  5. Test SAML configuration 클릭하고 GitHub Enterprise 계정에서 Microsoft Entra ID로 인증할 수 있는지 확인합니다.
  6. 테스트가 성공하면 설정을 저장합니다.
  7. GitHub 엔터프라이즈 계정에서 SAML을 통해 처음 인증하게 되면, GitHub 사용자 계정을 Microsoft Entra 사용자 계정과 연결하는 외부 ID 이(가)로 GitHub 엔터프라이즈 계정에 생성됩니다.

GitHub Enterprise 계정에 SAML SSO를 사용하도록 설정하면 엔터프라이즈 계정이 소유한 모든 조직에 대해 SAML SSO가 기본적으로 사용하도록 설정됩니다. 모든 구성원은 SAML SSO를 사용하여 인증하여 구성원이 있는 조직에 액세스해야 하며 엔터프라이즈 소유자는 엔터프라이즈 계정에 액세스할 때 SAML SSO를 사용하여 인증해야 합니다.

다른 엔터프라이즈 계정 소유자 또는 조직 구성원 계정으로 SSO 테스트

GitHub 엔터프라이즈 계정(엔터프라이즈 계정의 GitHub 조직에도 적용됨)에 대해 SAML 통합이 설정되면 Microsoft Entra ID의 앱에 할당된 다른 엔터프라이즈 계정 소유자는 GitHub 엔터프라이즈 계정 URL(https://github.com/enterprises/<enterprise account>)로 이동하여 SAML을 통해 인증하고 GitHub 엔터프라이즈 계정의 정책 및 설정에 액세스할 수 있어야 합니다.

엔터프라이즈 계정의 조직의 조직 소유자는 사용자가 GitHub 조직 참가하도록초대할 수 있어야 합니다. 조직 소유자 계정으로 GitHub.com 로그인하고 문서의 단계에 따라 조직에 B.Simon 초대합니다. 아직 없는 경우 B.Simon 위해 GitHub 사용자 계정을 만들어야 합니다.

B.Simon 테스트 사용자 계정으로 엔터프라이즈 계정에서 GitHub 조직 액세스를 테스트하려면 다음을 수행합니다.

  1. 엔터프라이즈 계정의 조직에 B.Simon 조직 소유자로 초대합니다.
  2. B.Simon Microsoft Entra 사용자 계정에 연결하려는 사용자 계정을 사용하여 GitHub.com 로그인합니다.
  3. B.Simon 사용자 계정을 사용하여 Microsoft Entra ID에 로그인합니다.
  4. GitHub 조직으로 이동합니다. SAML을 통해 인증하라는 메시지가 사용자에게 표시됩니다. SAML 인증에 성공하면 B.Simon 조직 리소스에 액세스할 수 있어야 합니다.

다음 단계

GitHub Enterprise Cloud - Enterprise 계정이 구성되면 세션 제어를 적용하여 조직의 중요한 데이터의 반출 및 반입을 실시간으로 보호할 수 있습니다. 세션 제어는 조건부 액세스에서 확장됩니다. Microsoft Defender for Cloud Apps세션 제어를 적용하는 방법을 알아봅니다.