Dit artikel helpt u zich voor te bereiden op het samenvoegen van uw twee huidige SCIM-integraties – TravelPerk SCIM voor reizen en Yokoy SCIM voor uitgaven – tot één uniforme Perk SCIM-integratie. Het legt uit hoe uw huidige configuratie zich verhoudt tot het nieuwe model, zodat u accurate informatie over uw SCIM-configuratie kunt verzamelen en delen met uw Perk-contactpersoon.

Voordat je begint

Vandaag de dag gebruikt u twee afzonderlijke SCIM-integraties naast elkaar: TravelPerk SCIM voorzieningen voor gebruikers voor reizen, en Yokoy SCIM Perk biedt gebruikers mogelijkheden voor uitgaven en onkosten. Perk heeft beide functies samengevoegd in één Perk SCIM. Een integratie die reizen en uitgaven combineert via één verbinding met uw identiteitsprovider – of dat nu Okta, Azure AD (Entra ID) of een aangepaste, directe API-integratie is. U voert de daadwerkelijke configuratiewijziging in uw identiteitsprovider zelf door; het team van Perk doet dit niet namens u. Maar voordat u dit doet, bekijkt uw Perk-contactpersoon uw huidige TravelPerk SCIM- en Yokoy SCIM-configuratie en vertelt u precies wat u in Perk SCIM moet configureren. Dit artikel is bedoeld om u te helpen de verschillen tussen uw huidige configuratie en het nieuwe model goed te begrijpen, zodat u accurate en nuttige informatie met uw Perk-contactpersoon kunt delen. Het beschrijft niet direct de configuratiestappen van de identiteitsprovider – die begeleiding krijgt u van Perk na beoordeling van de informatie die u deelt.

Hoe verhoudt je huidige uitrusting zich tot de nieuwe Perk SCIM?

TravelPerk SCIM, uw huidige integratie voor de reisbranche, wordt vrijwel ongewijzigd overgezet naar Perk SCIM. TravelPerk SCIM gebruikt het SCIM-kernschema en de bedrijfsextensie (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User), en een aangepaste Perk-extensie (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) voor reisspecifieke velden zoals travelPolicy, factuurprofielen, en lineManagerEmailPerk SCIM behoudt hetzelfde kernschema, dezelfde bedrijfsextensie en dezelfde aangepaste Perk-extensie, waardoor de meeste van uw bestaande attribuuttoewijzingen voor reizen niet hoeven te worden gewijzigd. Het echt nieuwe onderdeel is de onkosten-extensie (urn:ietf:params:scim:schemas:extension:expense:2.0:UserTravelPerk SCIM had deze extensie nooit, omdat onkostenbeheer daar geen onderdeel van uitmaakte. Perk SCIM voegt deze extensie specifiek toe om alles te dekken wat uw Yokoy SCIM-integratie momenteel afhandelt voor uitgaven — zaken zoals onkostenbeleid, rechtspersonen en goedkeuringsdrempels. De onkostenextensie van Perk is gebouwd op dezelfde onderliggende logica als de eigen aangepaste extensie van Yokoy — het is hetzelfde idee, overgenomen als onderdeel van het Perk-platform. Daarom zullen de attribuutnamen in de onkostenextensie u bekend voorkomen als u Yokoy SCIM eerder hebt geconfigureerd: policyId, crediteur, legalEntityId, goedkeuringsdrempel, en ignoreManagerInRequests Ze duiken allemaal weer op met dezelfde namen en dezelfde concepten.

Deel je huidige SCIM-payloads.

Door uw huidige SCIM-payloads te delen, verzamelt Perk nauwkeurige informatie over uw configuratie voordat ze u vertellen wat u moet configureren. Voordat u of het team van Perk een beslissing neemt, moet Perk precies weten wat uw identiteitsprovider momenteel naar zowel TravelPerk SCIM als Yokoy SCIM verzendt.

Zo werkt het proces:

1. Exporteer of documenteer de SCIM-payload die uw identiteitsprovider momenteel naar TravelPerk SCIM verzendt.
2. Exporteer of documenteer de SCIM-payload die uw identiteitsprovider momenteel naar Yokoy SCIM verzendt.
3. Deel beide payloads met je Perk-contactpersoon.
4. Het team van Perk beoordeelt uw payloads en stuurt u de exacte waarden en attribuuttoewijzing terug die u in Perk SCIM kunt gebruiken, samen met eventuele wijzigingen die u in uw identiteitsprovider moet aanbrengen.

Dit is een stap voor het verzamelen van gegevens, geen configuratiestap. Je bepaalt hier niet zelf de uiteindelijke waarden; je geeft Perk nauwkeurige informatie over je huidige configuratie, zodat hun team je precies kan vertellen wat je moet gebruiken.

Attribuutvergelijking: Yokoy SCIM en de Perk-uitbreiding voor onkosten.

De Perk-uitbreiding voor onkostenbeheer dekt hetzelfde terrein als uw huidige Yokoy SCIM-integratie, dus het is handig om de twee naast elkaar te bekijken. Gebruik deze tabel om uw huidige Yokoy-attributen te vergelijken met hun dichtstbijzijnde Perk SCIM-equivalenten wanneer u uw Yokoy-payload voor Perk documenteert.

Kostenobjecten, beleidsmaatregelen en managers

Een paar eigenschappen in de bovenstaande tabel vereisen meer context voordat je ze nauwkeurig aan Perk kunt beschrijven, omdat de mapping niet puur mechanisch is. Kostenobjecten. Yokoy's kostencentrum Het veld verzendt kostenobjectcodes die al in Yokoy moeten bestaan ​​voordat u een gebruiker een waarde kunt toewijzen. Yokoy maakt geen kostenobjecten automatisch aan op basis van SCIM-gegevens. Perk maakt automatisch een kostenobject aan, zoals 'Marketing', als dit nog niet bestaat. Onkostenbeleid versus reisbeleid. Yokoy's policyId koppelt een gebruiker aan een onkostenbeleid. Perk SCIM bewaart dit als policyId in de onkostenuitbreiding, maar Perk heeft ook een apart travelPolicy veld in de aangepaste Perk-extensie, die al in Perk moet bestaan ​​en specifiek betrekking heeft op het reisbeleid. Dit zijn twee verschillende velden die twee verschillende gebieden bestrijken. Als uw organisatie beide gebruikt, documenteer dan beide waarden wanneer u uw payload met Perk deelt. Managers en goedkeurders. In Yokoy, manager.value is ID-gebaseerd en de lijnmanager van de gebruiker wordt automatisch de goedkeurder — het bedrijfsschema van Yokoy kent geen apart concept voor goedkeurders. Als een manager nog niet bestaat in Yokoy, wordt er een stub-gebruiker voor hem of haar aangemaakt en moet iedereen zonder manager, zoals een CEO, zelf als lijnmanager worden ingesteld. Perk SCIM biedt twee manieren om een ​​manager toe te wijzen: manager.value (via Perk-gebruikers-ID) of lineManagerEmail (via e-mail, ontworpen voor identiteitsproviders zoals Okta die gebruikers niet kunnen identificeren aan de hand van hun interne ID). Wanneer je je configuratie met Perk deelt, beschrijf dan welke van deze opties je identiteitsprovider ondersteunt, zodat Perk de juiste optie configureert.

Belangrijke aandachtspunten

Houd deze punten in gedachten bij het voorbereiden van je ladingen voor Perk.

Wat het bevat

De organisatie Het attribuut is een verplichte, constante Yokoy-identificatiecode voor de organisatie van de gebruiker, die eenmaal wordt gekopieerd vanuit de Yokoy-beheerinterface en voor elke gebruiker wordt hergebruikt. In Perk wordt uw account helemaal niet geïdentificeerd door een attribuut in de payload; het is impliciet in de basis-URL en API-sleutel die u gebruikt..

Gebruikerstaal

Yokoy combineert taal en landinstellingen in één preferredLanguage veld, bijvoorbeeld de-ch. Perk SCIM splitst dit op in twee velden: preferredLanguage voor de taal zelf, en een aparte locale veld, alleen gebruikt bij het aanmaken, dat Perk splitst op het koppelteken of de underscore om het land en de valuta te bepalen. Documenteer beide delen afzonderlijk wanneer u uw Yokoy preferredLanguage deelt. Waarden met Perk.

gebruikers_aangepaste_velden

Het Yokoy SCIM-schema bood de mogelijkheid om direct in het gebruikersformulier aangepaste velden aan te maken met customData0–customData3, waarbij elk een overeenkomend aangepast veld vereist, zoals data0Perk SCIM heeft geen direct equivalent. Als uw organisatie momenteel afhankelijk is van deze velden, geef dit dan aan als een hiaat wanneer u uw payload met Perk deelt.

Wat gebeurt er vervolgens?

Nadat je je payloads hebt gedeeld en het team van Perk ze heeft beoordeeld, vindt de omschakeling in drie fasen plaats:

• De dag voor de SCIM-proef. Je schakelt Yokoy's SCIM uit en werkt je TravelPerk SCIM-configuratie bij volgens de instructies van Perk. Yokoy blijft gewoon werken, omdat Perk beide systemen op de achtergrond synchroniseert.
• Dag van de wisseling. Perk geeft proeftoegang tot de uniforme configuratie. Yokoy blijft parallel daaraan werken.
• Twee weken na de omschakeling. Perk sluit de toegang tot Yokoy af. Je bent volledig geïntegreerd met Perk Travel & Spend via één SCIM-integratie.