SCIM 및 Genesys Cloud 필드 매핑

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

이 표는 Genesys Cloud SCIM(Identity Management)이 Genesys Cloud 필드에 매핑하는 SCIM 필드를 보여줍니다. 그런 다음 이러한 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" 
     }
   ]
 }