Identity en access management
Loket JumpCloud koppeling: JumpCloud-gebruikers uit alle werkgevers in Loket.nl
Met een koppeling tussen Loket.nl en JumpCloud haalt JumpCloud elke werknemer uit Loket op als gebruiker, met werkgever, organisatorische eenheid en een status die volgt uit het dienstverband. KoppelHet bundelt alle werkgevers in één lijst voor de Custom API-import van JumpCloud, zodat een nieuwe werknemer tot zijn eerste werkdag klaargezet staat en na zijn laatste dienstverband wordt geschorst.
Wat de koppeling doet
Organisaties die het salaris in Loket.nl laten verwerken en apparaten en toegang in JumpCloud beheren, maken JumpCloud-gebruikers nu aan op basis van een mail of een lijstje van het salarisbureau. Wie tussen twee contracten even uit dienst is, wordt soms verwijderd en komt dan zonder zijn laptopkoppeling terug.
- Een eigen Loket-gebruiker met alleen leesrechten op jullie werkgevers geeft KoppelHet toestemming; JumpCloud krijgt een eigen token voor het adres van KoppelHet.
- KoppelHet leest per werkgever werknemers, dienstverbanden en organisatorische eenheden en slaat conceptwerknemers over.
- KoppelHet zet alle werknemers in één lijst, met werkgever, eenheid en de datums van de keten van dienstverbanden.
- De geplande import van JumpCloud haalt de lijst op en bepaalt met een statusregel of de gebruiker klaargezet, actief of geschorst is.
- IT koppelt gebruikersgroepen per werkgever of eenheid aan applicaties en apparaten in JumpCloud.
Waar je op let bij Loket en JumpCloud
- Loket geeft toegang alleen via de toestemming van een Loket-gebruiker, met een refresh token dat steeds wordt vernieuwd. De Custom API-import van JumpCloud kent wel OAuth, maar geen refresh token. KoppelHet houdt daarom de verbinding met Loket en laat JumpCloud een eigen adres lezen met een eigen token.
- Werknemers staan in de Loket-API onder hun werkgever, in pagina's per werkgever. JumpCloud wil één lijst-endpoint met het volledige gebruikersschema. KoppelHet loopt alle werkgevers van het salarisbureau langs die de koppeling mag zien en biedt het geheel aan met offset-paginering.
- Een dienstverband in Loket kan een keten van perioden zijn, met een gat ertussen. KoppelHet levert in zo'n gat de status geschorst, en met heractiveren bij een update aan in JumpCloud wordt de gebruiker bij de volgende periode weer actief, met dezelfde apparaatkoppeling en groepen.
- Een gebruiker die klaargezet is, heeft in JumpCloud nog geen toegang tot zijn applicaties, en wie eenmaal actief was, kan niet terug naar klaargezet. KoppelHet levert alleen werknemers die geen concept meer zijn, met de begindatum erbij, zodat de statusregel pas op de eerste werkdag activeert.
- Een personeelsnummer in Loket is alleen binnen één werkgever uniek. KoppelHet zet de werkgevercode voor het nummer in employeeIdentifier, zodat JumpCloud werknemers van twee werkgevers bij hetzelfde bureau niet als één gebruiker ziet.
- In JumpCloud zijn werkadres en gebruikersnaam verplicht voor elke import. Loket bewaart bij een nieuwe werknemer meestal alleen een privéadres. KoppelHet maakt het werkadres volgens de naamgevingsregel met het domein van de werkgever en laat het privéadres uit de lijst.
- Een geplande import staat in JumpCloud standaard uit en draait in een tijdzone die je zelf kiest. We zetten de planning op Nederlandse tijd en laten KoppelHet de lijst kort daarvoor verversen, zodat een einddatum in Loket op de juiste dag tot een schorsing leidt.
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
Kan JumpCloud Loket niet zelf lezen?
Niet duurzaam: de import kan het refresh token van Loket niet vernieuwen. Daarom zet KoppelHet een eigen adres tussen beide.
Ons salarisbureau beheert meer werkgevers. Zien we die allemaal?
Alleen de werkgevers waar de Loket-gebruiker van de koppeling rechten op heeft. Komt er een werkgever bij, dan voegt het bureau die rechten toe.
Verwijdert JumpCloud een gebruiker na vertrek?
Nee, de import schorst hem. Verwijderen doet IT na de afgesproken termijn, zodat apparaten eerst worden teruggehaald.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Loket via de Loket REST API (oauth.loket.nl, authorization code en refresh token; geen client credentials) onder /v2/providers/employers/{employerId}/employees, met de dienstverbanden als keten van perioden en de organisatorische eenheden; paginering met pageNumber en pageSize. Conceptwerknemers en loon- of bankgegevens gaan niet mee.
- JumpCloud: Custom API-import (HR Directories) met Bearer Token op het KoppelHet-adres (refresh token en Basic niet ondersteund), methode GET, offset-paginering, verplichte mapping Company email en Username, State via EXPR met manageUserState (STAGED, ACTIVATED, SUSPENDED) en datumfuncties zoals today() en dateAfter(), Allow reactivation of users on update, geplande import met tijdzone (standaard uit).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Loket | Veld in JumpCloud | Toelichting |
|---|---|---|
Werkgevercode + employeeNumber | employeeIdentifier | Uniek over alle werkgevers |
Naamgevingsregel met domein per werkgever | Company email en Username | |
firstName | firstname | |
prefix en lastName volgens naamgebruik | lastname | |
Werkgever | company | |
Organisatorische eenheid | department | |
Begin- en einddatum in de keten van dienstverbanden | State via manageUserState |
Gerelateerd
ADP Workforce Now → Loket
ADP Workforce Now koppelen met Loket: aanname, loon, uren en bonussen uit ADP naar de Nederlandse loonrun
AlexisHR → Loket
AlexisHR Loket koppeling: medewerkers van het Nederlandse bedrijf uit AlexisHR in de salarisadministratie
BambooHR → Loket
BambooHR koppelen met Loket: HR-mutaties uit BambooHR voor de Nederlandse salarisverwerking
Bullhorn → Loket
Bullhorn Loket koppeling: plaatsing als conceptwerknemer in de juiste loonadministratie