Identity en access management
YouForce JumpCloud koppeling: gebruikers in JumpCloud uit de Youforce IAM API
Met een koppeling tussen Visma YouForce en JumpCloud wordt elke medewerker uit YouForce een gebruiker in JumpCloud, met afdeling, functie en leidinggevende, en wordt hij geschorst als het laatste dienstverband eindigt. KoppelHet voegt personen en dienstverbanden uit de Youforce IAM API samen tot één lijst die de Custom API-import van JumpCloud leest.
Wat de koppeling doet
Organisaties die YouForce voor HR en salaris gebruiken en JumpCloud als directory, krijgen vaak een export uit YouForce die IT met een script in JumpCloud zet. Gaat het script stuk of verandert de export, dan komen nieuwe medewerkers niet binnen en blijven vertrekkers actief.
- In Visma Connect maken we een applicatie voor KoppelHet met alleen de leesscope voor basisgegevens van de IAM API.
- KoppelHet haalt personen, dienstverbanden en rolverdelingen op en maakt per persoon één regel met afdeling, functie en leidinggevende.
- In JumpCloud richten we de Custom API-import in op het adres van KoppelHet, met mapping en statusregel.
- Een geplande import haalt de lijst op; nieuwe medewerkers worden gebruiker en wijzigingen worden bijgewerkt.
- Eindigt het laatste dienstverband, dan schorst de statusregel de gebruiker.
Waar je op let bij Visma Raet YouForce en JumpCloud
- De Custom API-import van JumpCloud verwacht één endpoint dat alle gebruikers met hun volledige gegevens teruggeeft. De Youforce IAM API levert personen en dienstverbanden via aparte endpoints. KoppelHet voegt die samen, zodat afdeling en functie bij de juiste persoon in JumpCloud komen.
- JumpCloud kan zelf een token ophalen met client credentials, net als Visma Connect uitgeeft. Toch laat KoppelHet JumpCloud niet rechtstreeks op YouForce aansluiten; de leidinggevende moet uit de rolverdeling worden afgeleid, en dat kan de import niet zelf.
- Iemand met twee dienstverbanden staat in YouForce twee keer met een eigen afdeling. JumpCloud heeft één afdeling per gebruiker. KoppelHet kiest het hoofddienstverband voor afdeling en functie, en houdt de gebruiker actief tot het laatste dienstverband is beëindigd.
- YouForce geeft een persoon met een einddatum buiten de ingestelde historicalDays niet meer terug. JumpCloud zou dan niets meer over die persoon horen. KoppelHet bewaart wie uit YouForce kwam en blijft een vertrekker als geschorst aanbieden, zodat de regel hem niet per ongeluk weer activeert.
- YouForce staat per domein en tenant zestig aanroepen per seconde, 2.500 per minuut en 30.000 per dag toe. KoppelHet vraagt alleen wijzigingen sinds de vorige ronde op met latestSync; de import van JumpCloud raakt YouForce helemaal niet.
- Het zakelijk e-mailadres is verplicht voor de JumpCloud-import, maar staat bij een nieuwe medewerker niet altijd in YouForce. KoppelHet bepaalt het dan met de naamgevingsregel. Het adres terugschrijven naar YouForce kan met een aparte schrijfscope en kan later als uitbreiding.
- Na een schorsing en terugkeer krijgt een gebruiker in JumpCloud dezelfde toegang terug als voorheen. Daarvoor moet in de import heractiveren bij een update aan staan. Bij een herintreder in YouForce onder hetzelfde persoonsnummer zetten we die optie aan, zodat er geen tweede gebruiker ontstaat.
Deze koppeling hoort ook bij in-, door- en uitstroom.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Ziet JumpCloud BSN of adresgegevens uit YouForce?
Nee. Die vragen een aparte scope die KoppelHet niet aanvraagt, en het adres voor JumpCloud bevat alleen de velden uit de mapping.
Wat als iemand tijdelijk bij een ander team werkt?
In de basis blijft de afdeling van het hoofddienstverband staan. Groepen per tijdelijke inzet kunnen later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- YouForce via de Youforce IAM API (api.youforce.com/IAM), token van Visma Connect (connect.visma.com/connect/token, client_credentials, expires_in 3600) met scope Youforce-IAM:Get_Basic. GET /v1.0/persons en /v1.0/employments met take (1 tot 1000), skip of nextLink en from/to op latestSync; historicalDays per abonnement. Limieten 60 per seconde, 2.500 per minuut en 30.000 per dag per domein en tenant, daarboven 429.
- JumpCloud: Custom API-import met Bearer Token of API Key op het KoppelHet-adres, alleen JSON, verplichte mapping Company email en Username, State via EXPR met manageUserState, optie Allow reactivation of users on update, geplande import (standaard uit) per uur, per dag of eigen schema met samenvattingsmail.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Raet YouForce | Veld in JumpCloud | Toelichting |
|---|---|---|
Persoonsnummer | employeeIdentifier | Sleutel tussen beide systemen |
Zakelijk e-mailadres | Company email en Username | Verplicht in JumpCloud |
Roepnaam, voorvoegsel en achternaam | firstname en lastname | |
Functie van het hoofddienstverband | jobTitle | |
Afdeling van het hoofddienstverband | department | |
Leidinggevende-rol op de afdeling | manager | |
Kostenplaats met het grootste aandeel | costCenter | |
Einddatum laatste dienstverband | State via manageUserState |
Gerelateerd
ADP Workforce Now → Visma Raet YouForce
ADP Workforce Now koppelen met YouForce: aanvragen voor nieuwe Nederlandse medewerkers en contractwijzigingen
Bullhorn → Visma Raet YouForce
Bullhorn YouForce koppeling: plaatsing wordt een aanvraag voor indiensttreding
Carerix → Visma Raet YouForce
Carerix koppelen met YouForce: een geplaatste kandidaat start de indiensttreding in YouForce
Darwinbox → Visma Raet YouForce
Darwinbox YouForce koppeling: aanname en salariswijziging uit Darwinbox als aanvraag in YouForce