OIIdentity en access management
Loket One Identity koppeling: werknemers uit Loket.nl in One Identity Manager, met de juiste uitdienstdatum
Met een koppeling tussen Loket.nl en One Identity Manager staan werknemers, werkgevers en organisatorische eenheden uit Loket klaar in vaste bestanden, die de CSV-connector van One Identity Manager inleest. De einddatum van het laatste dienstverband wordt de uitdienstdatum, waarop One Identity Manager de identiteit en haar accounts blokkeert, zonder dat er loongegevens meegaan.
Wat de koppeling doet
Organisaties met hun salarisadministratie in Loket.nl en One Identity Manager voor identiteiten, lezen werknemers vaak in via een export die het salarisbureau maakt. Daarin staat elke periode van een dienstverband apart, zodat een werknemer die terugkomt in One Identity Manager als vertrekker en als nieuwe collega verschijnt.
- Een eigen Loket-gebruiker met alleen leesrechten op jullie werkgevers geeft KoppelHet toestemming.
- KoppelHet leest per werkgever werknemers, dienstverbanden en organisatorische eenheden, en laat conceptwerknemers weg.
- KoppelHet zet een werknemerbestand en een afdelingsbestand klaar op de plek die de synchronisatieserver leest.
- One Identity Manager leest beide bestanden met de CSV-connector en past zijn regels voor accounts en rechten toe.
- Op de uitdienstdatum zet het schema van One Identity Manager de identiteit op blijvend gedeactiveerd.
Waar je op let bij Loket en One Identity
- Dienstverbanden staan in Loket als een keten van perioden, met of zonder gaten. One Identity Manager blokkeert accounts zodra de uitdienstdatum is bereikt. KoppelHet zet daarom de einddatum van de laatste periode als uitdienstdatum, en niet het einde van elke tussenliggende periode.
- Valt er een gat tussen twee perioden, dan kent One Identity Manager een tijdelijke deactivering met een begin- en einddatum, waarna een schema de identiteit weer activeert. KoppelHet vult die datums met het gat uit Loket, zodat een seizoenskracht zijn accounts terugkrijgt als de nieuwe periode begint.
- Een identiteit die blijvend is gedeactiveerd, kan One Identity Manager weer activeren als dat niet door een certificering kwam. Komt een oud-werknemer na een lange tijd terug, dan houdt Loket hetzelfde personeelsnummer bij dezelfde werkgever aan. KoppelHet levert hem met dezelfde sleutel aan, zodat de bestaande identiteit weer opengaat in plaats van een nieuwe.
- Een personeelsnummer is in Loket alleen uniek per werkgever, en een salarisbureau werkt vaak met meerdere werkgevers in één omgeving. De CSV-connector staat meer sleutelkolommen toe; KoppelHet levert werkgevercode en nummer als twee kolommen die samen de identiteit bepalen.
- Een nieuwe werknemer kan in Loket eerst als concept bestaan. KoppelHet laat conceptwerknemers uit het bestand, zodat One Identity Manager geen centrale account aanmaakt voor iemand van wie de aanname nog niet rond is.
- Loket bewaart voorvoegsel en achternaam los, plus die van de partner, en een formele naam voor de loonstrook. One Identity Manager bouwt weergavenaam en accountnamen uit de namen in het bestand. KoppelHet zet de achternaam daarin zoals de werknemer hem gebruikt, met het voorvoegsel ervoor.
- Een Loket-werkgever heeft eigen organisatorische eenheden. KoppelHet maakt in het afdelingsbestand een pad met de werkgever erboven, zodat One Identity Manager de eenheden van twee werkgevers als aparte afdelingen in één boom ziet en de bovenliggende eerst inleest.
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
Werkt dit met meerdere werkgevers bij ons salarisbureau?
Ja. Alle werkgevers komen in hetzelfde bestand, met de werkgevercode als deel van de sleutel.
Gaan er loongegevens naar One Identity Manager?
Nee. Alleen naam, nummer, werkgever, eenheid en de datums van het dienstverband.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Loket wordt gelezen via de Loket REST API (oauth.loket.nl, authorization code en refresh token) onder /v2/providers/employers/{employerId}/employees, de dienstverbanden als keten van perioden (broken of linked date chains) en de organisatorische eenheden; conceptwerknemers worden overgeslagen. Geen BSN, loon of bankgegevens in de bestanden.
- One Identity Manager leest via de CSV-connector: twee bestanden in één systeemverbinding, UTF-8 met kopregel, twee sleutelkolommen in het werknemerbestand, Hierarchical sort order op het afdelingspad, Read-only access. Uitdienstdatum en tijdelijk inactief van/tot worden verwerkt door de schema's voor uit dienst en tijdelijke deactivering; bereikbaar direct of via een remote connection server.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Loket | Veld in One Identity | Toelichting |
|---|---|---|
Werkgevercode | Sleutelkolom 1 | |
employeeNumber | Sleutelkolom 2 | Samen uniek |
firstName | FirstName | |
prefix, lastName, prefixPartner, lastNamePartner | LastName | Volgens naamgebruik |
Werkgever en organisatorische eenheid | Afdelingspad in het afdelingsbestand | |
Begindatum eerste periode | EntryDate | |
Einddatum laatste periode | ExitDate (uitdienstdatum) | |
Gat tussen twee perioden | Tijdelijk inactief van en tot |
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