Asignaciones de campos de SCIM y Genesys Cloud
Esta tabla muestra los campos SCIM que Genesys Cloud SCIM (Gestión de identidad) asigna a los campos Genesys Cloud. Estos campos SCIM luego se asignan a campos en aplicaciones de terceros.
Campo SCIM | Campo de Genesys Cloud | Notas |
---|---|---|
identificación | UserProfile.Id | |
nombre de usuario | UserProfile.contactInfo.email_main. [0] .value | |
estado | UserProfile.state true eq 'active' false eq 'inactive' | |
nombre para mostrar | UserProfile.general.name. [0] .value | |
título | UserProfile.general.title. [0] .value | |
scimEnterpriseUser.manager.value | UserProfile.relationships.manager. [0] .value | URN completo: urn: ietf: params: scim: esquemas: extensión: empresa: 2.0: Usuario: manager.value |
scimEnterpriseUser.department | UserProfile.general.department. [0] .value | URN completo: urn: ietf: params: scim: esquemas: extensión: empresa: 2.0: Usuario: departamento |
scimEnterpriseUser.division | UserProfile.divisionId | URN completo: urn: ietf: params: scim: esquemas: extensión: empresa: 2.0: Usuario: division |
correos electrónicos [escriba eq "otro"].valor | UserProfile.contactInfo.email_main. [0] .value | Este campo es el mismo que userName. Este campo es de sólo lectura. Nota: Véase Filtrar atributos multivaluados. |
correos electrónicos [escriba eq "trabaja"].valor | UserProfile.contactInfo.email_work. [0] .value | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "work<"].value | UserProfile.contactInfo. [0] .phone_work. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "work2"].value | UserProfile.contactInfo. [0] .phone_work_2. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "work3"].value | UserProfile.contactInfo. [0] .phone_work_3. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "work4"].value | UserProfile.contactInfo. [0] .phone_work_4. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "home"].value | UserProfile.contactInfo. [0] .phone_home. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "other"].value | UserProfile.contactInfo. [0] .phone_other. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers[type eq "mobile"].value | UserProfile.contactInfo. [0] .phone_mobile. [0] .value.number | Nota: Véase Filtrar atributos multivaluados. |
meta.location | {URL propia de UserProfile} | |
meta.version (ETag) | UserProfile.version | |
meta.lastModified | UserProfile.dateModified | |
externalId | {API de ID externa} | |
roles. []. valor | {API de roles de usuario} | Nota: Véase Campos de atributos multivaluados. |
name.givenName | — | Actualmente no es compatible con Genesys Cloud. |
name.familyName | — | Actualmente no es compatible con Genesys Cloud. |
direcciones [escriba eq "trabaja"].código postal | — | Actualmente no es compatible con Genesys Cloud. |
direcciones [escriba eq "otro"] .Formateado | — | Actualmente no es compatible con Genesys Cloud. |
direcciones [escriba eq "trabaja"].Dirección | — | Actualmente no es compatible con Genesys Cloud. |
correos electrónicos [escriba eq "{escribe}"].primario | UserProfile.primaryContactInfo.email. [0] .value.fieldPath |
Este campo se establece en constante booleana "cierto" en el mapeo de proveedores. Nota: Véase Filtrar atributos multivaluados. |
phoneNumbers [type eq "{escribe}"].primario | UserProfile.primaryContactInfo.voice. [0] .value.fieldPath |
Este campo designa el número de teléfono asociado al campo como número de teléfono principal en la información de contacto del usuario. Este campo se establece en la constante booleana "true" en la asignación de proveedores. Nota: Véase Filtrar atributos multivaluados. |
grupos | UserProfile.groups [type eq official] + {grupos donde el usuario es propietario} | |
contraseña | Perfil del usuario | La contraseña no se puede devolver, pero se puede actualizar con PUT o PATCH. |
scimEnterpriseUser.employeeNumber | UserProfile.hr.empId. [0] .value | URN completo: urn: ietf: params: scim: esquemas: extensión: empresa: 2.0: Usuario: employeeNumber |
scimUserExtensions. routingSkills. []. nombre |
{API de habilidades de enrutamiento del usuario} |
URN completo: urn: ietf: params: scim: esquemas: Nota: Véase Campos de atributos multivaluados. |
scimUserExtensions. routingSkills. []. proficiency |
{API de habilidades de enrutamiento del usuario} |
URN completo: urn: ietf: params: scim: esquemas: Nota: Véase Campos de atributos multivaluados. |
scimUserExtensions. routingLanguages. []. nombre |
{API de lenguajes de enrutamiento de usuario} |
URN completo: urn: ietf: params: scim: esquemas: Nota: Véase Campos de atributos multivaluados. |
scimUserExtensions. routingLanguages. []. proficiency |
{API de lenguajes de enrutamiento de usuario} |
URN completo: urn: ietf: params: scim: esquemas: Nota: Véase Campos de atributos multivaluados. |
Campos de atributos multivaluados
La tabla de asignaciones de campos de SCIM y Genesys Cloud enumera únicamente los subatributos esenciales necesarios para cada asignación. Aunque existen subatributos adicionales definidos en RFC 7643 Sección 2.4, en la tabla sólo se enumeran los esenciales. Para obtener una lista completa de los subatributos de cualquier atributo multivaluado, consulte la especificación SCIM.
Los campos SCIM de atributos multivaluados siguen este formato:
<attribute>.[].<subattribute>
Donde <attribute> se refiere a los elementos de la lista de atributos multivaluados y <subattribute> indica el subatributo específico de cada elemento que se requiere para la asignación.
El esquema JSON genérico para este formato es:
{ "$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" } } } ] } } }
Utilice cualquiera de los validadores de esquema JSON en línea para validar el esquema JSON para las referencias de atributos multivaluados en la asignación de la tabla. Por ejemplo, en la correspondencia roles.[].value
, roles
representa <attribute> y value
representa <subattribute>.
Por lo tanto, el elemento JSON para el mapeo roles.[].value
se valida de la siguiente manera:
{ "roles": [ { "other": "this is allowed but doesn’t contribute to the roles mapping", "value": "Role1" }, { "value": "Role2" } ] }
Filtrar atributos multivaluados
Algunos atributos multivaluados SCIM requieren la asignación de un elemento específico de la lista a un campo de Genesys Cloud. En estos casos, se especifica un subatributo adicional como campo de filtro de la lista. Este campo de filtro se convierte en un subatributo obligatorio para ese elemento.
Por ejemplo, en el campo phoneNumbers[type eq "home"].value
, phoneNumbers
representa el <attribute>, value
representa el <subattribute>, y type
es el <subattribute> extra utilizado para el filtrado. A diferencia de las correspondencias estándar que no necesitan filtro, el subatributo type
se utiliza para identificar y vincular la entrada del número de teléfono correcto en la lista. Con el tipo de subatributo extra, el elemento JSON utilizado para el mapeo se valida de la siguiente manera:
{ "phoneNumbers": [ { "type": "home", "value": "+13175551234" }, { "type": "mobile", "value": "+13175554321" } ] }