SCIM 및 Genesys Cloud 필드 매핑
이 표는 Genesys Cloud SCIM(Identity Management)이 Genesys Cloud 필드에 매핑하는 SCIM 필드를 보여줍니다. 그런 다음 이러한 SCIM 필드는 타사 응용 프로그램의 필드에 매핑됩니다.
SCIM 필드 | Genesys Cloud 통화 | 설명 |
---|---|---|
id | 사용자 프로필.Id | |
사용자 이름 | UserProfile.contactInfo.email_main.[0].값 | |
상태 | UserProfile.state true eq '활성' false eq '비활성' | |
표시 이름 | UserProfile.general.name.[0].값 | |
제목 | UserProfile.general.title.[0].값 | |
scimEnterpriseUser.manager.value | UserProfile.relationships.manager.[0].값 | 전체 URN: urn:ietf:params:scim:스키마: 확장:엔터프라이즈:2.0: 사용자:manager.value |
scimEnterpriseUser.department | UserProfile.general.department.[0].값 | 전체 URN: urn:ietf:params:scim:스키마: 확장:엔터프라이즈:2.0: 사용자:부서 |
scimEnterpriseUser.division | UserProfile.divisionId | 전체 URN: urn:ietf:params:scim:스키마: 확장:엔터프라이즈:2.0: 사용자 디비전 |
이메일[유형 eq "다른"].값 | UserProfile.contactInfo.email_main.[0].값 | 이 필드는 userName과 동일합니다. 이 필드는 읽기 전용입니다. 참고: 보다 다중 값 속성 필터링 . |
이메일[유형 eq "일하다"].값 | UserProfile.contactInfo.email_work.[0].값 | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 일하다< " ].값 | UserProfile.contactInfo.[0].phone_work.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 작업2 " ].값 | UserProfile.contactInfo.[0].phone_work_2.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 작업3 " ].값 | UserProfile.contactInfo.[0].phone_work_3.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 일4 " ].값 | UserProfile.contactInfo.[0].phone_work_4.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 집 " ].값 | UserProfile.contactInfo.[0].phone_home.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 다른 " ].값 | UserProfile.contactInfo.[0].phone_other.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq " 이동하는 " ].값 | UserProfile.contactInfo.[0].phone_mobile.[0].value.number | 메모 : 보다 다중 값 속성 필터링 . |
메타.위치 | {사용자 프로필 자체 URL} | |
메타 버전(ETag) | 사용자 프로필.버전 | |
meta.last수정됨 | UserProfile.date수정됨 | |
외부 ID | {외부 ID API} | |
역할.[].값 | {사용자 역할 API} | 메모 : 보다 다중 값 속성 필드 . |
name.given이름 | — | 현재 Genesys Cloud에서 지원되지 않습니다. |
이름.가족이름 | — | 현재 Genesys Cloud에서 지원되지 않습니다. |
주소[유형 eq "일하다"].우편 번호 | — | 현재 Genesys Cloud에서 지원되지 않습니다. |
주소[유형 eq "다른"].포맷 | — | 현재 Genesys Cloud에서 지원되지 않습니다. |
주소[유형 eq "일하다"].거리주소 | — | 현재 Genesys Cloud에서 지원되지 않습니다. |
이메일[유형 eq "{유형}"].일 순위 | UserProfile.primaryContactInfo.email.[0].value.fieldPath |
이 필드는 부울 상수로 설정됩니다. "진실" 벤더 매핑에서. 메모 : 보다 다중 값 속성 필터링 . |
전화번호[유형 eq "{유형}"].일 순위 | UserProfile.primaryContactInfo.voice.[0].value.fieldPath |
이 필드는 해당 필드와 연관된 전화 번호를 사용자의 연락처 정보에서 기본 전화 번호로 지정합니다. 이 필드는 부울 상수로 설정됩니다. " 진실 " 공급업체 매핑에서. 메모 : 보다 다중 값 속성 필터링 . |
그룹 | UserProfile.groups[유형 eq 공식] + {사용자가 소유자인 그룹} | |
암호 | 사용자 프로필 | 비밀번호는 반환할 수 없지만 PUT 또는 PATCH로 업데이트할 수 있습니다. |
scimEnterpriseUser.employeeNumber | 사용자 프로필.hr.empId.[0].값 | 전체 URN: urn:ietf:params:scim:스키마: 확장:엔터프라이즈:2.0: 사용자:직원 번호 |
scimUserExtensions. 라우팅 스킬.[].이름 |
{사용자 라우팅 기술 API} |
전체 URN: urn:ietf:params:scim:스키마: 메모 : 보다 다중 값 속성 필드 . |
scimUserExtensions. routingSkills.[].숙련도 |
{사용자 라우팅 기술 API} |
전체 URN: urn:ietf:params:scim:스키마: 메모 : 보다 다중 값 속성 필드 . |
scimUserExtensions. 라우팅 언어.[].이름 |
{사용자 라우팅 언어 API} |
전체 URN: urn:ietf:params:scim:스키마: 메모 : 보다 다중 값 속성 필드 . |
scimUserExtensions. 라우팅 언어.[].숙련도 |
{사용자 라우팅 언어 API} |
전체 URN: urn:ietf:params:scim:스키마: 메모 : 보다 다중 값 속성 필드 . |
다중 값 속성 필드
SCIM 및 Genesys Cloud 필드 매핑 표에는 각 매핑에 필요한 필수 하위 속성만 나열되어 있습니다. 추가 하위 속성은 정의된 대로 사용할 수 있습니다. RFC 7643 섹션 2.4 표에는 필수적인 사항만 나열되어 있습니다. 다중값 속성의 하위 속성에 대한 포괄적인 목록은 SCIM 사양을 참조하세요.
다중값 속성 SCIM 필드는 다음 형식을 따릅니다.
<attribute>.[].<subattribute>
어디<attribute> 다중값 속성 목록의 요소를 참조합니다.<subattribute> 매핑에 필요한 각 요소의 구체적인 하위 속성을 나타냅니다.
이 형식의 일반적인 JSON 스키마는 다음과 같습니다.
{ "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "required": ["<attribute>"], "properties": { "attribute": { "type": "array", "items": [ { "type": "object", "additionalProperties":true, "required": ["<sub_attribute>"], "properties": { "sub_attribute": { "type": "string" } } } ] } } }
테이블의 매핑에 있는 다중값 속성 참조에 대한 JSON 스키마를 검증하려면 온라인 JSON 스키마 검증 도구를 사용하세요. 예를 들어,roles.[].value
매핑,roles
대표하다<attribute> 그리고value
대표하다<subattribute> .
JSON 요소에 대한roles.[].value
따라서 매핑은 다음과 같이 검증됩니다.
{ "roles": [ { "other": "this is allowed but doesn’t contribute to the roles mapping", "value": "Role1" }, { "value": "Role2" } ] }
다중 값 속성 필터링
일부 SCIM 다중값 속성을 사용하려면 특정 목록 항목을 Genesys Cloud 필드에 매핑해야 합니다. 이러한 경우에는 추가 하위 속성이 목록의 필터 필드로 지정됩니다. 이 필터 필드는 해당 요소에 대한 필수 하위 속성이 됩니다.
예를 들어,phoneNumbers[type eq "home"].value
필드,phoneNumbers
대표하다<attribute> ,value
를 나타냅니다<subattribute> , 그리고type
추가입니다<subattribute> 필터링에 사용됨. 필터가 필요 없는 표준 매핑과 달리type
하위 속성은 목록에서 올바른 전화번호 항목을 식별하고 바인딩하는 데 사용됩니다. 추가 하위 속성 유형을 사용하면 매핑에 사용된 JSON 요소는 다음과 같이 검증됩니다.
{ "phoneNumbers": [ { "type": "home", "value": "+13175551234" }, { "type": "mobile", "value": "+13175554321" } ] }