사전 확인 사항

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

- GitHub Enterprise Cloud 플랜을 이용 중이어야 합니다.

- Github Enterprise Cloud 조직에 SAML SSO 설정이 되어야 합니다. GitHub Enterprise Cloud에서 SAML SSO를 설정하는 방법은 다음 가이드를 참고해주세요. Configuring SAML single sign-on for your enterprise

개요

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

- GitHub Enterprise Cloud 사용자의 이름

- GitHub Enterprise Cloud 사용자의 이메일

- GitHub Enterprise Cloud 사용자의 상태

- GitHub Enterprise Cloud 사용자의 역할

또한 아래와 같은 기능을 사용할 수 있습니다.

- 사용자 프로비저닝

사용자 프로비저닝 기능에 대한 자세한 안내는 다음 가이드를 참고해주세요.

사용자 프로비저닝이란?

GitHub Cloud SCIM API 통합하기

1. Megazone PoPs 워크스페이스 관리 콘솔에 관리자 계정으로 로그인합니다.
   
   
2. 좌측 메뉴에서 [통합] 메뉴를 클릭합니다.
   
   
   
3. 통합 메뉴에서 [통합하기] 버튼을 클릭하여 커넥터 목록으로 이동합니다.
   
   
   
4. 커넥터 목록에서 [GitHub Cloud SCIM API]를 선택합니다.
   
   
   
5. GitHub Cloud SCIM API 통합 페이지에서 API 인증 정보 및 추가 정보를 입력합니다.
   
   [Bearer Token]과 [enterpriseName]은 다음과 같은 방법으로 확인하여 입력합니다.
   
   1. GitHub Enterprise Cloud에 관리자 계정으로 로그인합니다.
   
   2. Enterprise 이름을 확인하기 위하여, 우측 상단의 프로필 이미지를 클릭한 뒤 [Your enterprise]메뉴를 선택합니다.
   
   
   3. 브라우저에 표시되는 URL에서 [Enterprise 이름]을 확인합니다. 예를 들어, URL이 https://github.com/enterprises/sample인 경우, Enterprise 이름은 sample입니다.
   
   3. 좌측 메뉴 아래의 [Developer settings]를 클릭합니다.
   
   4. [Personal access tokens] 메뉴에서 발급받은 토큰을 복사합니다. (토큰에 필요한 scope: admin:enterprise)
   
   5. GitHub Enterprise Cloud에서 확인한 정보를 PoPs의 각각 아래와 같이 입력한 뒤 [다음] 버튼을 클릭합니다.
   - [Bearer Token]: GitHub Enterprise Cloud에서 복사한 Token
   - [enterpriseName]: GitHub Enterprise Cloud에서 확인한 Enterprise 이름
   
   
6. [다음]을 클릭하면 통합이 완료되며, 통합 완료 페이지가 노출됩니다.
   ※ 만약 통합에 실패하면 아래 사항을 확인한 뒤 다시 시도해주세요.
   - GitHub 환경이 API를 사용하기 위한 Plan 조건을 만족하는지
   - API 통합 시 요구하는 정보를 정확히 입력했는지
   

통합한 GitHub Cloud SCIM API 인증 정보를 앱 인스턴스에 연결하기

1.  GitHub Cloud SCIM API의 통합 상세 페이지로 이동하기 위해, 좌측 메뉴에서 [통합] 메뉴를 클릭합니다.
   
   
2. 통합된 서비스 목록에서 [GitHub Cloud SCIM API]를 선택하여 통합 상세페이지로 이동합니다.
   
   
   
3. GitHub Cloud SCIM API 통합 상세 페이지에서 [앱 인스턴스]를 클릭합니다.
   
   
   
4. [앱 인스턴스 연결] 버튼을 클릭한 뒤, 원하는 옵션을 선택하여 연결을 진행합니다.
   
   
   - [기존 앱 인스턴스 선택]: 기존에 생성한 GitHub Cloud 앱 인스턴스가 이미 존재하고, 해당 앱 인스턴스에서 GitHub Cloud SCIM API를 사용하고 싶은 경우 선택합니다.
   
   - [새 앱 인스턴스 등록]: 새로운 GitHub Cloud 앱 인스턴스에서 GitHub Cloud SCIM API를 사용하고 싶은 경우 선택합니다.
   
   
5. 통합 정보가 앱 인스턴스에 연결되면, 앱 인스턴스 상세에서도 통합 정보를 확인할 수 있습니다.