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

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

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

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

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

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

사전 요구 사항

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

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

구성

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

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

사용자 속성 매핑

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

1. 애플리케이션 설정 페이지에서 프로비저닝 > 앱으로 탭으로 이동합니다. 편집을 클릭한 다음, 사용자 생성, 사용자 속성 업데이트, 사용자 비활성화 옆의 체크박스를 선택합니다:
   
   사전 구성된 Miro 앱의 앱으로 탭
2. 아래로 스크롤하여 사용자 이름이 사인온 설정에서 구성됨으로 설정되어 있는지 확인합니다:
   
   사전 구성된 Miro 앱의 속성 매핑 탭
3. 지원되는 속성을 추가하려면 프로필 편집기로 이동을 클릭한 다음 속성 추가를 선택하세요:
   
   프로필 편집기의 활성 속성 목록
   

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

사용자 할당 및 그룹 동기화

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

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

단계 1: 그룹 할당

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

단계 2: Push Groups 구성

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

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

사용자 그룹 구성원 자격만으로는 보드와 스페이스에 대한 접근 권한이 자동으로 부여되지 않습니다. 권한을 부여하려면 관련 보드와 스페이스를 사용자 그룹이나 개별 구성원에게 별도로 공유하세요.

문제 해결

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

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

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

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

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

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