사전 확인 사항

GitHub Copilot의 License API를 통합하려면 아래 사항이 필요합니다.

- GitHub 조직의 Owner 권한이 부여된 계정

- GitHub 조직에 Megazone PoPs 앱을 설치할 수 있어야 합니다.

- GitHub 조직에서 GitHub Copilot의 Business 플랜 이상 구독중이어야 합니다.

개요

GitHub Copilot의 License API를 통합하면, PoPs에서 GitHub Copilot의 라이선스 정보들을 확인할 수 있습니다.

- GitHub Copilot에 대한 총 시트 수
- 현재 청구 주기에 추가된 GitHub Copilot 시트 수
- 대기중인 사용자에게 할당된 GitHub Copilot 시트 수
- 현재 청구 주기에 사용한 GitHub Copilot 시트 수
- 현재 청구 주기에 사용되지 않은 GitHub Copilot 시트 수
- 라이선스를 사용중인 사용자 목록
- 라이선스를 사용중인 사용자의 할당 타입 (사용자 또는 팀)
- 라이선스를 사용중인 사용자의 사이트 어드민 여부
- 라이선스가 사용자에게 할당된 일시
- 라이선스를 사용중인 사용자의 마지막 활동일시

API 통합의 범위를 '데이터 조회 및 관리'로 선택하면, 위 정보를 조회할 수 있을 뿐만 아니라, 아래와 같은 기능을 사용할 수 있습니다.

- Github Copilot 라이선스 할당

- Github Copilot 라이선스 회수

GitHub Copilot 앱 인스턴스에 License API 통합하기

1. Megazone PoPs 워크스페이스 관리 콘솔에 관리자 계정으로 로그인합니다.
   
   
2. 앱 인스턴스 상세 페이지에서 [통합] 탭으로 이동하여 License API의 [통합하기] 버튼을 클릭합니다.
   
   
   
3. API 통합 다이얼로그가 노출되면 API 인증 정보를 입력합니다.
   - 앱 설치 및 인증: GitHub 조직에 API 통합을 위한 Megazone PoPs 앱이 설치되어 있지 않은 경우, 해당 옵션을 선택합니다.
   - 인증: GitHub 조직에 API 통합을 위한 Megazone PoPs 앱이 이미 설치되어 있는 경우, 해당 옵션을 선택합니다.
   
   
   
4. API 통합 다이얼로그에서 추가 정보의 [org_name]은 GitHub Copliot에서 다음과 같은 방법으로 확인하여 입력합니다.
   1. GitHub Copilot에 관리자 계정으로 로그인
   2. GitHub 프로필 이미지를 클릭하면 노출되는 메뉴에서 [Your Organizations]를 클릭합니다.
   3. 조직 목록에 표시되는 조직 중, Megazone PoPs와 통합할 조직의 이름을 확인합니다.
   
   
   
5. API 통합 다이얼로그에서 모든 정보를 입력했으면 [다음] 버튼을 클릭합니다.
   
   
6. API 통합 다이얼로그에서 선택한 옵션에 따라 다음과 같이 진행됩니다.
   - '앱 설치 및 인증'을 선택한 경우: GitHub 조직에 Megazone PoPs 앱을 설치하기 위한 화면이 다이얼로그로 노출됩니다. 해당 다이얼로그에서 [Install]을 클릭하면, GitHub에서 제공하는 앱 설치 및 인증 화면으로 이동하고, 해당 화면에서 [Install & Authorize] 버튼을 클릭하여 앱 설치 및 인증을 진행합니다.
   
   
   
   - '인증'을 선택한 경우:  GitHub 조직의 관리자 계정으로 인증하기 위한 화면이 다이얼로그로 노출됩니다. GitHub에 관리자 계정으로 로그인한 뒤 노출되는 아래 화면에서 [Authorize Megazone PoPs] 버튼을 클릭하여 인증을 진행합니다.
   
   
   
7. GitHub Copilot API를 사용하기 위한 권한이 충분히 부여되어 있으면 API 통합 다이얼로그에서 '연결 테스트 통과'로 표시됩니다. 연결 테스트에 통과한 상태에서 [통합하기]를 클릭하면 API 통합이 완료됩니다.
   
   ※ 만약 [연결 테스트 실패]로 표시되면 아래 사항을 확인한 뒤 다시 시도해주세요.
   - GitHub 조직에 Megazone PoPs 앱이 설치되지 않은 경우
   - 인증한 GitHub 계정에 GitHub Owner 권한이 부여되지 않은 경우
   - GitHub 조직에서 구독 중인 GitHub Copilot의 플랜이 Business 플랜 이상이 아닌 경우
   
   
8. API 통합이 완료되면, GitHub Copilot 앱 인스턴스에 [라이선스] 탭이 새로 추가됩니다. 해당 탭에서 API를 통해 조회되는 라이선스 정보를 확인할 수 있습니다.