SCIM und Genesys Cloud Feldzuordnungen
Diese Tabelle zeigt die SCIM-Felder, die Genesys Cloud SCIM (Identity Management) auf Genesys Cloud-Felder abbildet. Diese SCIM-Felder werden dann Feldern in Drittanwendungen zugeordnet.
SCIM-Feld | Genesys Cloud Call | Notizen |
---|---|---|
id | BenutzerProfil.Id | |
Benutzername | UserProfile.contactInfo.email_main.[0].value | |
Status | UserProfile.state true eq 'aktiv' false eq 'inaktiv' | |
Anzeigename | UserProfile.general.name.[0].value | |
Titel | UserProfile.general.title.[0].value | |
scimEnterpriseUser.manager.value | UserProfile.relationships.manager.[0].value | Vollständige URN: urn:ietf:params:scim:schemas: extension:enterprise:2.0: Benutzer:manager.wert |
scimEnterpriseUser.abteilung | UserProfile.general.department.[0].value | Vollständige URN: urn:ietf:params:scim:schemas: extension:enterprise:2.0: Benutzer:Abteilung |
scimEnterpriseUser.division | UserProfile.divisionId | Vollständige URN: urn:ietf:params:scim:schemas: extension:enterprise:2.0: Geschäftsbereich des Benutzers |
emails[type eq "andere"].value | UserProfile.contactInfo.email_main.[0].value | Dieses Feld ist dasselbe wie der Benutzername. Dieses Feld ist schreibgeschützt. Hinweis: Sehen Filtern von mehrwertigen Attributen . |
emails[type eq "work"].value | UserProfile.contactInfo.email_work.[0].value | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " Arbeit< " ].Wert | UserProfile.contactInfo.[0].phone_work.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " Arbeit2 " ].Wert | UserProfile.contactInfo.[0].phone_work_2.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " Arbeit3 " ].Wert | UserProfile.contactInfo.[0].phone_work_3.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " Arbeit4 " ].Wert | UserProfile.contactInfo.[0].phone_work_4.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " heim " ].Wert | UserProfile.contactInfo.[0].phone_home.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " andere " ].Wert | UserProfile.contactInfo.[0].phone_other.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
Telefonnummern[Typ eq " Mobile " ].Wert | UserProfile.contactInfo.[0].phone_mobile.[0].value.number | Notiz : Sehen Filtern von mehrwertigen Attributen . |
meta.standort | {Benutzerprofil selbst URL} | |
meta.version (ETag) | BenutzerProfil.Version | |
meta.lastModified | UserProfile.dateModified | |
externalId | {externe ID API} | |
rollen.[].Wert | {Benutzerrollen API} | Notiz : Sehen Mehrwertige Attributfelder . |
name.givenName | — | Wird derzeit nicht von Genesys Cloud unterstützt. |
name.familienname | — | Wird derzeit nicht von Genesys Cloud unterstützt. |
addresses[type eq "work"].postalCode | — | Wird derzeit von Genesys Cloud nicht unterstützt. |
adressen[Typ eq "andere"].Formatiert | — | Wird derzeit nicht von Genesys Cloud unterstützt. |
addresses[type eq "work"].streetAddress | — | Wird derzeit nicht von Genesys Cloud unterstützt. |
emails[type eq "{type}"].primary | UserProfile.primaryContactInfo.email.[0].value.fieldPath |
Dieses Feld ist in der Anbieterzuordnung auf die boolesche Konstante "true" gesetzt Notiz : Sehen Filtern von mehrwertigen Attributen . |
phoneNumbers[type eq "{type}"].primary | UserProfile.primaryContactInfo.voice.[0].value.fieldPath |
Dieses Feld legt die dem Feld zugeordnete Telefonnummer als primäre Telefonnummer in den Kontaktinformationen des Benutzers fest. Dieses Feld wird auf die Boolesche Konstante gesetzt " WAHR " in der Lieferantenzuordnung. Notiz : Sehen Filtern von mehrwertigen Attributen . |
Gruppen | UserProfile.groups[type eq official] + {groups where user is owner} | |
Kennwort | Benutzerprofil | Das Passwort kann nicht zurückgegeben werden, kann aber mit PUT oder PATCH aktualisiert werden. |
scimEnterpriseUser.employeeNumber | BenutzerProfil.hr.empId.[0].Wert | Vollständige URN: urn:ietf:params:scim:schemas: extension:enterprise:2.0: Benutzer:MitarbeiterNummer |
scimUserExtensions. routingSkills.[].name |
(Benutzer-Routing-Fähigkeiten API) |
Vollständige URN: urn:ietf:params:scim:schemas: Notiz : Sehen Mehrwertige Attributfelder . |
scimUserExtensions. routingSkills.[].proficiency |
(Benutzer-Routing-Fähigkeiten API) |
Vollständige URN: urn:ietf:params:scim:schemas: Notiz : Sehen Mehrwertige Attributfelder . |
scimUserExtensions. routingLanguages.[].name |
(User Routing Languages API) |
Vollständige URN: urn:ietf:params:scim:schemas: Notiz : Sehen Mehrwertige Attributfelder . |
scimUserExtensions. routingLanguages.[].proficiency |
(User Routing Languages API) |
Vollständige URN: urn:ietf:params:scim:schemas: Notiz : Sehen Mehrwertige Attributfelder . |
Mehrwertige Attributfelder
In der SCIM- und Genesys Cloud-Feldzuordnungstabelle sind nur die wesentlichen Unterattribute aufgeführt, die für jede Zuordnung erforderlich sind. Während zusätzliche Unterattribute verfügbar sind, wie in RFC 7643 Abschnitt 2.4 , in der Tabelle sind nur die wichtigsten aufgeführt. Eine umfassende Liste der Unterattribute für jedes mehrwertige Attribut finden Sie in der SCIM-Spezifikation.
Die SCIM-Felder mit mehrwertigen Attributen folgen diesem Format:
<attribute>.[].<subattribute>
Wo<attribute> bezieht sich auf die Elemente in der mehrwertigen Attributliste und<subattribute> gibt das spezifische Unterattribut jedes Elements an, das für die Zuordnung erforderlich ist.
Das allgemeine JSON-Schema für dieses Format ist:
{ "$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" } } } ] } } }
Verwenden Sie einen der Online-JSON-Schema-Validatoren, um das JSON-Schema für die Verweise auf mehrwertige Attributwerte in der Zuordnung in der Tabelle zu validieren. Beispielsweise in derroles.[].value
Abbildung,roles
repräsentiert<attribute> Undvalue
repräsentiert<subattribute> .
Das JSON-Element für dieroles.[].value
Die Zuordnung wird daher wie folgt validiert:
{ "roles": [ { "other": "this is allowed but doesn’t contribute to the roles mapping", "value": "Role1" }, { "value": "Role2" } ] }
Filtern von mehrwertigen Attributen
Einige SCIM-Attribute mit mehreren Werten erfordern die Zuordnung eines bestimmten Listenelements zu einem Genesys Cloud-Feld. In diesen Fällen wird ein zusätzliches Unterattribut als Filterfeld für die Liste angegeben. Dieses Filterfeld wird zu einem obligatorischen Unterattribut für dieses Element.
Beispielsweise in derphoneNumbers[type eq "home"].value
Feld,phoneNumbers
repräsentieren die<attribute> ,value
repräsentiert die<subattribute> , Undtype
ist das Extra<subattribute> wird zum Filtern verwendet. Im Gegensatz zu den Standardmappings, die keinen Filter benötigen,type
Das Unterattribut wird verwendet, um den richtigen Telefonnummerneintrag in der Liste zu identifizieren und daran zu binden. Mit dem zusätzlichen Unterattributtyp wird das für die Zuordnung verwendete JSON-Element wie folgt validiert:
{ "phoneNumbers": [ { "type": "home", "value": "+13175551234" }, { "type": "mobile", "value": "+13175554321" } ] }