SCIM 和 Genesys Cloud 字段映射
下表显示了 Genesys Cloud SCIM(身份管理)映射到 Genesys Cloud 字段的 SCIM 字段。 然后,这些 SCIM 字段将映射到第三方应用程序中的字段。
| SCIM 字段 | Genesys Cloud 呼叫 | 注释 |
|---|---|---|
| id | 用户身份 | |
| 用户名 | User.contactInfo.email_main.[0].value | |
| 状态 | 用户状态 true 等于 '活动' false 等于 '非活动' | |
| 显示名称 | 用户.常规.名称.[0].值 | |
| 标题 | 用户.常规.标题.[0].值 | |
| scimEnterprise User.manager.value | 用户.关系.管理器.[0].值 | 完整的 URN: urn: ietf:params: scims: 模式: 扩展名:企业版:2.0: 用户:经理。值 |
| scimEnterpriseUser.dateHire | User.hr.hireDate.[0].value | 雇用日期的格式为 YYYY-MM-DD。接受 ISO8601 格式,但始终以 YYYY-MM-DD 格式返回 DATE 部分。 完整 URN:urn:ietf:params:scim:schemas: extension:enterprise:2.0: User:dateHire |
| scimEnterprise 用户。部门 | 用户.常规.部门.[0].值 | 完整的 URN: urn: ietf:params: scims: 模式: 扩展名:企业版:2.0: 用户:部门 |
| scimEnterprise User.Division | 用户.部门ID | 完整的 URN: urn: ietf:params: scims: 模式: 扩展名:企业版:2.0: 用户分部 |
| 电子邮件 [键入 eq "other"] .value | User.contactInfo.email_main.[0].value | 此字段与userName相同。此字段为只读。 注意:看过滤多值属性。 |
| 电子邮件 [键入 eq "work"] .value | User.contactInfo.email_work.[0].value | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "work<"].value | 用户.联系信息.[0].工作电话.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "work2"].value | 用户.联系信息.[0].工作电话_2.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "work3"].value | 用户.联系信息.[0].工作电话_3.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "work4"].value | 用户.联系信息.[0].工作电话_4.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "home"].value | 用户.联系信息.[0].家庭电话.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "other"].value | 用户.联系信息.[0].其他电话.[0].值.号码 | 笔记:看过滤多值属性。 |
| phoneNumbers[type eq "mobile"].value | 用户.联系信息.[0].手机.[0].值.号码 | 笔记:看过滤多值属性。 |
| meta.location | 用户自身网址 | |
| meta.version (ETag) | 用户版本 | |
| meta.Last 修改 | 用户.修改日期 | |
| 外部 ID | {外部 ID API} | |
| 角色。[] .value | {用户角色 API} | 笔记:看多值属性字段。 |
| 名称 .GivenName | — | Genesys Cloud 目前不支持。 |
| 姓名。姓氏 | — | Genesys Cloud 目前不支持。 |
| 地址 [键入 eq "work"]。邮政编码 | — | Genesys Cloud 目前不支持。 |
| 地址 [键入 eq "other"]。已格式化 | — | Genesys Cloud 目前不支持。 |
| 地址 [键入 eq "work"]。街道地址 | — | Genesys Cloud 目前不支持。 |
| 电子邮件 [键入 eq "{type}"]。主 | User.primaryContactInfo.email.[0].value.fieldPath |
在供应商映射中,此字段设置为布尔常量 “true”。 笔记:看过滤多值属性。 |
| 电话号码 [键入 eq "{type}"]。主 | User.primaryContactInfo.voice.[0].value.fieldPath |
此字段将与该字段关联的电话号码指定为用户联系信息上的主要电话号码。该字段设置为布尔常量“真的“在供应商映射中。 笔记:看过滤多值属性。 |
| 组 | 用户.groups[type eq official] + {用户是所有者的组} | |
| 密码 | 用户资料 | 无法返回密码,但可以使用 PUT 或 PATCH 进行更新。 |
| scimEnterprise User.雇员数/员工数量 | User.hr.empId.[0].value | 完整的 URN: urn: ietf:params: scims: 模式: 扩展名:企业版:2.0: 用户:员工编号 |
| scimuseExtensions。 路由技能。[]. name |
{用户路由技能 API} |
完整的 URN: urn: ietf:params: scims: 模式: 笔记:看多值属性字段。 |
| scimuseExtensions。 路由技能。[]. 熟练程度 |
{用户路由技能 API} |
完整的 URN: urn: ietf:params: scims: 模式: 笔记:看多值属性字段。 |
| scimuseExtensions。 路由语言。[]. 名称 |
{用户路由语言 API} |
完整的 URN: urn: ietf:params: scims: 模式: 笔记:看多值属性字段。 |
| scimuseExtensions。 路由语言。[]. 熟练 |
{用户路由语言 API} |
完整的 URN: urn: ietf:params: scims: 模式: 笔记:看多值属性字段。 |
多值属性字段
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"
}
]
}
