이 가이드는 SCIM을 사용해 Google Workspace와 Miro Enterprise 계정 간의 자동 사용자 프로비저닝을 구성하는 과정을 안내합니다.
사용 가능 플랜: Enterprise 플랜
설정자: 회사 수준 관리자⚠️ 이 가이드는 구성 단계만 다룹니다. 지원되는 기능, 동기화 규칙 및 문제 해결은 SCIM 개요를 참조하세요. SCIM API 참조는 개발자 문서를 확인하세요.
참고: 이 통합은 사용자만 프로비저닝합니다. Google Workspace의 Miro 자동 프로비저닝은 Google 그룹을 Miro 사용자 그룹이나 팀으로 동기화하지 않습니다. 그룹 멤버십도 동기화하려면 Miro에서 지원하는 다른 ID 공급자 중 하나를 사용하거나 사용자 그룹을 직접 관리하세요.
Google에서도 Miro 사용자 프로비저닝을 구성하는 방법을 안내하고 있습니다.
사전 요구 사항
자동 프로비저닝을 구성하기 전에 다음을 완료하세요:
- Miro Enterprise 플랜에서 Google SSO(통합로그인)가 작동하는지 설정하고 확인하세요. 자세한 지침은 Google SSO 구성을 참조하세요.
- 동기화 중 연결 오류를 피하려면 SCIM 개요에서 중요 참고 사항 및 Miro 운영 규칙을 검토하세요.
구성
- Google Workspace 관리자 콘솔에서 Miro 앱으로 이동합니다 (앱 > 웹 및 모바일 앱 > Miro).
- 자동 프로비저닝에서 자동 프로비저닝 구성을 클릭합니다.
- Miro 액세스 토큰을 얻으려면 Miro 조직에 로그인(https://miro.com/app/dashboard/)한 다음 오른쪽 상단의 아바타를 클릭하고 설정을 클릭합니다.
- 회사 설정에서 엔터프라이즈 통합을 클릭하고 아직 켜져 있지 않다면 SCIM 프로비저닝을 켭니다.
- API 토큰을 복사하려면 복사를 클릭합니다.
- Google 관리자 콘솔로 돌아가 토큰을 붙여넣은 후 계속을 클릭합니다.
- 속성 매핑 아래의 모든 필수 값이 올바른 Google 속성에 매핑되어 있는지 확인합니다. 그렇지 않으면 속성 옆의 아래쪽 화살표를 클릭해 올바른 값을 선택한 후 계속을 클릭합니다.
- 특정 Google 그룹으로 프로비저닝 범위를 제한하려면 그룹 이름을 입력합니다. 이렇게 하면 어떤 사용자가 Miro에 프로비저닝될지 범위를 지정하지만, 해당 Google 그룹이 Miro 사용자 그룹이나 팀으로 동기화되지는 않습니다. 모든 사용자를 프로비저닝하려면 계속을 클릭합니다.
- 원하는 프로비저닝 해제 설정을 구성한 후 완료를 클릭합니다.
- 자동 프로비저닝 영역에서 토글을 클릭해 자동 프로비저닝을 활성화합니다.
Google 및 Miro에서 프로비저닝 테스트하기
- Google 관리자 콘솔에서 디렉터리 > 사용자를 클릭합니다.
- 새 사용자 추가를 클릭합니다.
- 해당 사용자의 이름과 성을 입력한 후 새 사용자 추가를 클릭합니다.
- 완료를 클릭해 확인하고 새 사용자를 추가합니다.
- 브라우저를 새로고침하면 새 사용자가 표시됩니다.
- Miro에서 회사 설정 (https://miro.com/app/dashboard/, 오른쪽 상단의 아바타를 클릭하고 설정을 선택한 다음), 활성 사용자를 클릭합니다.
- 이제 새로 프로비저닝된 사용자가 표시됩니다:
Google 및 Miro에 프로비저닝된 사용자 추가
문제 해결
자동 프로비저닝이 중단될 때
Miro 관리자 비밀번호가 변경되거나 계정이 비활성 상태가 되면 자동 프로비저닝이 중단될 수 있습니다. Google Workspace에서 앱으로 사용자 계정을 계속 동기화하려면 자동 프로비저닝 권한을 다시 부여하세요:
- Google Workspace 관리자 콘솔에서 Miro 앱으로 이동합니다 (앱 > 웹 및 모바일 앱 > Miro).
- 자동 프로비저닝 섹션을 클릭한 다음 앱 인증에서 재인증을 클릭합니다.
- 액세스 토큰 입력을 요청받으면 Miro에서 받은 API 토큰을 입력합니다(위의 구성 섹션 3–5단계 참조).
- 재인증을 클릭합니다.
추가 지원이 필요하면 SCIM 개요를 참조하세요. 프로비저닝 설정 편집, 자동 프로비저닝 비활성화 및 설정 정보 삭제에 대한 자세한 내용은 Google 도움말 센터의 Miro 사용자 프로비저닝 구성을 참조하세요.