사전 확인 사항

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

- Atlassian Cloud 관리자 계정이 필요합니다.

- Atlassian Cloud 조직에서 Atlassian Access를 구독중이어야 합니다.

- Atlassian Cloud에서 사용할 도메인 인증이 필요합니다.

개요

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

- Atlassian Cloud 사용자의 이름

- Atlassian Cloud 사용자의 이메일

- Atlassian Cloud 사용자의 상태

Atlassian Cloud에서 SCIM API를 사용하기 위한 도메인 인증하기

* Atlassian 콘솔에서 도메인 인증이 이미 되어 있다면 이 단계를 건너뛰어도 됩니다.

1. Atlassian으로 이동하여 관리자 계정으로 로그인합니다.
2. Atlassian Administration 콘솔 > Directory > Domains 메뉴로 이동하여 [Verify Domain]을 클릭합니다.
   
   
   
3. 사용할 도메인을 입력한 뒤 다시 [Verify domain]을 클릭합니다.
   
   
4. 도메인 목록에 도메인이 인증되지 않은 상태로 추가되면, TXT 레코드를 복사하여 해당 도메인에 추가한 뒤 도메인의 [Verify domain]을 클릭하여 인증을 완료합니다.
   

Atlassian Cloud 앱 인스턴스에 SCIM API 통합하기

1. Megazone PoPs 워크스페이스 관리 콘솔에 관리자 계정으로 로그인합니다.
   
   
2. Atlassian Cloud 앱 인스턴스 상세 페이지에서 [통합] 탭으로 이동하여 SCIM API의 [통합하기] 버튼을 클릭합니다.
   
   
   
3. API 사용 권한 인증 다이얼로그가 노출되면 API 인증 정보 및 추가 정보를 입력합니다.
   
   [Token]과 [directoryId]는 다음과 같은 방법으로 확인하여 입력합니다.
   1. Atlassian Admin으로 이동하여 관리자 계정으로 로그인합니다.
   2. [Security] > [Identity Provider] 메뉴로 이동합니다.
   3. 사용자 정보를 가져올 디렉터리를 선택합니다. 만약 아직 추가된 디렉터리가 없다면 디렉터리를 먼저 생성해야 합니다. 디렉터리를 선택하면 URL에서 [디렉터리 ID]를 확인할 수 있습니다. 각 디렉터리는 고유 ID, 특히 디렉터리의 기본 URL에서 'directory/' 뒤에 있는 디렉터리 ID로 구별됩니다. 예를 들어 디렉터리 기본 URL이 https://api.atlassian.com/scim/directory/abcdeg1234 인 경우, 디렉터리 ID는 abcdeg1234입니다.
   4. 디렉터리 내 [User Provisioning] 섹션 아래에 있는 점 3개 메뉴를 클릭한 뒤 [Regenerate API Key]를 선택합니다.
   
   6. [Regenerate Key]를 선택한 뒤 표시되는 값을 복사합니다.
   
   
4. Atlassian Cloud에서 복사한 [Directory ID]와 [Token]을 PoPs의 API 사용 권한 인증 다이얼로그에 입력한 뒤 [인증] 버튼을 클릭합니다.
   
   
5. API를 사용하기 위한 권한이 충분히 부여되어 있으면 인증 성공 토스트가 노출됩니다. 
   ※ 만약 통합에 실패하면 아래 사항을 확인한 뒤 다시 시도해주세요.
   - Atlassian 조직에서 Atlassian Access를 구독중인지
   - API 통합 시 요구하는 정보를 정확히 입력했는지
   
   
6. API 통합이 완료되면, Atlassian Cloud 앱 인스턴스 내 [사용자] 탭에서 Atlassian 사용자 정보를 확인할 수 있습니다.