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.dateHire | UserProfile.hr.hireDate.[0].value | 고용 날짜는 YYYY-MM-DD 형식입니다. ISO8601 형식을 허용하지만 항상 YYYY-MM-DD 형식으로 DATE 부분을 반환합니다. 전체 URN: urn:ietf:params:scim:schemas: extension:enterprise:2.0: User:dateHire |
| 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"
}
]
}
