자습서: 자동 사용자 프로비전을 위한 Atlassian Cloud 구성
이 자습서에서는 자동 사용자 프로비저닝을 구성하기 위해 Atlassian Cloud 및 Microsoft Entra ID 모두에서 수행해야 하는 단계에 대해 설명합니다. 구성했으면 Microsoft Entra ID는 Microsoft Entra 프로비저닝 서비스를 사용하여 사용자 및 그룹을 Atlassian Cloud에 대해 자동으로 프로비전 및 프로비전 해제합니다. 이 서비스의 기능, 사용법, 자주 묻는 질문과 답변 등 중요 세부 정보는 Microsoft Entra ID를 사용한 SaaS 애플리케이션으로의 사용자 자동 프로비전 및 프로비전 해제를 참조하세요.
지원되는 기능
- Atlassian Cloud에서 사용자 만들기
- Atlassian Cloud에서 더 이상 액세스할 필요가 없는 사용자 제거
- Microsoft Entra ID와 Atlassian Cloud 간에 사용자 특성을 동기화된 상태로 유지
- Atlassian Cloud에서 그룹 및 그룹 멤버 자격 프로비저닝
- Atlassian Cloud에 Single Sign-On 사용(추천)
필수 조건
이 자습서에 설명된 시나리오에서는 사용자에게 이미 다음 필수 구성 요소가 있다고 가정합니다.
프로비전을 구성할 수 있는 권한이 있는 Microsoft Entra ID의 사용자 계정(예: 애플리케이션 관리자, 클라우드 애플리케이션 관리자 또는 애플리케이션 소유자).
Atlassian 조직의 관리자인지 확인합니다. 조직 관리를 참조하세요.
조직에서 하나 이상의 도메인을 확인합니다. 도메인 확인을 참조하세요.
조직에서 Atlassian Access를 구독합니다. Atlassian Access 보안 정책 및 기능을 참조하세요.
Atlassian Access 구독이 있는 Atlassian Cloud 테넌트.
동기화된 사용자에게 액세스 권한을 부여하려는 하나 이상의 Jira 또는 Confluence 사이트의 관리자인지 확인합니다.
참고 항목
이 통합은 Microsoft Entra 미국 정부 클라우드 환경에서도 사용할 수 있습니다. 이 애플리케이션은 Microsoft Entra 미국 정부 클라우드 애플리케이션 갤러리에서 찾을 수 있으며 퍼블릭 클라우드에서 하는 것과 동일한 방법으로 구성할 수 있습니다.
1단계: 프로비저닝 배포 계획
- 프로비저닝 서비스의 작동 방식에 대해 알아봅니다.
- 프로비저닝 범위에 포함될 사용자를 결정합니다.
- Microsoft Entra ID와 Atlassian Cloud 간에 매핑할 데이터를 결정합니다.
2단계: Microsoft Entra ID를 사용하여 프로비전을 지원하도록 Atlassian Cloud 구성
Atlassian 관리 콘솔로 이동합니다. 둘 이상이 있는 경우 조직을 선택합니다.
보안 > ID 공급자를 선택합니다.
ID 공급자 디렉터리를 선택합니다.
사용자 프로비전 설정을 선택합니다.
SCIM 기본 URL 및 API 키에 대한 값을 복사합니다. Azure를 구성할 때 필요합니다.
SCIM 구성을 저장합니다.
참고 항목
이러한 값은 다시 표시되지 않으므로 안전한 장소에 저장해야 합니다.
사용자 및 그룹은 조직에 자동으로 프로비전됩니다. 사용자 및 그룹이 조직과 동기화하는 방법에 대한 자세한 내용은 사용자 프로비저닝 페이지를 참조하세요.
3단계: Microsoft Entra 애플리케이션 갤러리에서 Atlassian Cloud 추가
Microsoft Entra 애플리케이션 갤러리에서 Atlassian Cloud를 추가하여 Atlassian Cloud로 프로비전 관리를 시작합니다. 이전에 SSO를 Atlassian Cloud에 사용하도록 설정한 경우 동일한 애플리케이션을 사용할 수 있습니다. 그러나 처음 통합을 테스트하는 경우 별도의 앱을 만드는 것이 좋습니다. 여기를 클릭하여 갤러리에서 애플리케이션을 추가하는 방법에 대해 자세히 알아봅니다.
4단계: 프로비저닝 범위에 있는 사용자 정의
Microsoft Entra 프로비전 서비스를 사용하면 애플리케이션에 대한 할당 및/또는 사용자/그룹의 특성을 기반으로 프로비전할 대상의 범위를 할당할 수 있습니다. 할당을 기준으로 앱에 프로비저닝할 사용자의 범위를 선택하려면 다음 단계를 사용하여 애플리케이션에 사용자 및 그룹을 할당할 수 있습니다. 사용자 또는 그룹의 특성만을 기준으로 프로비저닝할 사용자의 범위를 선택하려면 여기 설명된 대로 범위 지정 필터를 사용할 수 있습니다.
소규모로 시작합니다. 모든 사용자에게 배포하기 전에 소수의 사용자 및 그룹 집합으로 테스트합니다. 할당된 사용자 및 그룹으로 프로비저닝 범위가 설정된 경우 앱에 하나 또는 두 개의 사용자 또는 그룹을 할당하여 범위를 제어할 수 있습니다. 모든 사용자 및 그룹으로 범위가 설정된 경우 특성 기반 범위 지정 필터를 지정할 수 있습니다.
추가 역할이 필요한 경우 애플리케이션 매니페스트를 업데이트하여 새 역할을 추가할 수 있습니다.
5단계: Atlassian Cloud에 대한 자동 사용자 프로비저닝 구성
이 섹션에서는 Microsoft Entra ID의 사용자 및/또는 그룹 할당에 따라 Atlassian Cloud에서 사용자 및/또는 그룹을 만들고, 업데이트하고, 사용 해제하도록 Microsoft Entra 프로비전 서비스를 구성하는 단계를 안내합니다.
Microsoft Entra ID에서 Atlassian Cloud에 대한 자동 사용자 프로비저닝을 구성하려면 다음을 수행합니다.
최소한 클라우드 애플리케이션 관리자로 Microsoft Entra 관리 센터에 로그인합니다.
ID>애플리케이션>엔터프라이즈 애플리케이션>Atlassian Cloud로 이동합니다.
애플리케이션 목록에서 Atlassian Cloud를 선택합니다.
프로비전 탭을 선택합니다.
프로비전 모드를 자동으로 설정합니다.
관리자 자격 증명 섹션 아래에서 Atlassian Cloud의 계정에서 이전에 검색한 테넌트 URL 및 비밀 토큰을 입력합니다. 연결 테스트를 클릭하여 Microsoft Entra ID가 Atlassian Cloud에 연결할 수 있는지 확인합니다. 연결이 실패하면 Atlassian Cloud 계정에 관리자 권한이 있는지 확인하고 다시 시도합니다.
알림 메일 필드에 프로비저닝 오류 알림을 받을 개인 또는 그룹의 메일 주소를 입력하고, 오류가 발생할 경우, 메일 알림 보내기 확인란을 선택합니다.
저장을 클릭합니다.
매핑 섹션에서 Microsoft Entra 사용자를 Atlassian Cloud에 동기화를 선택합니다.
특성 매핑 섹션에서 Microsoft Entra ID에서 Atlassian Cloud로 동기화되는 사용자 특성을 검토합니다. 이메일 특성은 Atlassian Cloud 계정을 Microsoft Entra 계정과 일치시키는 데 사용됩니다. 저장 단추를 선택하여 변경 내용을 커밋합니다.
Attribute Type userName 문자열 활성 부울 name.familyName 문자열 name.givenName 문자열 emails[type eq "work"].value 문자열 매핑 섹션에서 Microsoft Entra 그룹을 Atlassian Cloud에 동기화를 선택합니다.
특성 매핑 섹션에서 Microsoft Entra ID에서 Atlassian Cloud로 동기화되는 그룹 특성을 검토합니다. 표시 이름 특성은 Atlassian Cloud 그룹을 Microsoft Entra 그룹과 일치시키는 데 사용됩니다. 저장 단추를 선택하여 변경 내용을 커밋합니다.
Attribute Type displayName 문자열 externalId 문자열 구성원 참조 범위 지정 필터를 구성하려면 범위 지정 필터 자습서에서 제공하는 다음 지침을 참조합니다.
Atlassian Cloud에 대해 Microsoft Entra 프로비저닝 서비스를 사용하도록 설정하려면 설정 섹션에서 프로비전 상태를 켜기로 변경합니다.
설정의 범위 섹션에서 원하는 값을 선택하여 Atlassian Cloud에 프로비저닝하려는 사용자 및/또는 그룹을 정의합니다.
프로비전할 준비가 되면 저장을 클릭합니다.
이 작업은 설정의 범위 섹션에 정의된 모든 사용자 및/또는 그룹의 초기 동기화를 시작합니다. 초기 동기화는 Microsoft Entra 프로비전 서비스가 실행되는 동안 약 40분마다 발생하는 후속 동기화보다 수행하는 데 시간이 더 오래 걸립니다.
6단계: 배포 모니터링
프로비저닝을 구성한 후에는 다음 리소스를 사용하여 배포를 모니터링합니다.
- 프로비저닝 로그를 사용하여 어떤 사용자가 성공적으로 프로비저닝되었는지 확인합니다.
- 진행률 표시줄을 통해 프로비저닝 주기 상태와 완료 정도를 확인합니다.
- 프로비저닝 구성이 비정상 상태로 보이면 애플리케이션이 격리됩니다. 격리 상태에 대한 자세한 내용은 여기를 참조하세요.
커넥터 제한 사항
- Atlassian Cloud는 확인된 도메인이 있는 사용자에 대한 프로비저닝 업데이트만 지원합니다. 확인되지 않은 도메인에서 사용자에 대한 변경 내용은 Atlassian Cloud로 푸시되지 않습니다. 여기에서 Atlassian 확인 도메인에 대해 자세히 알아보세요.
- Atlassian Cloud는 현재 그룹 이름 바꾸기를 지원하지 않습니다. 즉, Microsoft Entra ID에서 그룹의 displayName을 변경하면 Atlassian Cloud에서 업데이트되어 반영되지 않습니다.
- 사용자에게 Microsoft Exchange 사서함이 있는 경우에만 Microsoft Entra ID의 mail 사용자 특성 값이 채워집니다. 사용자에게 해당 특성이 없는 경우 다른 원하는 특성을 Atlassian Cloud의 emails 특성에 매핑하는 것이 좋습니다.
로그 변경
- 2020년 6월 15일 - 그룹에 대한 일괄 처리 PATCH 지원이 추가되었습니다.
- 2021년 4월 21일 - 스키마 검색에 대한 지원이 추가되었습니다.
- 2022년 10월 14일 - 커넥터 제한 사항이 업데이트되었습니다.