PureCloud champs SCIM et PureCloud
Ce tableau montre les champs SCIM que PureCloud SCIM (Identity Management) mappe aux champs PureCloud. Ces champs SCIM sont ensuite mappés à des champs dans les applications des participant tiers.
Champ SCIM | Champ Genesys Cloud | Notes |
---|---|---|
identifiant | UserProfile.Id | |
Nom d’utilisateur | UserProfile.contactInfo.email_main.[0].value | |
État | UserProfile.state vrai eq 'actif' faux eq 'inactif' | |
Afficher un nom | UserProfile.general.name.[0].value | |
titre | UserProfile.general.title.[0].value | |
scimEnterpriseUser.manager.value | UserProfile.relationsships.manager.[0].value | URN complet : urn:ietf:params:scim:schemas : extension:entreprise:2.0: Utilisateur : manager.value |
scimEnterpriseUser.department | UserProfile.general.department.[0].value | URN complet : urn:ietf:params:scim:schemas : extension:entreprise:2.0: User.department |
scimEnterpriseUser.division | UserProfile.divisionId | URN complet : urn:ietf:params:scim:schemas : extension:entreprise:2.0: Utilisateur.division |
e-mails[type eq "autre"].valeur | UserProfile.contactInfo.email_main.[0].value | Ce champ est identique à userName. Ce champ est en lecture seule. Remarque : Voir Filtrer les attributs multivalués. |
e-mails[type eq "travail"].valeur | UserProfile.contactInfo.email_work.[0].value | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "work<"].value | UserProfile.contactInfo.[0].phone_work.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "work2"].value | UserProfile.contactInfo.[0].phone_work_2.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "work3"].value | UserProfile.contactInfo.[0].phone_work_3.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "work4"].value | UserProfile.contactInfo.[0].phone_work_4.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "home"].value | UserProfile.contactInfo.[0].phone_home.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "other"].value | UserProfile.contactInfo.[0].phone_other.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
phoneNumbers[type eq "mobile"].value | UserProfile.contactInfo.[0].phone_mobile.[0].value.number | Note: Voir Filtrer les attributs multivalués. |
meta.location | {UserProfile auto-URL} | |
meta.version (ETag) | UserProfile.version | |
meta.lastModified | UserProfile.dateModified | |
ID externe | {API d'identification externe} | |
rôles. [].valeur | {API rôles utilisateur} | Note: Voir Champs d'attributs multivalués. |
nom.nom donné | — | Non pris en charge actuellement par Genesys Cloud. |
nom.familleName | — | Non pris en charge actuellement par Genesys Cloud. |
adresses[type eq "travail"].code postal | — | Non pris en charge actuellement par Genesys Cloud. |
adresses[type eq "autre"].Formaté | — | Non pris en charge actuellement par Genesys Cloud. |
adresses[type eq "travail"].Adresse de la rue | — | Non pris en charge actuellement par Genesys Cloud. |
e-mails[type eq "{taper}"].primaire | UserProfile.primaryContactInfo.email.[0].value.fieldPath |
Ce champ est défini sur une constante booléenne "vrai" dans la cartographie des fournisseurs. Note: Voir Filtrer les attributs multivalués. |
Numéros de téléphone[type eq "{taper}"].primaire | UserProfile.primaryContactInfo.voice.[0].value.fieldPath |
Ce champ désigne le numéro de téléphone associé au champ comme numéro de téléphone principal dans les coordonnées de l'utilisateur. Ce champ correspond à la constante booléenne "true" dans le mappage du fournisseur. Note: Voir Filtrer les attributs multivalués. |
groupes | UserProfile.groups[type eq official] + {groupes où l'utilisateur est propriétaire} | |
mot de passe | Des profils d’utilisateurs | Le mot de passe ne peut pas être retourné mais peut être mis à jour avec PUT ou PATCH. |
scimEnterpriseUser.employeeNumber | UserProfile.hr.empId.[0].value | URN complet : urn:ietf:params:scim:schemas : extension:entreprise:2.0: Utilisateur.employeeNumber |
scimUserExtensions. RoutingSkills.[].name |
{API de compétences de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : Note: Voir Champs d'attributs multivalués. |
scimUserExtensions. Compétences de routage.[].compétence |
{API de compétences de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : Note: Voir Champs d'attributs multivalués. |
scimUserExtensions. routageLangues.[].nom |
{API des langages de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : Note: Voir Champs d'attributs multivalués. |
scimUserExtensions. routageLangues.[].compétence |
{API des langages de routage utilisateur} |
URN complet : urn:ietf:params:scim:schemas : Note: Voir Champs d'attributs multivalués. |
Champs d'attributs à valeurs multiples
Le tableau de correspondance des champs SCIM et Genesys Cloud ne répertorie que les sous-attributs essentiels requis pour chaque correspondance. Bien que des sous-attributs supplémentaires soient disponibles, tels que définis dans RFC 7643 Section 2.4, seuls les sous-attributs essentiels sont énumérés dans le tableau. Pour obtenir une liste complète des sous-attributs d'un attribut à valeurs multiples, il convient de se référer à la spécification SCIM.
Les champs SCIM à attributs multiples suivent ce format :
<attribute>.[].<subattribute>
Où <attribute> fait référence aux éléments de la liste d'attributs multivalués et <subattribute> indique le sous-attribut spécifique de chaque élément qui est requis pour la mise en correspondance.
Le schéma JSON générique pour ce format est le suivant :
{ "$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" } } } ] } } }
Utilisez l'un des validateurs de schéma JSON en ligne pour valider le schéma JSON pour les références d'attributs multivalués dans le mappage du tableau. Par exemple, dans la correspondance roles.[].value
, roles
représente <attribute> et value
représente <subattribute>.
L'élément JSON pour le mappage roles.[].value
est donc validé comme suit :
{ "roles": [ { "other": "this is allowed but doesn’t contribute to the roles mapping", "value": "Role1" }, { "value": "Role2" } ] }
Filtrer les attributs à valeurs multiples
Certains attributs SCIM à valeurs multiples nécessitent la mise en correspondance d'un élément de liste spécifique avec un champ Genesys Cloud. Dans ce cas, un sous-attribut supplémentaire est spécifié comme champ de filtrage pour la liste. Ce champ de filtre devient un sous-attribut obligatoire pour cet élément.
Par exemple, dans le champ phoneNumbers[type eq "home"].value
, phoneNumbers
représente le <attribute>, value
représente le <subattribute>, et type
est le <subattribute> supplémentaire utilisé pour le filtrage. Contrairement aux correspondances standard qui ne nécessitent pas de filtre, le sous-attribut type
est utilisé pour identifier et lier l'entrée du numéro de téléphone correct dans la liste. Avec le type de sous-attribut supplémentaire, l'élément JSON utilisé pour le mappage est validé comme suit :
{ "phoneNumbers": [ { "type": "home", "value": "+13175551234" }, { "type": "mobile", "value": "+13175554321" } ] }