이 문서에서는 Miro와 Okta 간의 SCIM 또는 SSO 통신이 이미 성공적으로 구성된 경우 새 속성을 추가하는 방법을 설명합니다.
Okta SSO 설정 방법
Okta SCIM 설정 방법
Okta 라이선스 FLP용 프로비저닝 가이드 (라이선스 속성 생성 및 할당 방법)
SSO 흐름용 ProfilePicture 설정 가이드 (SCIM이 비활성화된 경우)
Miro에서 필수로 요구하는 값은 userName, 해당 속성은 이메일 주소 형식이어야 합니다. 다른 속성은 필수는 아니지만, 있으면 Miro에서 허용됩니다. 추가 속성을 Miro 스키마에 매핑하려면 해당 문서의 내용을 참고하고 아래 단계를 따르세요.
⚠️ Miro 앱 레벨 속성은 Okta의 일반 속성과 값 단위로 동기화되므로, Miro에만 고유하거나(또는 인스턴스에서 아직 사용된 적이 없을 수 있는) 일부 속성은 아래 지침을 진행하기 전에 Directory > Profile Editor > User (default)에서 먼저 생성해야 합니다.
SCIM용 속성 생성
⚠️ 속성은 Miro 앱 수준에서 생성해야 하며, Directory의 메인 Profile Editor에서 생성하면 안 됩니다.
- Applications > Miro를 열고 > Provisioning로 이동하세요.
-
Okta에서 Directory > Profile editor로 이동한 다음 아래로 스크롤해 Go to Profile Editor를 클릭하고 Add Attribute를 클릭하세요.
Miro 앱의 Profile Editor 섹션
- 지원되는 속성 목록 을 확인한 다음 추가하려는 속성의 Miro attribute namespace (두 번째 열)를 복사하세요. 복사한 값을 External namespace 필드에 붙여넣으세요.
- 해당 Miro attribute 를 복사해서 Variable name 필드에 붙여넣습니다. Okta가 External name에도 자동으로 추가합니다. Variable name 필드에 마침표(.)가 있으면 삭제하세요.
- Display name 필드에 원하는 속성 이름을 입력합니다(문서의 IDP attribute name 열에 제안된 값을 사용하는 것을 권장합니다).
- 모달 하단에서 User personal 체크박스를 선택합니다.
⚠️ 복잡한 속성인 사용자 역할(
roles)이나 프로필 사진(photos)의 경우 자동 입력된 External name을 그대로 두지 마세요. External name에 SCIM 속성 표에 있는 Okta 표현식을 입력하세요(예:roles.^[primary==true].value). SCIM PATCH 필터 경로(roles[primary eq true].value)는 사용하지 마세요. Okta가.value를 제거해 잘못된 JSON을 보낼 수 있습니다.
그 결과, 작성된 양식은 다음과 비슷해야 합니다:
Okta에서 관리자 이름 속성 추가
예시: 회사 관리자 (roles)
회사 관리자/사용자 역할 속성을 추가할 때 다음 값을 사용하세요:
-
표시 이름:
Company Admin -
변수 이름:
miro_company_admin -
외부 이름:
roles.^[primary==true].value -
외부 네임스페이스:
urn:ietf:params:scim:schemas:core:2.0:User - 속성 유형: 개인(사용자 개인 체크박스 선택)
지원되는 역할 값: ORGANIZATION_INTERNAL_ADMIN, ORGANIZATION_INTERNAL_USER.
저장을 클릭하세요. 같은 페이지의 목록에 새 속성이 표시되는지 확인하세요. 이제 속성이 생성되었지만 아직 어떤 항목과도 동기화되지 않았으며 비어 있습니다.
매핑 설정
새로 만든 속성은 매핑되어 있지 않으며 기본적으로 Miro 앱의 Provisioning 탭의 속성 목록에서 접힌 상태로 숨겨집니다. 매핑되지 않은 속성 표시 > 편집을 클릭하여 속성을 편집하세요:
- 속성 값: 유형 선택 = Okta 프로필에서 매핑, ATTRIBUTE_NAME | string
- 생성 및 업데이트를 선택하세요:
저장을 클릭하세요. 이제 속성이 목록에서 매핑됨으로 표시되지만, 이 매핑은 Okta 쪽에서 값을 가져오는 설정입니다(Okta가 해당 속성의 값을 어디서 가져올지 알게 된 상태입니다). 이제 Miro와 Okta 간에 데이터를 동기화해야 합니다.
같은 페이지에서 매핑 버튼을 클릭하세요:
Miro 앱의 프로필 편집기 섹션
Okta User to Miro 섹션을 클릭하세요. 오른쪽에서 해당 속성을 확인할 수 있습니다. 왼쪽에서 동기화할 Okta 속성을 선택한 다음 연결을 Apply mapping on user create and update.로 설정하세요.
Manager 이름 속성을 Miro에 매핑하기
그 후 해당 속성은 신규 및 기존 모든 사용자에 대해 Miro로 전송되기 시작합니다.
Save mappings를 클릭한 다음 Apply updates now를 클릭하세요.
이제 완료되었습니다.
⚠️ 속성 데이터는 프로필에 값이 있는 사용자에게만 표시됩니다.
그룹 수준에서 속성을 할당하려면 p.2.3의 지침을 여기에서 따르세요(가이드는 라이선스 할당용으로 작성되었으나 모든 속성에 사용할 수 있습니다).
새 속성은 Okta에서 전송되는 즉시 Miro에 표시되기 시작합니다.
속성은 관리자용 Miro 설정의 사용자 정보 카드 하단에 표시됩니다.
사용자 정보 카드
SSO용 프로필 사진 속성 생성
SSO 워크플로용 ProfilePicture 설정 가이드 (SCIM이 비활성화된 경우)
SCIM을 활성화한 경우 이 부분은 건너뛰고 프로필 사진 속성을 표준 방식으로 구성하는 것이 권장됩니다. 이 방법은 SSO(통합로그인)만 사용하는 경우의 우회 방법으로 사용할 수 있습니다.
다른 속성과 달리 프로필 사진 속성은 SSO(통합로그인) 인증 중에도 전송될 수 있습니다. Miro SSO 설정에서 이를 활성화하면 가능하며 SCIM 푸시 중에는 전송되지 않습니다. 이는 생성 흐름이 달라질 수 있음을 의미하며, 문서 맨앞의 안내와는 달리 이 경우에는 기본 프로필 편집기에서 생성해야 합니다.
- 다음으로 이동: Directory > Profile Editor > Add Attribute
- Set the Display Name as "Profile Picture"
-
Set the Variable Name as "profilePhotoUrl"
결과는 다음과 같습니다:기본 Okta Profile Editor에서 Profile Picture 속성 추가
- Click Save and proceed to populate the user custom attribute Profile Picture for each user in Okta (in the user Profile) using the image URL as the value.
⚠️ 현재 Okta는 플랫폼 내에서 이미지를 기본적으로 저장하는 것을 지원하지 않습니다. 이미지는 제3자 서버에 호스팅되어야 하며 URL을 통해 공개적으로 접근 가능해야 합니다.
이미지 크기 제한은 없지만 400×400px보다 큰 이미지는 사용자가 다시 인증한 후 로드되는 데 시간이 더 걸릴 수 있습니다.
✏️ 대신 Okta API를 통해 해당 속성을 채우거나 업데이트할 수 있습니다.
프로필 사진 속성 사용 설정
마지막으로 Miro 앱의 Sign On 섹션에서 해당 속성을 활성화하세요.
-
다음으로 이동하세요: Applications > 해당 Miro 앱 선택 > Sign On 탭 > Edit
Sign on section of the Miro app**
-
Attributes (Optional) 옆의 화살표를 클릭하고 다음 값을 추가하세요:
-
Name: "ProfilePicture"
-
Value: "user.ProfilePhotoUrl"
결과는 다음과 같이 표시됩니다:
Miro 앱의 Sign On 섹션에서 Profile Picture 속성 활성화
-
Name: "ProfilePicture"
- 속성 이름이 모든 곳에서 동일한지 다시 확인하세요(지침의 모든 값을 복사해 붙여넣는 것을 권장합니다). 그렇지 않으면 Okta가 동기화하지 못할 수 있습니다.
- 스크롤을 내려 Save를 클릭하세요.
프로필 사진은 새 사용자가 SSO(통합로그인)로 성공적으로 인증한 후 Miro에 표시됩니다.