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

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.

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 Perk 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. Das Feld „costCenter“ von Yokoy 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. Die policyId von Yokoy verknüpft einen Benutzer mit einer Spesenrichtlinie. Perk SCIM verwendet diese policyId in der Spesen-Erweiterung. Perk bietet jedoch zusätzlich ein separates Feld travelPolicy in seiner benutzerdefinierten Perk-Erweiterung an, das bereits in Perk vorhanden sein muss und speziell die Reiserichtlinie abdeckt. Es handelt sich um zwei verschiedene Felder für zwei unterschiedliche Bereiche. Wenn Ihre Organisation beide verwendet, dokumentieren Sie bitte beide Werte, wenn Sie Ihre Daten mit Perk teilen.
  • Manager und Genehmiger. In Yokoy ist manager.value 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 Manager, wird ein Platzhalterbenutzer erstellt, und jeder ohne Manager, z. B. ein CEO, muss selbst als direkter Vorgesetzter festgelegt werden. Perk SCIM bietet zwei Möglichkeiten zur Managerzuweisung: manager.value (über die Perk-Benutzer-ID) oder lineManagerEmail (über die E-Mail-Adresse, speziell für Identitätsanbieter wie Okta, die Benutzer nicht über interne IDs referenzieren können). Wenn Sie Ihre Konfiguration mit Perk teilen, beschreiben Sie bitte, welche dieser Methoden Ihr Identitätsanbieter unterstützt, damit Perk die richtige konfiguriert.
Warnung: Das Feld approvers in Perks benutzerdefinierter Perk-Erweiterung ist bei 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 und lineManagerEmail ersetzt. Wenn Ihr Konto nach diesem Datum erstellt wurde, geben Sie approvers nicht in den Daten an, die 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.

Anpassen Ihrer SCIM-Konfiguration

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.

Informationen zur Anpassung Ihrer SCIM-Konfiguration für die Benutzerbereitstellung finden Sie hier: Erste Schritte mit der SCIM-BenutzerbereitstellungEs gibt auch spezifische Konfigurationsanleitungen für Okta Und Microsoft Entra ID Apps.

Hinweis: Wenn Sie Microsoft Entra ID oder Okta für die Benutzerbereitstellung verwenden, werden einige Attribute möglicherweise nicht korrekt angezeigt. Sie können diese Attribute als benutzerdefinierte Attribute hinzufügen in Microsoft Entra ID Und OktaFür Microsoft Entra müssen Sie Folgendes durchführen: zusätzliche Einrichtung zur Unterstützung der UnternehmensdatensynchronisierungDie

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?