Entra ID를 사용한 인증 및 프로비저닝 구성

Microsoft Entra ID(이전에는 Azure AD라고 함)의 테넌트를 ID 공급자(IdP)로 사용하여 GitHub Enterprise Server 인스턴스 대한 인증 및 사용자 프로비저닝을 중앙에서 관리할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

Site administrators with admin access to the IdP

이 기사에서

Entra ID를 사용한 인증 및 사용자 프로비저닝 정보

Entra ID는 사용자 계정을 중앙에서 관리하고 웹 애플리케이션에 액세스할 수 있는 Microsoft의 서비스입니다. 자세한 내용은 Microsoft Docs의 Microsoft Entra ID란 무엇인가?를 참조하세요.

GitHub Enterprise Server의 IAM용 ID 공급자를 사용하면 SAML SSO는 리포지토리, 문제, 끌어오기 요청과 같은 엔터프라이즈 리소스에 대한 액세스를 제어하고 보호합니다. SCIM은 ID 공급자를 변경할 때 자동으로 사용자 계정을 만들고 엔터프라이즈에 대한 액세스 권한을 관리합니다. GitHub의 팀을 ID 공급자의 그룹과 동기화할 수도 있습니다.

자세한 내용은 GitHub Enterprise Server에서 SCIM을 사용하여 사용자 프로비저닝 정보을(를) 참조하세요.

필수 조건

GitHub Enterprise Server에서 SCIM을 사용하는 데 필요한 일반적인 전제 조건이 적용됩니다. 사용자 관리를 위한 엔터프라이즈 관리 사용자 구성의 "필수 요구 사항" 섹션을 참조하세요.

추가:

  • SCIM을 구성하려면 AUTOTITLE에서 1~4단계를 완료해야 합니다.

    • 설치 사용자가 Entra ID 요청을 인증하려면 personal access token (classic) 만들어야 합니다.

  • Entra ID를 사용하여 인증 및 사용자 프로비전을 구성하려면 Entra ID 계정과 테넌트가 있어야 합니다. 자세한 내용은 Entra ID 웹 사이트 및 Quickstart: Microsoft Docs 테넌트 설정을 참조하세요.

1. SAML 구성

참고

이전에 Entra ID에서 SAML을 구성한 경우에도 SCIM 프로비저닝을 사용하도록 새 애플리케이션에서 SAML 및 SCIM을 구성해야 합니다.

이 섹션을 시작하기 전에 AUTOTITLE의 1단계와 2단계를 수행했는지 확인합니다.

엔트라 ID

  1. Entra ID에서 "GitHub Enterprise Server" 애플리케이션을 만듭니다. 지침은 Microsoft 가이드 자습서: GitHub Enterprise Server와 Microsoft Entra SSO 통합의 "갤러리에서 GitHub Enterprise Server 추가" 섹션을 참조하세요.

    참고

    "(레거시)"라는 레이블이 지정된 애플리케이션을 사용하지 마세요.

  2. "GitHub Enterprise Server" 애플리케이션 설정의 왼쪽 사이드바에서 Single Sign-On 을 클릭한 다음 SAML을 클릭합니다.

  3. "기본 SAML 구성" 섹션에서 편집을 클릭한 다음, 다음 세부 정보를 추가합니다.

    • "식별자": 회원님의 GitHub Enterprise Server 호스트 URL(https://HOSTNAME.com)
    • "회신 URL": /saml/consume 뒤의 호스트 URL (https://HOSTNAME.com/saml/consume)

  4. “SAML 인증서” 섹션에서 SAML 인증서(Base64)를 다운로드합니다.

  5. "GitHub Enterprise Server 설정" 섹션에서 로그인 URL 및 Microsoft Entra 식별자를 기록해 둡니다.

GitHub Enterprise Server에

  1. 관리 콘솔에 GitHub Enterprise Server 대한 액세스 권한이 있는 사용자로 로그인합니다.
  2. 수집한 정보를 사용하여 SAML을 구성합니다. 엔터프라이즈에 대한 SAML Single Sign-On 구성을(를) 참조하세요.

2. SCIM 구성

이 섹션을 시작하기 전에 AUTOTITLE의 1~4단계를 수행했는지 확인합니다.

  1. Entra ID의 "GitHub Enterprise Server" 애플리케이션에서 왼쪽 사이드바의 프로비저닝을 클릭한 다음 시작하기를 클릭합니다.

  2. 프로비전 모드에서 “자동”을 선택합니다.

  3. “관리자 자격 증명” 섹션에서 다음 세부 정보를 입력합니다.

    • "테넌트 URL": 사용자의 GitHub Enterprise Server 호스트 URL, 뒤에 /api/v3/scim/v2 (https://HOSTNAME.com/api/v3/scim/v2)
    • "비밀 토큰": personal access token (classic) 설치 사용자를 위해 만든 토큰

  4. 연결 테스트를 클릭합니다.

  5. 테스트가 완료되면 저장을 클릭합니다.

  6. "Overview" 페이지로 돌아갑니다.

  7. EntraID 사용자를 어플라이언스로 GitHub Enterprise Server 프로비전하려면 프로비저닝 시작을 클릭합니다.

SCIM 구성을 완료하면 구성 프로세스에 대해 사용하도록 설정한 일부 SAML 설정을 사용하지 않도록 설정할 수 있습니다. 사용자 관리를 위한 엔터프라이즈 관리 사용자 구성을(를) 참조하세요.