Questo articolo ti aiuta a prepararti per unificare le tue due attuali integrazioni SCIM — TravelPerk SCIM per i viaggi e Yokoy SCIM per le spese — in un'unica integrazione Perk SCIM. Spiega come la tua configurazione attuale si confronta con il nuovo modello, in modo che tu possa raccogliere informazioni accurate sulla tua configurazione SCIM e condividerle con il tuo referente Perk.

Prima di iniziare

Oggi, esegui due integrazioni SCIM separate una accanto all'altra: TravelPerk SCIM fornisce agli utenti i servizi di viaggio e Yokoy SCIM fornisce agli utenti informazioni su spese e costi. Perk ha unificato entrambi questi elementi in un unico Perk SCIM Un'integrazione che gestisce viaggi e spese in un unico punto, tramite una connessione al tuo provider di identità, che si tratti di Okta, Azure AD (Entra ID) o un'integrazione API diretta personalizzata. Dovrai apportare tu stesso la modifica alla configurazione del tuo provider di identità; il team di Perk non effettuerà questa modifica per tuo conto. Prima di farlo, il tuo referente Perk esaminerà la tua attuale configurazione SCIM di TravelPerk e Yokoy e ti indicherà esattamente cosa configurare in Perk SCIM. Questo articolo ha lo scopo di aiutarti a comprendere le differenze tra la tua configurazione attuale e il nuovo modello, in modo da poter condividere informazioni accurate e utili con il tuo referente Perk. Non ti guiderà direttamente attraverso i passaggi di configurazione del provider di identità: tale assistenza verrà fornita da Perk dopo aver esaminato le informazioni che hai condiviso.

Come si confronta la tua configurazione attuale con la nuova Perk SCIM

TravelPerk SCIM, la tua attuale integrazione lato viaggio, viene trasferita in Perk SCIM quasi senza modifiche. TravelPerk SCIM utilizza lo schema core SCIM, l'estensione aziendale (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User), e un'estensione Perk personalizzata (urn:ietf:params:scim:schemas:extension:travelperk:2.0:User) per campi specifici di viaggio come travelPolicy, invoiceProfilese lineManagerEmail. Perk SCIM mantiene lo stesso schema di base, la stessa estensione aziendale e la stessa estensione Perk personalizzata, quindi la maggior parte della mappatura degli attributi esistente per i viaggi non deve essere modificata. La parte veramente nuova è l'estensione delle spese (urn:ietf:params:scim:schemas:extension:expense:2.0:UserTravelPerk SCIM non ha mai avuto questa estensione, perché la gestione delle spese non ne faceva parte. Perk SCIM la aggiunge specificamente per coprire tutto ciò che l'integrazione Yokoy SCIM gestisce attualmente per le spese, come ad esempio le politiche di spesa, le entità legali e le soglie di approvazione. L'estensione per le spese di Perk si basa sulla stessa logica dell'estensione personalizzata di Yokoy: è la stessa idea, riproposta come parte della piattaforma Perk. Ecco perché i nomi degli attributi nell'estensione per le spese risulteranno familiari se hai già configurato Yokoy SCIM: policyId, creditore, legalEntityId, soglia di approvazionee ignoreManagerInRequests Tutti ricompaiono con gli stessi nomi e gli stessi concetti.

Condividi i tuoi payload SCIM attuali

Condividere i payload SCIM attualmente in uso è il modo in cui Perk raccoglie informazioni accurate sulla tua configurazione prima di indicarti cosa configurare. Prima che tu o il team di Perk prendiate qualsiasi decisione, Perk ha bisogno di vedere esattamente cosa il tuo provider di identità invia attualmente sia a TravelPerk SCIM che a Yokoy SCIM.

Ecco come funziona il processo:

1. Esporta o documenta il payload SCIM che il tuo provider di identità invia attualmente a TravelPerk SCIM.
2. Esporta o documenta il payload SCIM che il tuo provider di identità invia attualmente a Yokoy SCIM.
3. Condividi entrambi i payload con il tuo referente Perk.
4. Il team di Perk esamina i tuoi payload e ti restituisce i valori esatti e la mappatura degli attributi da utilizzare in Perk SCIM, insieme a tutte le modifiche che devi apportare al tuo provider di identità.

Questa è una fase di raccolta dati, non di configurazione. Non stai decidendo tu i valori finali, ma stai fornendo a Perk informazioni precise sulla tua configurazione attuale, in modo che il loro team possa indicarti esattamente cosa utilizzare.

Confronto degli attributi: Yokoy SCIM e l'estensione delle spese Perk

L'estensione per le spese di Perk copre lo stesso ambito della tua attuale integrazione SCIM di Yokoy, quindi è utile confrontarle. Utilizza questa tabella per verificare gli attributi Yokoy attuali con i corrispondenti attributi SCIM di Perk quando documenti il ​​payload Yokoy per Perk.

Oggetti di costo, politiche e responsabili

Alcuni attributi nella tabella sopra necessitano di maggiore contesto prima che tu possa descriverli accuratamente a Perk, perché la mappatura non è puramente meccanica. Oggetti di costo. Centro costi di Yokoy Il campo invia codici oggetto di costo che devono già esistere in Yokoy prima di poter assegnare un valore a un utente: Yokoy non crea automaticamente oggetti di costo dai dati SCIM. Perk crea automaticamente un oggetto di costo, come "Marketing", se non esiste già. Politica di spesa vs. politica di viaggio. policyId di Yokoy collega un utente a una politica di spesa. Perk SCIM lo conserva come policyId nell'estensione spese, ma Perk ha anche una travelPolicy separata campo nella sua estensione Perk personalizzata, che deve già esistere in Perk e riguarda specificamente la politica di viaggio. Si tratta di due campi diversi che coprono due aree diverse. Se la tua organizzazione li utilizza entrambi, documenta entrambi i valori quando condividi il payload con Perk. Manager e approvatori. In Yokoy, manager.value è basato sull'ID e il responsabile di linea dell'utente diventa automaticamente il suo approvatore: lo schema aziendale di Yokoy non ha un concetto di approvatore separato. Se un responsabile non esiste ancora in Yokoy, viene creato un utente fittizio per lui e chiunque non abbia un responsabile, come un CEO, deve essere impostato come proprio responsabile di linea. Perk SCIM ti offre due modi per assegnare un responsabile: manager.value (tramite ID utente Perk) o lineManagerEmail (tramite e-mail, progettato per provider di identità come Okta che non possono fare riferimento agli utenti tramite ID interno). Quando condividi la tua configurazione con Perk, descrivi quali di questi metodi sono supportati dal tuo provider di identità, in modo che Perk possa configurare quello corretto.

Considerazioni principali

Tenete a mente questi punti mentre preparate i vostri payload per Perk.

Cosa contiene

L'organizzazione L'attributo è un identificatore Yokoy obbligatorio e costante per l'organizzazione dell'utente, copiato una sola volta dall'interfaccia utente di amministrazione di Yokoy e riutilizzato per ogni utente. In Perk, il tuo account non è identificato da un attributo nel payload, è implicito nell'URL di base e nella chiave API che stai utilizzando.

lingua umana

Yokoy combina lingua e locale in un unico lingua preferita campo, ad esempio de-ch. Perk SCIM divide questo in due campi: lingua preferita per la lingua stessa e una locale separato campo, utilizzato solo in fase di creazione, che Perk divide in base al trattino o al carattere di sottolineatura per determinare paese e valuta. Documenta entrambe le parti separatamente quando condividi il tuo Yokoy preferredLanguage valori con Perk.

campi_personalizzati_utente

Lo schema Yokoy SCIM offriva la possibilità di creare campi personalizzati direttamente nel modulo Utente con customData0–customData3, ognuno dei quali richiede un campo personalizzato corrispondente, come data0Perk SCIM non ha un equivalente diretto. Se la tua organizzazione si basa attualmente su questi campi, segnala questa lacuna quando condividi il tuo payload con Perk.

Cosa succede dopo?

Una volta condivisi i payload e dopo che il team di Perk li avrà esaminati, il passaggio avverrà in tre fasi:

• Il giorno prima del processo SCIM. Disattivi SCIM di Yokoy e aggiorni la configurazione SCIM di TravelPerk, seguendo le istruzioni di Perk. Yokoy continua a funzionare normalmente, poiché Perk sincronizza entrambi i sistemi in background.
• Giorno del cambio. Perk garantisce l'accesso di prova alla configurazione unificata. Yokoy continua a lavorare in parallelo.
• Due settimane dopo il cambio. Perk interrompe l'accesso a Yokoy. L'attivazione completa di Perk Travel & Spend avviene con una sola integrazione SCIM.