SCIM 및 Genesys Cloud 필드 매핑

참고: 이 문서는 Genesys Cloud SCIM(Identity Management)에 적용됩니다.

이 표는 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:스키마:
확장:genesys:purecloud:2.0:
사용자:routingSkills.[].name

메모 : 보다 다중 값 속성 필드 .

scimUserExtensions.
routingSkills.[].숙련도
{사용자 라우팅 기술 API}

전체 URN: urn:ietf:params:scim:스키마:
확장:genesys:purecloud:2.0:
사용자:routingSkills.[].proficiency

메모 : 보다 다중 값 속성 필드 .

scimUserExtensions.
라우팅 언어.[].이름
{사용자 라우팅 언어 API}

전체 URN: urn:ietf:params:scim:스키마:
확장:genesys:purecloud:2.0:
사용자:routingLanguages.[].name

메모 : 보다 다중 값 속성 필드 .

scimUserExtensions.
라우팅 언어.[].숙련도
{사용자 라우팅 언어 API}

전체 URN: urn:ietf:params:scim:스키마:
확장:genesys:purecloud:2.0:
사용자:routingLanguages.[].proficiency

메모 : 보다 다중 값 속성 필드 .

다중 값 속성 필드

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" 
     }
   ]
 }