Skip to main content

GitHub Enterprise의 라이선스 사용량 문제 해결

라이선스 보고서를 감사하여 엔터프라이즈의 라이선스 사용량 문제를 해결할 수 있습니다.

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

Enterprise owners can review license usage for GitHub Enterprise.

예기치 않은 라이선스 사용량 정보

엔터프라이즈에 대해 사용된 라이선스 수가 예상과 다른 경우 사용된 라이선스 보고서를 검토하여 모든 엔터프라이즈 배포 및 구독의 라이선스 사용량을 감사할 수 있습니다. 자세한 정보는 "GitHub Enterprise의 라이선스 사용량 보기" 그리고 "엔터프라이즈 계정의 구독 및 사용량 보기"을 참조하세요.

오류가 발견되면 문제 해결 단계를 시도할 수 있습니다.

개인 정보 보호를 위해 엔터프라이즈 소유자는 Enterprise Managed Users를 사용하지 않는 한 사용자 계정의 세부 정보에 직접 액세스할 수 없습니다.

사용된 라이선스 계산 정보

참고: Visual Studio 구독자s의 경우 "GitHub Enterprise가 포함된 Visual Studio 구독 정보"을(를) 참조하세요.

사용자는 특정 조건에 따라 GitHub Enterprise에 대한 라이선스를 사용합니다. 사용자가 아직 Enterprise 가입 초대를 수락하지 않은 경우 사용자는 여전히 라이선스를 사용합니다. 라이선스를 사용하는 Enterprise 사용자에 대한 자세한 정보는 "사용자당 가격 책정 정보"를 참조하세요.

각 사용자가 사용하는 배포 수에 관계없이 단일 사용자를 사용하려면 GitHub Enterprise Server와 GitHub Enterprise Cloud 간에 라이선스 사용량을 동기화해야 합니다. 자세한 정보는 "GitHub Enterprise Server와 GitHub Enterprise Cloud 간의 라이선스 사용량 동기화"을(를) 참조하세요.

라이선스 사용량을 동기화한 후 GitHub는 메일 주소별로 GitHub Enterprise Server의 사용자 계정과 GitHub Enterprise Cloud의 사용자 계정을 일치시킵니다.

먼저 GitHub Enterprise Server에서 각 사용자의 기본 메일 주소를 확인합니다. 그런 다음 이 주소를 GitHub Enterprise Cloud의 사용자 계정 메일 주소와 일치시키려고 시도합니다. GitHub.com의 Enterprise 또는 Enterprise 조직에서 SAML 인증 또는 SCIM 프로비전을 사용하는 경우 먼저 연결된 SAML 또는 SCIM ID를 확인해 ID에 아래 특성 중 하나가 포함되어 있는지 확인합니다. 이러한 특성의 값을 각 GitHub Enterprise Server 사용자의 기본 메일 주소와 일치시키려고 합니다.

  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
  • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
  • username
  • NameID
  • emails

일치하는 항목이 없거나 SAML 인증 또는 SCIM 프로비전이 사용되지 않는 경우 GitHub Enterprise Server의 기본 메일 주소를 GitHub.com의 사용자 계정에 대해 확인된 이메일 주소와 일치시키려고 시도합니다. GitHub.com의 메일 주소 확인에 대한 자세한 정보는 GitHub Enterprise Cloud 설명서에서 "이메일 주소 확인""을 확인하세요.

사용된 라이선스 파일의 필드

GitHub.com 라이선스 사용량 보고서 및 GitHub Enterprise Server 내보낸 라이선스 사용량 파일에는 엔터프라이즈의 라이선스 사용량 문제를 해결하는 데 도움이 되는 다양한 필드가 포함되어 있습니다.

GitHub.com 라이선스 사용 현황 보고서(CSV 파일)

엔터프라이즈의 라이선스 사용량 보고서는 엔터프라이즈 멤버에 대한 다음 정보가 포함된 CSV 파일입니다. 일부 필드는 GitHub Enterprise Cloud(GHEC) 배포, GitHub Enterprise Server(GHES) 연결 환경 또는 GitHub Enterprise를 사용한 Visual Studio 구독(VSS)과 관련이 있습니다.

필드설명
github_com_login사용자의 GHEC 계정에 대한 사용자 이름
github_com_name사용자의 GHEC 계정에 대한 표시 이름
github_com_profileGHEC의 사용자 프로필 페이지에 대한 URL
github_com_user사용자가 GHEC에 계정이 있는지 여부
github_com_member_rolesGHEC에서 사용자가 속한 각 조직에 대해 조직 이름 및 해당 조직에서의 사용자 역할(Owner 또는 Member)(콜론으로 구분)입니다.

쉼표로 구분된 조직
github_com_enterprise_role다음 중 하나일 수 있습니다. Owner, Member, Outside collaborator(GitHub.com에 개인 계정이 있는 기업의 경우) 또는 Repository collaborator(GitHub.com에서 관리형 사용자 계정을(를) 사용하는 엔터프라이즈의 경우)
github_com_verified_domain_emails엔터프라이즈의 확인된 도메인과 일치하는 사용자의 GHEC 계정과 연결된 모든 메일 주소
github_com_saml_name_idSAML 사용자 이름
github_com_orgs_with_pending_invites엔터프라이즈 내 조직에 가입하기 위해 사용자의 GHEC 계정에 대해 보류 중인 모든 초대
github_com_advanced_security_license_user사용자가 GHEC에서 GitHub Advanced Security 라이선스를 사용하는지 여부
license_typeVisual Studio subscription 또는 Enterprise 중 하나일 수 있습니다.
enterprise_server_user사용자에게 GHES에 하나 이상의 계정이 있는지 여부
enterprise_server_primary_emails각 사용자의 GHES 계정과 연결된 기본 메일 주소
enterprise_server_user_ids각 사용자의 GHES 계정에 대한 계정의 사용자 ID
enterprise_server_advanced_security_user_ids사용자가 GitHub Advanced Security
total_user_accountsGHEC 및 GHES 모두에서 사용자가 가지고 있는 총 계정 수
visual_studio_subscription_user사용자가 인지 여부
visual_studio_subscription_email사용자의 VSS와 연결된 메일 주소
visual_studio_license_statusVisual Studio 라이선스가 GitHub 사용자와 일치했는지 여부

GitHub Enterprise Server 내보낸 라이선스 사용량(JSON 파일)

GitHub Enterprise Server 라이선스 사용량은 GitHub Enterprise Server와 GitHub Enterprise Cloud 배포 간에 사용자 라이선스의 수동 동기화를 수행할 때 일반적으로 사용되는 JSON 파일입니다. 파일에는 GitHub Enterprise Server 환경과 관련된 다음 정보가 포함되어 있습니다.

필드설명
기능GitHub Enterprise Server 인스턴스에서 사용하도록 설정된 GitHub Connect 기능 및 활성화 날짜와 시간입니다.
호스트 이름GitHub Enterprise Server 라이선스의 호스트 이름입니다.
HTTP만GitHub Enterprise Server 인스턴스에서 TLS(전송 계층 보안)를 사용하도록 설정하고 구성했는지 여부입니다. True 또는 False 중 하나일 수 있습니다.
라이선스GitHub Enterprise Server 라이선스의 해시입니다.
공개 키GitHub Enterprise Server 라이선스의 퍼블릭 키 부분입니다.
서버 IDGitHub Enterprise Server 인스턴스에 대해 생성된 UUID입니다.
버전GitHub Enterprise Server 인스턴스의 버전입니다.

사용된 라이선스 문제 해결

각 사용자가 서로 다른 배포 및 구독에 단일 사용자만 사용되도록 하려면 다음 문제 해결 단계를 수행합니다.

  1. 여러 개의 사용자 수를 사용 중인 사용자를 식별하려면 엔터프라이즈에서 GitHub Enterprise Cloud에 대해 확인된 도메인을 사용하는 경우 GitHub.com의 계정과 연결된 확인된 도메인의 메일 주소가 없는 엔터프라이즈 구성원 목록을 검토합니다. 종종 이러한 사용자는 둘 이상의 사용자 라이선스를 잘못 사용하는 사용자입니다. 자세한 정보는 "Enterprise에서 사용자 보기"을(를) 참조하세요.

    참고: 문제 해결을 쉽게 하려면 GitHub.com에서 엔터프라이즈 계정으로 확인된 도메인을 사용하는 것이 좋습니다. 자세한 정보는 "엔터프라이즈의 도메인 확인 또는 승인"을(를) 참조하세요.

  2. 여러 개의 사용자 수를 사용하는 사용자를 식별한 후 동일한 메일 주소가 사용자의 모든 계정과 연결되어 있는지 확인합니다. 일치해야 하는 메일 주소에 대한 자세한 내용은 “사용된 라이선스 계산 정보”를 참조하세요.

  3. 메일 주소가 최근에 업데이트되었거나 불일치 수정이 확인된 경우 마지막 라이선스 동기화 작업의 타임스탬프를 확인합니다. 수정한 이후 작업이 실행되지 않은 경우 새 작업을 수동으로 트리거합니다. 자세한 정보는 "GitHub Enterprise Server와 GitHub Enterprise Cloud 간의 라이선스 사용량 동기화"을(를) 참조하세요.

위의 문제 해결 정보를 검토한 후에도 사용된 라이선스에 대한 질문이 있는 경우 GitHub 지원 포털을 통해 GitHub 지원에 문의할 수 있습니다.