Préparez-vous à transférer vos cartes SCIM TravelPerk et Yokoy vers Perk SCIM.

Cet article vous aide à préparer la fusion de vos deux intégrations SCIM actuelles (TravelPerk SCIM pour les voyages et Yokoy SCIM pour les dépenses) en une seule intégration Perk SCIM. Il explique les différences entre votre configuration actuelle et le nouveau modèle, afin que vous puissiez rassembler des informations précises sur votre configuration SCIM et les partager avec votre interlocuteur Perk.

Rôle : Les administrateurs de compte et les administrateurs informatiques ou d'identité peuvent effectuer cette tâche.

Avant de commencer

Cet article vous aide à préparer la fusion de vos deux intégrations SCIM actuelles (TravelPerk SCIM pour les voyages et Yokoy SCIM pour les dépenses) en une seule intégration Perk SCIM. Il explique les différences entre votre configuration actuelle et le nouveau modèle, afin que vous puissiez rassembler des informations précises sur votre configuration SCIM et les partager avec votre interlocuteur Perk.

Remarque : Le provisionnement des utilisateurs SCIM est une fonctionnalité Premium ou Pro de Perk.

Comment votre configuration actuelle se compare-t-elle au nouveau Perk SCIM ?

TravelPerk SCIM, votre intégration actuelle côté voyages, est transférée vers Perk SCIM quasiment sans modification. TravelPerk SCIM utilise le schéma de base SCIM, l'extension entreprise (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User), et une extension Perk personnalisée (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) pour les champs spécifiques aux voyages comme travelPolicy, profils de factures, et lineManagerEmailPerk SCIM conserve le même schéma de base, la même extension d'entreprise et la même extension Perk personnalisée ; la plupart de vos mappages d'attributs de voyage existants restent donc inchangés. La véritable nouveauté réside dans l'extension de dépenses (urn:ietf:params:scim:schemas:extension:expense:2.0:User).TravelPerk SCIM n'a jamais intégré cette extension, car la gestion des dépenses n'en faisait pas partie. Perk SCIM l'ajoute spécifiquement pour couvrir tous les aspects des dépenses actuellement gérés par votre intégration Yokoy SCIM : politiques de dépenses, entités juridiques et seuils d'approbation, par exemple. L'extension de dépenses de Perk repose sur la même logique que l'extension personnalisée de Yokoy ; il s'agit du même principe, repris au sein de la plateforme Perk. C'est pourquoi les noms d'attributs de l'extension de dépenses vous sembleront familiers si vous avez déjà configuré Yokoy SCIM : policyId, créancier, legalEntityId, seuil d'approbationet ignoreManagerInRequests Tous réapparaissent avec les mêmes noms et les mêmes concepts.

Partagez vos charges utiles SCIM actuelles

Le partage de vos données SCIM actuelles permet à Perk de recueillir des informations précises sur votre configuration avant de vous indiquer les réglages à effectuer. Avant toute décision de votre part ou de celle de l'équipe Perk, Perk doit visualiser exactement les données que votre fournisseur d'identité envoie actuellement à TravelPerk SCIM et à Yokoy SCIM.

Conseil : Certains clients de Perk consignent ces informations dans un tableur partagé, avec un onglet pour TravelPerk SCIM et un autre pour Yokoy SCIM. Cela permet à votre contact Perk de comparer facilement les deux.

Voici comment fonctionne le processus :

  1. Exportez ou documentez la charge utile SCIM que votre fournisseur d'identité envoie actuellement à TravelPerk SCIM.
  2. Exportez ou documentez la charge utile SCIM que votre fournisseur d'identité envoie actuellement à Yokoy SCIM.
  3. Partagez les deux fichiers utiles avec votre contact Perk.
  4. L'équipe de Perk examine vos charges utiles et vous renvoie les valeurs exactes et le mappage des attributs à utiliser dans Perk SCIM, ainsi que toutes les modifications que vous devez apporter à votre fournisseur d'identité.

Il s'agit d'une étape de collecte de données, et non de configuration. Vous ne définissez pas vous-même les valeurs finales : vous fournissez à Perk des informations précises sur votre configuration actuelle afin que leur équipe puisse vous indiquer exactement les valeurs à utiliser.

Comparaison des attributs : Yokoy SCIM et l'extension des dépenses Perk

L'extension de gestion des dépenses Perk couvre les mêmes fonctionnalités que votre intégration SCIM Yokoy actuelle ; il est donc utile de les comparer. Utilisez ce tableau pour vérifier que vos attributs Yokoy actuels correspondent bien à leurs équivalents SCIM Perk les plus proches lors de la documentation de votre charge utile Yokoy pour Perk.

Attribut SCIM de Yokoy Perk SCIM Attribut Notes
ID id (schéma de base) Ce sont deux identifiants en lecture seule attribués par le serveur.
externalId externalId (schéma de base) Même concept dans les deux cas : un identifiant défini par le client. Non requis dans les deux cas.
actif actif (schéma de base) Booléen dans les deux cas. Requis dans Perk SCIM ; non explicitement requis dans Yokoy.
nom d'utilisateur nom d'utilisateur (schéma de base) L'adresse e-mail de l'utilisateur, utilisée comme identifiant. Obligatoire dans les deux cas.
emails[type eq "travail"].valeur emails (schéma de base) Requis dans Yokoy. E-mails de Perk est un tableau et n'est pas obligatoire, bien qu'il soit recommandé de l'envoyer — par exemple, sarah@example.com.
nom.prénom nom.givenName (schéma de base) Obligatoire dans les deux cas.
nom.nom de famille nom.nom de famille (schéma de base) Obligatoire dans les deux cas.
Langue préférée Langue préférée et locale Yokoy utilise un champ combiné (par exemple, de-chPerk sépare la langue et les paramètres régionaux en deux champs. Voir Langue de l'utilisateur.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber Dans Yokoy, cela nécessite un champ personnalisé nommé employeeNumber Configurez d'abord cette valeur dans les paramètres de l'entreprise, sinon elle n'apparaîtra jamais dans l'interface utilisateur de Yokoy. Numéro d'employé de l'Perk SCIM est intégré — aucune configuration de champ personnalisé n’est nécessaire.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:creditor urn:ietf:params:scim:schemas:extension:expense:2.0:User:creditor Le principe est le même dans les deux cas : le compte comptable sert à enregistrer les dépenses à titre privé. Il n’est obligatoire dans aucun des deux cas.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization Aucun équivalent direct Voir Considérations clés.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter Même nom de champ dans les deux cas. Voir Objets de coûts, politiques et gestionnaires pour une mise en garde concernant la cartographie à signaler avec Perk.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value manager.value ou lineManagerEmail Yokoy fonctionne uniquement avec un identifiant. Perk prend en charge un gestionnaire basé sur un identifiant. ou un lineManagerEmail par e-mail. Voir Objets de coûts, politiques et gestionnaires.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:legalEntityId urn:ietf:params:scim:schemas:extension:expense:2.0:User:legalEntityId Même principe appliqué à l'extension des dépenses. Obligatoire dans Yokoy ; non requis dans Perk SCIM. Permet d'identifier l'entreprise à laquelle l'utilisateur est rattaché.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:policyId urn:ietf:params:scim:schemas:extension:expense:2.0:User:policyId Associe l'utilisateur à une politique de dépenses dans les deux systèmes. À ne pas confondre avec la politique de voyage distincte de Perk (travelPolicy). champ — voir Objets de coûts, politiques et gestionnaires.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:approvalThreshold urn:ietf:params:scim:schemas:extension:expense:2.0:User:approvalThreshold Même principe dans les deux cas : une limite d’approbation, envoyée sous forme décimale. Optionnel dans les deux cas.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:ignoreManagerInRequests urn:ietf:params:scim:schemas:extension:expense:2.0:User:ignoreManagerInRequests Même concept booléen dans les deux cas. Optionnel dans les deux cas.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:customData0–customData3 Aucun équivalent direct Voir Considérations clés.

Objets de coûts, politiques et gestionnaires

Certains attributs du tableau ci-dessus nécessitent plus de contexte avant d'être décrits avec précision à Perk, car la correspondance n'est pas purement mécanique.

  • Objets de coûts. Le champ costCenter de Yokoy transmet les codes d'objets de coûts qui doivent déjà exister dans Yokoy avant l'attribution d'une valeur à un utilisateur. Yokoy ne crée pas automatiquement d'objets de coûts à partir des données SCIM. Perk crée automatiquement un objet de coût, tel que « Marketing », s'il n'existe pas déjà.
  • Politique de dépenses vs. politique de voyage. L'identifiant `policyId` de Yokoy associe un utilisateur à une politique de dépenses. Perk SCIM conserve cet identifiant sous le nom `policyId` dans l'extension de dépenses, mais Perk dispose également d'un champ distinct `travelPolicy` dans son extension personnalisée. Ce champ doit déjà exister dans Perk et couvre spécifiquement la politique de voyage. Il s'agit de deux champs différents, couvrant deux domaines distincts. Si votre organisation utilise les deux, veuillez documenter les deux valeurs lorsque vous partagez votre configuration avec Perk.
  • Responsables et approbateurs. Dans Yokoy, la propriété `manager.value` est basée sur l'identifiant, et le responsable hiérarchique de l'utilisateur devient automatiquement son approbateur. Le schéma d'entreprise de Yokoy ne prévoit pas de notion d'approbateur distincte. Si aucun responsable n'est encore défini dans Yokoy, un utilisateur factice est créé. Toute personne sans responsable hiérarchique, comme un PDG, doit être désignée comme responsable hiérarchique. Perk SCIM offre deux méthodes pour désigner un responsable : `manager.value` (par identifiant utilisateur Perk) ou `lineManagerEmail` (par e-mail, conçu pour les fournisseurs d'identité comme Okta qui ne peuvent pas référencer les utilisateurs par leur identifiant interne). Lorsque vous partagez votre configuration avec Perk, veuillez indiquer laquelle de ces méthodes est prise en charge par votre fournisseur d'identité, afin que Perk configure la méthode appropriée.
Avertissement : Le champ approvers de l’extension personnalisée Perk n’est pas disponible pour les comptes Perk créés après le 1er juillet 2024 ; il renvoie une erreur sur ces comptes. Il est remplacé par manager et lineManagerEmail. Si votre compte a été créé après cette date, n’incluez pas approvers dans les informations que vous partagez avec Perk.

Considérations clés

Gardez ces points à l'esprit lors de la préparation de vos charges utiles pour Perk.

Ce qu'il contient

L'organisation L'attribut est un identifiant Yokoy obligatoire et constant pour l'organisation de l'utilisateur. Il est copié une seule fois depuis l'interface d'administration Yokoy et réutilisé pour chaque utilisateur. Dans Perk, votre compte n'est pas identifié par un attribut dans la charge utile ; l'identification est implicite dans l'URL de base et la clé API que vous utilisez..

Remarque : Ne confondez pas cela avec la société séparée et facultative Ce champ sert à sous-limiter les utilisateurs par nom d'entreprise au sein d'un même compte Perk qui couvre plusieurs entreprises ; il ne représente pas le compte lui-même.

Langue de l'utilisateur

Yokoy combine la langue et les paramètres régionaux en un seul preferredLanguage champ, par exemple de-ch. Perk SCIM divise cela en deux champs : preferredLanguage pour la langue elle-même, et une locale distincte Champ utilisé uniquement lors de la création, que Perk divise en fonction du tiret ou du trait de soulignement pour déterminer le pays et la devise. Documentez les deux parties séparément lorsque vous partagez votre langue préférée Yokoy preferredLanguage valeurs avec Perk.

champs_personnalisés_utilisateur

Le schéma SCIM de Yokoy offrait la possibilité de créer des champs personnalisés directement dans le formulaire utilisateur avec customData0–customData3, chacun nécessitant un champ personnalisé correspondant, tel que data0Perk SCIM n'a pas d'équivalent direct. Si votre organisation utilise ces champs, veuillez le signaler lors du partage de vos données avec Perk.

Ajustement de votre configuration SCIM

Une fois que vous avez partagé vos données et que l'équipe de Perk les a examinées, la transition se déroule en trois étapes :

  • La veille du procès SCIM. Vous désactivez le module SCIM de Yokoy et mettez à jour la configuration SCIM de TravelPerk en suivant les instructions de Perk. Yokoy continue de fonctionner normalement, car Perk synchronise les deux systèmes en arrière-plan.
  • Jour du changement. Perk accorde un accès d'essai à la configuration unifiée. Yokoy continue de travailler en parallèle.
  • Deux semaines après le changement. Perk bloque l'accès à Yokoy. Vous êtes entièrement intégré à Perk Travel & Spend grâce à une seule intégration SCIM.

Pour savoir comment ajuster votre configuration SCIM pour l'approvisionnement des utilisateurs, consultez Premiers pas avec le provisionnement des utilisateurs SCIMIl existe également des guides de configuration spécifiques pour Okta et Identifiant d'entrée Microsoft applications.

Remarque : Si vous utilisez Microsoft Entra ID ou Okta pour la gestion des utilisateurs, il se peut que certains attributs ne s’affichent pas correctement. Vous pouvez ajouter ces attributs en tant qu’attributs personnalisés. Identifiant d'entrée Microsoft et OktaPour Microsoft Entra, vous devez effectuer les opérations suivantes : Configuration supplémentaire pour la synchronisation des données de l'entreprise.

Conseil : Tenez votre contact Perk informé. Signalez tout élément inhabituel entre la veille et la période suivant le changement.

Cet article vous a-t-il été utile ?