SCIM 和 Genesys Cloud 字段映射

注意: 本文适用于 Genesys Cloud SCIM(身份管理)。

下表显示了 Genesys Cloud SCIM(身份管理)映射到 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" 
     }
   ]
 }