안녕하세요. 오픈소스컨설팅에서 Atlassian 애드온 제품 개발 및 운영을 담당하고 있는 App-Biz팀의 윤보영 프로입니다.
조직관리자(Organization Administartor)과 Organization API Key에 대해 알아보았던 1편에 이어 Atlassian Cloud 관리자 유형 정복하기(2편) – 사이트 관리자와 API Token 용도 및 생성 방법에 대해 알아보겠습니다.
1편에 대한 부분은 첨부한 링크를 통해 확인 가능하십니다.
👉Atlassian Cloud 관리자 유형 정복하기 (1편) (with Flexible User License Cloud ) 보러 가기
사이트 관리자(Site Administrator)
사이트 관리자 역할과 필요성
사이트 관리자(Site Administrator)는 Atlassian Cloud 에서 특정 사이트를 관리할 수 있는 권한을 가집니다. 이 역할을 가진 관리자는 사이트 내에서 제품을 추가하거나 설치된 앱을 관리하는 작업을 수행할 수 있습니다.
1편을 보신 분들은 조직 관리자(Organization Admin)도 같은 작업을 할 수 있는데. 왜 사이트 관리자(Site Administrator)가 왜 따로 필요한지 의문을 가지실 겁니다. 그 이유는 조직 관리자(Organization Admin)가 사이트에 큰 영향을 끼칠 수 있는 너무나 많은 권한(제품 결재, 보안 설정 등)을 가졌기 때문입니다.
그래서 Atlassian에서는 조직 관리자(Organization Admin)의 역할을 사이트 관리자(Site Administrator), 사용자 접근 관리자(User Access Admin), 제품 관리자(Product admin) 등으로 세분화하여 각자의 역할에 필요한 권한만 부여받을 수 있도록 설계하였습니다.
예를 사이트 관리자는 Atlassian Administration에 접근하여 사이트와 관련된 다양한 작업을 수행할 수 있지만, 결제 관련 작업에 대한 접근은 제한적입니다. 또한, 사이트 관리자는 각 사용자의 제품 접근 권한을 직접 관리할 수 없습니다. 이를 관리하기 위해서 사용자 접근 관리자(User Access Admin) 역할이 필요합니다.
사이트 관리자 역할별 작업
아래의 표를 통해 각 관리자가 할 수 있는 작업에 대해 쉽게 알아볼 수 있습니다.
| Organization admin | Site admin | User access admin | Product admin | |
| 조직에 속한 사용자 계정 확인하기 | ✅ | ✅ | ✅ | ❌ |
| 사용자 접속 설정 변경(User Access Setting in Atlassian Guard) | ✅ | ❌ | ✅ | ❌ |
| 그룹을 생성하거나 수정하기 | ✅ | ❌ | ✅ 주의사항: User Access Admin은 그룹을 통해 사용자의 제품 접속 권한을 통제할 수 있습니다. | ❌ |
| 사용자를 그룹에 추가하거나 삭제하기 | ✅ | ❌ | ✅ 주의사항: User Access Admin은 자신이 관리자가 아닌 제품의 그룹에 사용자를 추가하거나 삭제할 수 없습니다. | ❌ |
| 각 제품(Product)의 기본 그룹 (default group) 설정하기 | ✅ | ❌ | ❌ | ❌ |
| 제품(Product) 설정하기 | ❌ | ❌ | ❌ | ✅ |
| 조직에 새로운 제품 추가하기 | ✅ | ✅ 주의사항: 자신이 관리자인 사이트에서만 가능합니다. | ❌ | ❌ |
| 제품에 Addon 추가 및 관리하기 | ✅ | ✅ 주의사항: 자신이 관리자인 사이트에서만 가능합니다. | ❌ | ❌ |
| 사이트의 보안 설정 (SSO, User Provisioning, two-step verification 등) | ✅ | ❌ | ❌ | ❌ |
이러한 방식으로 각 관리자들에게 필요한 역할만 부여하여, 사이트를 안정적으로 운영할 수 있도록 지원합니다.
더욱 자세한 사항은 아래의 Atlassian 공식 문서를 참고해주세요.
API Token
이제 API Token의 용도와 생성 방법에 대해 알아보겠습니다.
API Token은 Atlassian에서 제공하는 인증 방식입니다.
API 토큰을 사용하면 사용자 이름과 비밀번호 대신 안전하게 Atlassian API 에 접근하여 다양한 작업을 수행할 수 있습니다. 해당 기능을 이용하여 보통 자동화를 위한 작업이나 타사 애플리케이션 과의 연동에 사용됩니다.
자사 사용자 관리 애드온인 Flexible User License도 위의 이유로 API Token을 설정합니다.
API 호출 시 Basic Auth 방식으로, 사용자 이메일 주소를 사용자 이름으로, 생성된 API 토큰을 비밀번호로 사용해야 합니다.
API Token 발급 방법은 아래와 같습니다.
- 자신의 계정 관리 페이지로 이동 (https://id.atlassian.com/manage-profile/profile-and-visibility)
- 보안 탭으로 이동 -> “API 토큰 만들기 및 관리” 버튼 클릭
- “API 토큰 만들기” 버튼 클릭
위의 과정을 통해 API Token을 생성할 수 있습니다. 해당 API Token을 통해 Atlassian에서 제공하는 여러가지 Product API를 호출하여 여러가지 자동화 작업을 수행할 수 있습니다. 다만 API Token을 발행한 사용자가 가진 권한을 벗어나는 API는 호출할 수 없습니다. 이 점을 체크하면서 작업해주셔야 합니다.
관련 사항들은 아래의 링크를 참고해주세요.
📌Jira Cloud API Document
📌Atlassian Developer Site
마무리
이상으로 사이트 관리자(Site Administartor)의 역할과 권한, API Token 의 용도와 생성 방법에 대해 알아보았습니다. 긴 내용 읽어 주셔서 감사합니다.
Atlassian Cloud 제품의 라이선스를 효율적으로 관리하기 위한 Atlassian 애드온 앱(Addon App)인
Flexible User Licesne 에 관심이 있으시다면 하단의 Atlassian Marketplace 링크를 통해 한달 무료체험을 추천드립니다. >>>>Go to the Atlassian Marketplace
