Identity en access management
Nmbrs JumpCloud koppeling: medewerkers van alle bedrijven in Nmbrs als JumpCloud-gebruiker
Met een koppeling tussen Nmbrs en JumpCloud komt elke medewerker uit Nmbrs als gebruiker in JumpCloud, met afdeling, functie en bedrijf, en schorst JumpCloud de gebruiker na de datum uit dienst. KoppelHet houdt de verbinding met Nmbrs en biedt JumpCloud één lijst over alle bedrijven heen, die de Custom API-import van JumpCloud ophaalt.
Wat de koppeling doet
Organisaties die hun salarisadministratie in Nmbrs doen, vaak met meerdere bedrijven, en JumpCloud gebruiken voor accounts en apparaten, werken JumpCloud vaak met de hand bij. IT houdt gebruikers bij op basis van berichten van HR, en wie naar een ander bedrijf in de groep overstapt, staat soms twee keer in JumpCloud.
- Een Nmbrs-beheerder geeft de app van KoppelHet toestemming met alleen leesrechten op medewerkers, dienstverbanden en bedrijven.
- KoppelHet leest alle bedrijven en maakt per persoon één regel, met het bedrijf waar die nu in dienst is.
- In JumpCloud richten we de Custom API-import in op het adres van KoppelHet, met een eigen sleutel.
- We zetten de mapping en de statusregel op de datums en koppelen gebruikers via groepen aan hun applicaties.
- Na de datum uit dienst schorst JumpCloud de gebruiker; KoppelHet bewaakt of de geplande import slaagt.
Waar je op let bij Nmbrs en JumpCloud
- Nmbrs geeft toegang tot de REST API via een autorisatiecode-flow, waarbij een Nmbrs-gebruiker inlogt en toestemming geeft, met tokens die later worden vernieuwd. De Custom API-import van JumpCloud ondersteunt geen refresh token. JumpCloud kan Nmbrs dus niet rechtstreeks lezen; KoppelHet houdt die verbinding en geeft JumpCloud een eigen sleutel.
- In Nmbrs staan medewerkers per bedrijf, terwijl JumpCloud één endpoint met alle gebruikers verwacht. KoppelHet loopt alle bedrijven langs waar de toestemming voor geldt en zet ze samen in één lijst.
- Personeelsnummers zijn in Nmbrs alleen binnen een bedrijf uniek, en twee bv's kunnen allebei een nummer 1001 hebben. KoppelHet zet de bedrijfscode voor het nummer in employeeIdentifier, zodat JumpCloud geen twee medewerkers samenvoegt.
- Een overstap naar een ander bedrijf is in Nmbrs een uit- en indiensttreding. KoppelHet herkent dezelfde persoon en levert één regel met het nieuwe bedrijf. Met heractiveren bij een update aan in JumpCloud houdt de gebruiker zijn apparaten en toegang, ook als het oude dienstverband even eerder eindigt.
- KoppelHet vraagt bij Nmbrs alleen de leesscopes voor medewerkergegevens, dienstverbanden en bedrijfsgegevens aan, en geen scope voor betalingen. Loon en bankgegevens komen zo nooit in de lijst voor JumpCloud.
- Een geïmporteerde gebruiker krijgt in JumpCloud pas toegang tot een applicatie als hij in een gebruikersgroep zit die aan die applicatie hangt. KoppelHet levert bedrijf en afdeling mee, zodat jullie groepen per bedrijf kunnen vullen en een bv eigen applicaties houdt.
- Een geplande schorsing in JumpCloud moet minstens een uur in de toekomst liggen en draait in rondes van tien minuten. KoppelHet gebruikt die niet, maar levert de datum uit dienst aan de statusregel van de import; zo staat de schorsing vast in Nmbrs en niet in losse handmatige acties.
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
Wie geeft in Nmbrs de toestemming?
Een Nmbrs-gebruiker met rechten op de bedrijven die mee moeten. Die keuze bepaalt welke bedrijven in JumpCloud komen.
Wordt een vertrekker verwijderd?
Nee, geschorst. Verwijderen blijft een stap van IT, bijvoorbeeld nadat een laptop is ingeleverd.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nmbrs via de Nmbrs REST API met OAuth 2.0 (identityservice.nmbrs.com, autorisatiecode-flow met toestemming van een Nmbrs-gebruiker en refresh token) en alleen leesscopes, zoals employee.info.read, employee.employment.read en company.info.read; per bedrijf gelezen.
- JumpCloud: Custom API-import met Bearer Token of API Key op het KoppelHet-adres (geen OAuth refresh token ondersteund), methode GET, verplichte mapping Company email en Username, State via EXPR met manageUserState, Allow reactivation of users on update, geplande import per uur of per dag.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in JumpCloud | Toelichting |
|---|---|---|
Bedrijfscode + personeelsnummer | employeeIdentifier | Personeelsnummer is per bedrijf uniek |
Zakelijk e-mailadres | Company email en Username | Verplicht in JumpCloud |
Roepnaam, tussenvoegsel en achternaam | firstname en lastname | |
Functie | jobTitle | |
Afdeling | department | |
Bedrijf | company | |
Datum uit dienst | State via manageUserState |
Gerelateerd
ADP Workforce Now → Nmbrs
ADP Workforce Now Nmbrs koppeling: de Nederlandse payrollgroep uit ADP in het juiste Nmbrs-bedrijf
AlexisHR → Nmbrs
AlexisHR (Simployer One) Nmbrs koppeling: Nederlandse medewerkers in de salarisadministratie
BambooHR → Nmbrs
BambooHR Nmbrs koppeling: Nederlandse salarisadministratie naast een globaal HR-systeem
Bullhorn → Nmbrs
Bullhorn Nmbrs koppeling: plaatsingen met uurloon en einddatum in de verloning