Bereiten Sie sich darauf vor, Ihre TravelPerk- und Yokoy-SCIM-Konten zu Perk SCIM zu übertragen.

Dieser Artikel hilft Ihnen dabei, Ihre beiden bestehenden SCIM-Integrationen – TravelPerk SCIM für Reisekosten und Yokoy SCIM für Ausgaben – zu einer einheitlichen Perk-SCIM-Integration zusammenzuführen. Er erläutert die Unterschiede zwischen Ihrer aktuellen Konfiguration und dem neuen Modell, sodass Sie präzise Informationen zu Ihrer SCIM-Konfiguration zusammentragen und diese Ihrem Perk-Ansprechpartner zur Verfügung stellen können.

Rolle: Diese Aufgabe kann von Kontoadministratoren und IT- oder Identitätsadministratoren ausgeführt werden.

Bevor Sie beginnen

Heute betreiben Sie zwei separate SCIM-Integrationen parallel: TravelPerk SCIM Bereitstellung von Reisemöglichkeiten für Benutzer und Yokoy SCIM Perk stellt Nutzern Ausgaben und Kosten zur Verfügung. Perk hat beides in einem einzigen Perk SCIM zusammengeführt. Die Integration umfasst Reise- und Ausgabenmanagement über eine einzige Verbindung zu Ihrem Identitätsanbieter – sei es Okta, Azure AD (Entra ID) oder eine benutzerdefinierte, direkte API-Integration. Die Konfigurationsänderung in Ihrem Identitätsanbieter nehmen Sie selbst vor; das Perk-Team übernimmt diese Änderung nicht für Sie. Zuvor prüft Ihr Perk-Ansprechpartner jedoch Ihre aktuelle TravelPerk SCIM- und Yokoy SCIM-Konfiguration und teilt Ihnen genau mit, was in Perk SCIM konfiguriert werden muss. Dieser Artikel soll Ihnen helfen, die Unterschiede zwischen Ihrer aktuellen Konfiguration und dem neuen Modell so gut zu verstehen, dass Sie Ihrem Perk-Ansprechpartner präzise und hilfreiche Informationen weitergeben können. Er führt Sie nicht direkt durch die Konfigurationsschritte Ihres Identitätsanbieters – diese Anleitung erhalten Sie von Perk nach Prüfung Ihrer Angaben.

Hinweis: Die SCIM-Benutzerbereitstellung ist eine Premium- oder Pro-Funktion in Perk.

Wie sich dein aktuelles Setup im Vergleich zum neuen Perk SCIM verhält

TravelPerk SCIM, Ihre bisherige Reiseintegration, wird nahezu unverändert in Perk SCIM übernommen. TravelPerk SCIM verwendet das SCIM-Kernschema und die Enterprise-Erweiterung (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User).) und eine benutzerdefinierte Perk-Erweiterung (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) für reisespezifische Felder wie travelPolicy, Rechnungsprofileund lineManagerEmailPerk SCIM behält dasselbe Kernschema, dieselbe Unternehmenserweiterung und dieselbe benutzerdefinierte Perk-Erweiterung bei, sodass die meisten Ihrer bestehenden Attributzuordnungen für Reisekosten nicht geändert werden müssen. Die eigentliche Neuerung ist die Spesen-Erweiterung (urn:ietf:params:scim:schemas:extension:expense:2.0:User).TravelPerk SCIM bot diese Erweiterung bisher nicht, da Spesenmanagement nicht Teil der Lösung war. Perk SCIM fügt sie nun speziell hinzu, um alle Ausgabenfunktionen Ihrer Yokoy SCIM-Integration abzudecken – wie Spesenrichtlinien, juristische Personen und Genehmigungsschwellen. Die Spesen-Erweiterung von Perk basiert auf derselben Logik wie die benutzerdefinierte Erweiterung von Yokoy – es ist dasselbe Prinzip, das in die Perk-Plattform integriert wurde. Daher werden Ihnen die Attributnamen der Spesen-Erweiterung bekannt vorkommen, wenn Sie Yokoy SCIM bereits konfiguriert haben: policyId, Gläubiger, legalEntityId, approvalThresholdund ignoreManagerInRequests Sie alle tauchen wieder auf, mit denselben Namen und denselben Konzepten.

Teilen Sie Ihre aktuellen SCIM-Payloads

Durch die Bereitstellung Ihrer aktuellen SCIM-Payloads erhält Perk genaue Informationen über Ihre Konfiguration, bevor wir Ihnen weitere Anweisungen geben. Bevor Sie oder das Perk-Team Entscheidungen treffen, muss Perk genau sehen, welche Daten Ihr Identitätsanbieter aktuell an TravelPerk SCIM und Yokoy SCIM sendet.

Tipp: Einige Perk-Kunden dokumentieren dies in einer gemeinsamen Tabelle mit jeweils einem Tabellenblatt für TravelPerk SCIM und Yokoy SCIM. So kann Ihr Perk-Ansprechpartner beides bequem nebeneinander überprüfen.

So funktioniert der Prozess:

  1. Exportieren oder dokumentieren Sie die SCIM-Nutzdaten, die Ihr Identitätsanbieter derzeit an TravelPerk SCIM sendet.
  2. Exportieren oder dokumentieren Sie die SCIM-Nutzdaten, die Ihr Identitätsanbieter derzeit an Yokoy SCIM sendet.
  3. Teilen Sie beide Nutzdaten mit Ihrem Perk-Ansprechpartner.
  4. Das Team von Perk prüft Ihre Nutzdaten und sendet Ihnen die genauen Werte und die Attributzuordnung zur Verwendung in Perk SCIM sowie alle Änderungen, die Sie bei Ihrem Identitätsanbieter vornehmen müssen, zurück.

Dies ist ein Datenerfassungsschritt, kein Konfigurationsschritt. Sie legen hier nicht selbst die endgültigen Werte fest – Sie liefern Perk präzise Informationen über Ihre aktuelle Konfiguration, damit das Team Ihnen genau sagen kann, was Sie verwenden sollten.

Attributvergleich: Yokoy SCIM und die Perk-Ausgabenerweiterung

Die Perk-Ausgabenerweiterung deckt dieselben Bereiche wie Ihre bestehende Yokoy-SCIM-Integration ab. Daher ist es hilfreich, beide nebeneinander zu betrachten. Nutzen Sie diese Tabelle, um Ihre aktuellen Yokoy-Attribute mit den entsprechenden Perk-SCIM-Attributen abzugleichen, wenn Sie Ihre Yokoy-Payload für Perk dokumentieren.

Yokoy SCIM-Attribut Vorteil SCIM-Attribut Anmerkungen
ID id (Kernschema) Beides sind vom Server zugewiesene, schreibgeschützte Kennungen.
externe ID externalId (Kernschema) Das gleiche Konzept in beiden Fällen: eine vom Kunden definierte Kennung. In beiden Fällen nicht erforderlich.
active (Aktiv) aktiv (Kernschema) In beiden Fällen ein boolescher Wert. Erforderlich in Perk SCIM; nicht explizit erforderlich in Yokoy.
Benutzername Benutzername (Kernschema) Die E-Mail-Adresse des Benutzers, die als Anmeldename verwendet wird. In beiden Fällen erforderlich.
emails[type eq "work"].value E-Mails (Kernschema) Erforderlich in Yokoy. Perks E-Mails Es handelt sich um ein Array, dessen Angabe nicht zwingend erforderlich ist, es empfiehlt sich jedoch, es zu senden – zum Beispiel sarah@example.com.Die
Vorname name.givenName (Kernschema) In beiden Fällen erforderlich.
Vorname.Familienname name.familyName (Kernschema) In beiden Fällen erforderlich.
bevorzugte Sprache preferredLanguage und locale Yokoy verwendet ein kombiniertes Feld (zum Beispiel de-chPerk trennt Sprache und Gebietsschema in zwei Felder auf. Siehe BenutzerspracheDie
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber In Yokoy wird hierfür ein benutzerdefiniertes Feld namens employeeNumber benötigt. Zuerst in den Unternehmenseinstellungen konfigurieren, sonst wird der Wert in der Yokoy-Benutzeroberfläche nicht angezeigt. Perk SCIMs employeeNumber ist integriert – es ist keine Einrichtung benutzerdefinierter Felder erforderlich.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:creditor urn:ietf:params:scim:schemas:extension:expense:2.0:User:creditor Das Prinzip ist in beiden Fällen dasselbe: Es handelt sich um ein Buchhaltungskonto, auf dem privat bezahlte Ausgaben verbucht werden. Es ist in beiden Fällen nicht erforderlich.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization Kein direktes Äquivalent Sehen Wichtige ÜberlegungenDie
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter In beiden Fällen ist der Feldname identisch. Siehe Kostenobjekte, Richtlinien und Manager für einen Kartenhinweis, der mit Perk gekennzeichnet werden soll.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value manager.value oder lineManagerEmail Yokoy ist ausschließlich ID-basiert. Perk unterstützt einen ID-basierten manager.value. oder eine E-Mail-basierte lineManagerEmail. Sehen Kostenobjekte, Richtlinien und ManagerDie
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:legalEntityId urn:ietf:params:scim:schemas:extension:expense:2.0:User:legalEntityId Gleiches Konzept, übernommen in die Spesenabrechnung. Erforderlich in Yokoy; nicht erforderlich in Perk SCIM. Gibt das dem Benutzer zugeordnete Unternehmen an.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:policyId urn:ietf:params:scim:schemas:extension:expense:2.0:User:policyId Verknüpft den Benutzer mit einer Spesenrichtlinie in beiden Systemen. Nicht zu verwechseln mit der separaten Reiserichtlinie von Perk. Feld — siehe Kostenobjekte, Richtlinien und ManagerDie
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:approvalThreshold urn:ietf:params:scim:schemas:extension:expense:2.0:User:approvalThreshold In beiden Fällen gilt dasselbe Konzept: ein Genehmigungslimit, das als Dezimalzahl übermittelt wird. Die Angabe ist in beiden Fällen optional.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:ignoreManagerInRequests urn:ietf:params:scim:schemas:extension:expense:2.0:User:ignoreManagerInRequests In beiden Fällen dasselbe boolesche Konzept. In beiden Fällen optional.
urn:ietf:params:scim:schemas:extension:yokoy:2.0:User:customData0–customData3 Kein direktes Äquivalent Sehen Wichtige ÜberlegungenDie

Kostenobjekte, Richtlinien und Manager

Einige Attribute in der obigen Tabelle benötigen mehr Kontext, bevor Sie sie Perk genau beschreiben können, da die Zuordnung nicht rein mechanisch ist. Kostenobjekte. Yokoys costCenter Das Feld sendet Kostenobjektcodes, die in Yokoy bereits vorhanden sein müssen, bevor einem Benutzer ein Wert zugewiesen wird – Yokoy erstellt Kostenobjekte nicht automatisch aus SCIM-Daten. Perk erstellt automatisch ein Kostenobjekt, z. B. „Marketing“, falls dieses noch nicht existiert. Spesenrichtlinie vs. Reiserichtlinie. Yokoys policyId verknüpft einen Benutzer mit einer Spesenrichtlinie. Perk SCIM speichert dies als policyId. in der Ausgabenerweiterung, aber Perk hat auch eine separate travelPolicy Das Feld in der benutzerdefinierten Perk-Erweiterung muss bereits in Perk vorhanden sein und die Reiserichtlinien abdecken. Es handelt sich um zwei verschiedene Felder, die zwei unterschiedliche Bereiche betreffen. Falls Ihre Organisation beide Felder verwendet, dokumentieren Sie bitte beide Werte, wenn Sie Ihre Daten mit Perk teilen. Manager und Genehmiger. In Yokoy, manager.value Die Genehmigung erfolgt ID-basiert, und der direkte Vorgesetzte des Benutzers wird automatisch zum Genehmiger – das Unternehmensschema von Yokoy kennt kein separates Genehmigerkonzept. Existiert in Yokoy noch kein Vorgesetzter, wird ein Platzhalterbenutzer angelegt, und jeder Benutzer ohne Vorgesetzten, z. B. ein CEO, muss selbst als Vorgesetzter festgelegt werden. Perk SCIM bietet zwei Möglichkeiten zur Vorgesetztenzuweisung: manager.value (nach Perk-Benutzer-ID) oder lineManagerEmail (Per E-Mail, speziell für Identitätsanbieter wie Okta, die Benutzer nicht anhand ihrer internen ID referenzieren können). Wenn Sie Ihre Konfiguration mit Perk teilen, beschreiben Sie bitte, welche dieser Optionen Ihr Identitätsanbieter unterstützt, damit Perk die richtige Konfiguration vornimmt.

Warnung: Die Genehmiger Das Feld in der benutzerdefinierten Perk-Erweiterung ist für Perk-Konten, die nach dem 1. Juli 2024 erstellt wurden, nicht verfügbar – es führt bei diesen Konten zu einem Fehler. Es wurde durch manager ersetzt. und lineManagerEmailWenn Ihr Konto nach diesem Datum erstellt wurde, fügen Sie Genehmiger nicht hinzu. in dem, was Sie mit Perk teilen.

Wichtige Überlegungen

Beachten Sie diese Punkte bei der Vorbereitung Ihrer Nutzlasten für Perk.

Was es enthält

Die Organisation Das Attribut ist eine erforderliche, konstante Yokoy-Kennung für die Organisation des Benutzers, die einmalig aus der Yokoy-Admin-Oberfläche kopiert und für jeden Benutzer wiederverwendet wird. Bei Perk wird Ihr Konto überhaupt nicht durch ein Attribut in der Nutzlast identifiziert; die Identifizierung erfolgt implizit über die verwendete Basis-URL und den API-Schlüssel.Die

Hinweis: Verwechseln Sie dies nicht mit dem separaten, optionalen company Das Feld dient dazu, Benutzer anhand des Firmennamens innerhalb eines einzelnen Perk-Kontos, das sich über mehrere Unternehmen erstreckt, zu unterteilen – es repräsentiert nicht das Konto selbst.

Benutzersprache

Yokoy kombiniert Sprache und Gebietsschema in einer einzigen preferredLanguage-Einstellung. Feld, zum Beispiel de-chPerk SCIM teilt dies in zwei Felder auf: preferredLanguage für die Sprache selbst und ein separates locale Dieses Feld wird nur bei der Erstellung verwendet und von Perk anhand des Bindestrichs oder Unterstrichs getrennt, um Land und Währung zu ermitteln. Dokumentieren Sie beide Teile separat, wenn Sie Ihre Yokoy-Datei teilen. Werte mit Perk.

Benutzerdefinierte Felder

Das Yokoy SCIM-Schema bot die Möglichkeit, benutzerdefinierte Felder direkt im Benutzerformular mit customData0 zu erstellen.–customData3, die jeweils ein passendes benutzerdefiniertes Feld erfordern, wie z. B. data0.Perk SCIM hat kein direktes Äquivalent. Falls Ihre Organisation diese Felder aktuell nutzt, kennzeichnen Sie dies bitte als Lücke, wenn Sie Ihre Nutzdaten mit Perk teilen.

Wie es weitergeht

Sobald Sie Ihre Nutzdaten geteilt haben und das Team von Perk diese geprüft hat, erfolgt der Wechsel in drei Schritten:

  • Einen Tag vor dem SCIM-Prozess. Sie deaktivieren Yokoys SCIM und aktualisieren Ihre TravelPerk-SCIM-Konfiguration gemäß den Anweisungen von Perk. Yokoy funktioniert weiterhin wie gewohnt, da Perk beide Systeme im Hintergrund synchronisiert.
  • Tag des Wechsels. Perk gewährt Testzugriff auf die einheitliche Konfiguration. Yokoy arbeitet parallel weiter.
  • Zwei Wochen nach der Umstellung. Perk schaltet den Zugriff auf Yokoy ab. Mit einer einzigen SCIM-Integration sind Sie vollständig in Perk Travel & Spend eingebunden.
Tipp: Halten Sie Ihren Ansprechpartner bei Perk auf dem Laufenden. Melden Sie alles, was Ihnen zwischen dem Tag vor und dem Zeitraum nach der Umstellung verdächtig vorkommt.

War dieser Beitrag hilfreich?