사전 확인 사항

Github Enterprise Cloud의 User API를 통합하려면 아래 사항이 필요합니다.

- Github Enterprise Cloud의 조직에 속해있는 사용자 계정이 필요합니다.

개요

Github Enterprise Cloud의 User API를 통합하면, PoPs에서 Github Enterprise Cloud의 조직별 사용자 정보들을 확인할 수 있습니다.

- Github Enterprise Cloud 사용자의 로그인 ID

- Github Enterprise Cloud 사용자의 프로필 이미지

GitHub Enterprise Cloud 앱 인스턴스에 User API 통합하기

1. Megazone PoPs 워크스페이스 관리 콘솔에 관리자 계정으로 로그인합니다.
   
   
2. Github Enterprise Cloud 앱 인스턴스 상세 페이지에서 [통합] 탭으로 이동하여 사용자 통합의 [연결하기] 버튼을 클릭합니다.
   
   
3. 기존에 통합된 정보가 없다면 [새 통합 및 연결]을 클릭합니다.
   
   
   
4. API 통합 페이지에서 API 인증 정보 및 추가 정보를 입력합니다.
   
   
   [Bearer Token]과 [organizationName]은 다음과 같은 방법으로 확인하여 입력합니다.
   1. Github Enterprise Cloud 계정에 로그인합니다.
   2. 오른쪽 상단의 프로필 아이콘을 클릭하고, [Settings]를 선택하여 설정 페이지로 이동합니다.
   
   3. 왼쪽 사이드바에서 [Developer settings]를 클릭합니다.
   4. Developer settings 페이지에서 [Personal access tokens]의 [Fine-grained tokens] 또는 [Tokens (classic)]을 선택한 후, [Generate new token] 을 클릭하여 토큰을 생성합니다.
   토큰 생성 시,
   - Fine-grained tokens 인 경우, “Members” organization permissions (read)  권한 설정이 필요합니다.
   - Tokens (classic) 인 경우, read:org 권한 설정이 필요합니다.
   
   4. 생성한 토큰을 복사하여  [Bearer Token]에 입력합니다.
   
   [organizaionName]은 다음과 같이 확인합니다.
   1. GitHub 웹사이트에서 조직 URL을 통해 확인하여 복사 후 [organizationName]을 입력합니다.
       (ex. https://github.com/{organizationName})
   
   
   
   
   
5. API를 사용하기 위한 권한이 충분히 부여되어 있으면 연결 테스트 통과 다이얼로그가 노출됩니다.
   
   ※ 만약 통합에 실패하면 아래 사항을 확인한 뒤 다시 시도해주세요.
   - API 통합 시 요구하는 정보를 정확히 입력했는지
   - API 통합 시 인증한 토큰에 충분한 권한이 부여되어 있는지
6. API 통합이 완료되면, Github Enterprise Cloud 앱 인스턴스 내 [사용자] 탭에서 Github Enterprise Cloud 조직 사용자 정보를 확인할 수 있습니다.