Okta로 자동 프로비저닝 설정하기

이 가이드는 SCIM을 사용해 Okta와 Miro Enterprise 계정 간의 사용자 및 사용자 그룹 자동 프로비저닝을 구성하는 단계를 안내합니다.

사용 가능 대상: Enterprise 플랜
설정자: 회사 관리자

⚠️ 이 가이드는 구성 단계만 다룹니다. 지원되는 기능, 동기화 규칙 및 문제 해결에 대해서는 SCIM 개요를 참조하세요. SCIM API 참조는 개발자 문서를 참조하세요.

참고: 이 통합으로 구성된 SCIM 그룹은 팀이 아니라 Miro의 사용자 그룹으로 직접 동기화됩니다. 자세한 내용은 새 동기화 모델을 참조하세요.

조직에서 플렉시블 라이선싱 프로그램을 사용하는 경우, 해당 설정에 대한 자세한 프로비저닝 가이드를 대신 참조하세요.

사전 요구 사항

자동 프로비저닝을 구성하기 전에 다음 항목을 완료하세요:

• Miro Enterprise 플랜에서 SAML 기반 SSO(통합로그인)가 작동하는지 설정하고 확인하세요. 자세한 지침은 Okta SSO 구성을 참조하세요.
• API 토큰을 생성하세요. SCIM API는 모든 요청에 토큰이 필요합니다. 토큰을 생성하려면 Enterprise Integrations > SSO > SCIM 설정에서 SCIM을 활성화하세요.
• 동기화 중 연결 오류를 방지하려면 SCIM 개요에서 Miro 운영 관련 중요 사항 및 규칙을 검토하세요.

구성

Okta를 Miro의 SCIM API에 연결해 Okta가 프로비저닝 요청을 인증할 수 있게 합니다.

1. 애플리케이션 설정 페이지에서 프로비저닝 탭으로 이동한 다음 API 통합 구성을 클릭합니다:
   
   사전 구성된 Miro 앱의 프로비저닝 탭
2. API 통합 사용 체크박스를 선택한 다음 기본 URL (https://miro.com/api/v1/scim/)과 고유한 API 토큰(Miro 설정의 보안 섹션에서 확인할 수 있음)을 입력하고 API 신원 정보 테스트를 클릭합니다.
   연결이 성공하면 "Miro가 성공적으로 확인되었습니다"라는 알림이 표시됩니다:
   
   Provisioning 탭, 통합 섹션
   확인 메시지가 표시되지 않으면 네트워크에서 Base URLhttps://miro.com/api/v1/scim/이 방화벽이나 기타 트래픽 가로채기 장치에 의해 차단되어 있지 않은지 확인하고, API Token이 올바른지 확인하세요.
3. 저장하여 구성을 완료하세요.

사용자 속성 매핑

Miro의 SCIM API는 Okta가 사용자와 그룹에 첨부하는 메타데이터 중 일부를 사용합니다. 이 섹션에서는 Miro SCIM API와 Okta 속성 간에 필요한 매핑을 설명합니다.

1. 애플리케이션 설정 페이지에서 Provisioning > To App 탭으로 이동합니다. Edit를 클릭한 후 Create Users, Update User Attributes, Deactivate Users 옆의 체크박스를 선택합니다:
   
   사전 구성된 Miro 앱의 To App 탭
2. 아래로 스크롤해 Username이 Configured in Sign On Settings로 설정되어 있는지 확인합니다:
   
   사전 구성된 Miro 앱의 속성 매핑 탭
3. 지원되는 속성을 추가하려면 프로필 편집기로 이동한 다음 속성 추가를 선택하세요:
   
   프로필 편집기에서 활성 속성 목록
   

지원되는 전체 속성 목록은 SCIM 문서를 참조하세요.

사용자 할당 및 그룹 동기화

Miro SCIM 프로비저닝을 사용하면 Enterprise 플랜에 사용자를 프로비저닝하고 사용자 그룹에 자동으로 배포하며 필요 시 비활성화할 수 있습니다.

⚠️ Okta의 그룹은 사용자들이 이미 개별적으로 할당되어 있더라도 Miro 애플리케이션에 할당되고 앱의 Push Groups에 추가되어야 합니다. 아래의 두 단계가 모두 필요합니다.

단계 1: 그룹 할당

Miro 애플리케이션에 그룹을 할당하려면 Assignments 탭을 사용하세요. 이 시점에서 할당된 사용자들은 Miro SSO(통합로그인)를 통해 인증할 수는 있지만 아직 어떤 Miro 사용자 그룹에도 속하지 않습니다.

단계 2: Push Groups 구성

Okta 그룹을 Miro 사용자 그룹과 동기화하려면 Push Groups를 구성하세요.

1. 애플리케이션 설정 페이지에서 푸시 그룹 탭을 선택한 다음 앱 그룹 새로고침을 클릭하세요:
   
   사전 구성된 Miro 앱의 푸시 그룹
   이렇게 하면 Okta가 Miro 구독의 사용자 그룹을 찾아 동기화할 수 있습니다. 사용자 그룹 수에 따라 목록을 다운로드하는 데 몇 분이 걸릴 수 있습니다.
2. Push Groups > Find groups by name를 클릭하세요:
   
   푸시 그룹 설정
   검색 상자에 Okta 그룹 이름을 입력한 뒤 자동완성 목록에서 선택하세요. Okta는 이전 단계에서 다운로드한 목록을 기준으로 해당 Miro 사용자 그룹과 일치하는 그룹을 표시합니다:
   
   Okta 그룹과 Miro 사용자 그룹 연결
   일치하는 Miro 사용자 그룹이 없으면 Create Group을 선택하세요. Okta가 Miro 사용자 그룹을 생성하므로 Miro에서 미리 사용자 그룹을 만들 필요가 없습니다.
3. 일부 사용자가 Okta를 통해서가 아니라 Miro Enterprise 플랜에 직접 추가된 경우, Import 탭으로 이동해 Import now를 클릭하세요. 이러면 기존 Miro 사용자가 Okta로 가져와져 처리 방식을 선택할 수 있습니다:
   
   이렇게 하면 두 시스템 간 사용자 불일치가 없어 SSO(통합로그인)를 활성화한 후 로그인이 되지 않는 문제를 방지할 수 있습니다.
4. 변경사항을 저장하세요. 이제 Miro로 푸시된 그룹 목록과 동기화 상태(녹색으로 표시된 Active)를 볼 수 있습니다. 선택한 그룹의 모든 사용자는 해당 Miro 사용자 그룹에 배치되며 이후에도 동기화 상태가 유지됩니다.

보드와 스페이스 접근 권한은 사용자 그룹 멤버십만으로 자동으로 부여되지 않습니다. 관련 보드와 스페이스를 사용자 그룹이나 개별 사용자에게 별도로 공유해 접근 권한을 부여하세요.

문제 해결

1. 사용자가 Miro로 푸시되지 않습니다.
   Okta에서 푸시된 그룹이 앱에 올바르게 할당되어 있는지 확인하세요. Push 그룹 동기화에 표시되는 Okta의 Active 상태는 때때로 부정확할 수 있습니다. 동기화 오류를 해결하려면 그룹의 할당을 해제하고 Push 그룹에서 제거한 다음, 그룹을 다시 할당하고 Push 그룹에 다시 추가하세요. 다른 변경 사항이 없어도 동기화 연결을 재생성하면 문제가 해결될 수 있습니다.
2. 사용자가 삭제되지 않습니다.
   SCIM 프로세스는 사용자 삭제를 포함하지 않습니다. 사용자의 접근 권한을 제거하려면 Okta에서 사용자를 비활성화하거나 Okta 쪽에서 애플리케이션의 할당을 해제하세요. 어느 쪽이든 Miro에 요청을 보내 사용자의 상태를 비활성화 상태로 설정합니다. 사용자를 완전히 삭제하려면 사용자 삭제 방법을 참조하세요.
3. 사용자 데이터가 업데이트되지 않습니다.
   해당 Username 속성은 Application > Assignments에서 업데이트하면 안 됩니다:
   
   사용자 프로필의 Edit 옵션에서 Username 속성과 다른 속성을 함께 업데이트하세요:
   
4. 사용자가 "Conflict. Errors reported by remote server: DomainAddress is not whitelisted" 오류로 프로비저닝되지 않습니다.
   
   사용자의 도메인 주소가 공유 정책에 허용되어 있는지 확인하세요.
5. Push Now 옵션을 사용한 후 일부 사용자가 예기치 않게 사용자 그룹에서 제거되었습니다.
   이 옵션을 사용하면 Okta가 사용자 그룹의 모든 구성원을 대체하는 PATCH 요청을 시작하므로 Miro의 사용자 목록을 Okta의 사용자 목록과 동기화합니다. 프로세스가 완료되기 전에 타임아웃이 발생하면 타임아웃 시점까지 확인된 사용자만 Miro에 남고 나머지 사용자는 사용자 그룹에서 제거됩니다. 사용자를 사용자 그룹에서 제거하면 해당 그룹의 구성원에만 영향을 미치며, 팀이나 조직에서 사용자를 제거하거나 보드나 프로젝트 소유권을 이전하지 않으므로 콘텐츠가 재할당되지는 않습니다. Push Now 작업 후 구성원이 누락된 것을 발견하면 동기화를 다시 시도해 전체 사용자 목록을 적용하세요.
6. Import Now 옵션이 제공하는 Scanned users 수가 내 Miro 구독의 사용자 수와 일치하지 않습니다.
   이 숫자에는 비활성화된 사용자나 팀에 속하지 않은 사용자가 포함되지 않습니다. 결과는 마지막 가져오기 이후 Okta에 최근 변경사항(예: 아래에 표시된 '1 user removed' 변경)이 포함된 경우 달라질 수 있습니다. 정확한 개수를 확인하려면 Import 커맨드를 최소 두 번 실행하세요.
   
7. 사용자 일부의 데이터가 업데이트되지 않습니다.
   모든 구성된 속성, 특히 ProfilePicture 또는 UserType 같은 사용자 지정 속성이 사용자 프로필 페이지에 존재하고 값이 입력되어 있는지 확인하세요:
   

8. 링크 / Push Group 시간 초과로 변경 사항이 Miro로 전송되지 않습니다:
   "06-14-2021 12:16:29PM UTC에 실패: 그룹 푸시 매핑 대상 앱 그룹 <Group Name> 업데이트 불가: 사용자 그룹 <Group Name> 생성 중 오류: 읽기 시간 초과".
   

   이 타임아웃 오류는 기존 그룹을 연결하거나 구성원이 많은 새 그룹을 푸시할 때 나타날 수 있습니다.

   새 그룹을 푸시하던 중이었다면, Okta의 SCIM 요청이 대상 그룹이 Miro에 생성되기 전에 타임아웃되었는지 이후에 타임아웃되었는지 확인하세요. 대상 그룹이 Miro에 생성되지 않았다면, "Push Group" 작업을 다시 시도하세요:
   

   기존 그룹을 연결하던 중이었거나 초기 푸시 작업 후에 대상 그룹이 Miro에 생성되었다면, Okta와 Miro 간의 그룹 연결을 복원하세요:

   1. 모달 창에서 대상 앱에 그룹 남기기를 선택하고 푸시된 그룹의 연결을 해제합니다:
      
      
   2. Okta가 Miro의 그룹 목록을 가져오도록 앱 그룹 새로고침을 클릭하세요:
      
   3. 그룹 푸시를 클릭한 다음 이름으로 그룹 찾기를 선택하세요.
   4. 검색 상자에 이름을 입력해 푸시하려는 그룹을 찾아 드롭다운에서 선택하세요. Okta는 Link Group 옵션이 비활성화된 상태로 다음과 같이 표시합니다:
      
   5. Save를 클릭하세요. Okta는 PATCH /Groups SCIM 요청으로 대상 그룹을 동기화합니다.
   6. Okta 그룹의 모든 멤버가 Miro의 해당 사용자 그룹에 할당되지 않은 경우, Okta에서 "Directory → Tasks" 탭을 확인하고 실패한 작업을 재시도하세요: