Identity en access management
Nmbrs OneLogin koppeling: OneLogin-gebruikers uit de salarisadministratie
Met een koppeling tussen Nmbrs en OneLogin krijgt een nieuwe medewerker uit Nmbrs automatisch een OneLogin-gebruiker met functie, afdeling, bedrijf en leidinggevende, zodat de apps achter OneLogin op de eerste werkdag klaarstaan. Na de datum uit dienst in Nmbrs zet KoppelHet de OneLogin-gebruiker op geschorst, waarmee de toegang tot al die apps stopt.
Wat de koppeling doet
Organisaties die salaris in Nmbrs verwerken en OneLogin gebruiken voor single sign-on, maken OneLogin-gebruikers vaak met de hand aan na een bericht van HR. Rollen die op afdeling leunen kloppen dan niet, en na een vertrek blijft de gebruiker actief tot iemand eraan denkt.
- Een Nmbrs-gebruiker met alleen leesrechten geeft eenmalig toestemming voor de koppeling, voor de bedrijven die erbij horen.
- KoppelHet leest per bedrijf medewerkers, dienstverband, functie en afdeling uit Nmbrs.
- Voor een nieuwe medewerker maakt KoppelHet een OneLogin-gebruiker aan met een gebruikersnaam volgens de afgesproken regel en het Nmbrs-nummer als extern ID.
- Mappings in OneLogin kennen rollen en apps toe op basis van afdeling, functie en bedrijf.
- Na de datum uit dienst zet KoppelHet de gebruiker op geschorst en logt dat per medewerker.
Waar je op let bij Nmbrs en OneLogin
- OneLogin heeft geen directory voor Nmbrs, zoals het die wel voor Workday of Active Directory heeft. KoppelHet schrijft daarom zelf via de OneLogin API, met het Nmbrs-nummer in external_id, zodat dezelfde medewerker bij elke ronde de bestaande OneLogin-gebruiker terugvindt.
- OneLogin weigert een tweede gebruiker met dezelfde gebruikersnaam binnen het subdomein. Omdat personeelsnummers in Nmbrs alleen per bedrijf uniek zijn, bouwt KoppelHet de gebruikersnaam uit naam en domein en zet het bedrijf voor het nummer in external_id.
- Velden die OneLogin niet standaard kent, zoals de datum in dienst uit Nmbrs, moeten eerst als eigen veld in OneLogin bestaan. Een onbekende veldnaam laat de hele aanmaak mislukken. KoppelHet legt die velden vooraf samen met de OneLogin-beheerder vast.
- De leidinggevende is in OneLogin een OneLogin-ID, terwijl Nmbrs naar een collega in de salarisadministratie verwijst. KoppelHet zoekt de OneLogin-gebruiker van die collega op via external_id en maakt de leidinggevende pas na de medewerker zelf aan als ze tegelijk starten.
- Toegang tot Nmbrs loopt via toestemming van een Nmbrs-gebruiker, en die bepaalt welke bedrijven de koppeling ziet. Komt er een nieuw bedrijf bij in Nmbrs, dan moet die toestemming worden uitgebreid, anders krijgen medewerkers van dat bedrijf geen OneLogin-gebruiker.
- OneLogin draait mappings standaard pas nadat een gebruiker is aangemaakt. KoppelHet vraagt bij het aanmaken om de mappings direct uit te voeren, zodat rollen en apps al vastliggen voordat de koppeling de volgende medewerker verwerkt.
- Nmbrs is een salarispakket met BSN, loon en bankrekening. De koppeling vraagt alleen leesrechten op persoons-, dienstverband- en organisatiegegevens, zodat die loongegevens niet in OneLogin of bij KoppelHet terechtkomen.
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
Stuurt OneLogin een uitnodiging naar de nieuwe medewerker?
Niet voor gebruikers die via de API zijn aangemaakt. Hoe de medewerker zijn eerste wachtwoord of aanmelding krijgt, spreken we vooraf af.
Wat gebeurt er met de gebruiker na vertrek?
KoppelHet zet de gebruiker op geschorst. Verwijderen doen we niet, zodat de historie in OneLogin blijft. Een vaste termijn voor verwijderen kan later als uitbreiding.
Kan het werkadres terug naar Nmbrs?
Dat houden we bij de start buiten de koppeling. Terugschrijven vraagt schrijfrechten in Nmbrs en kan later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nmbrs wordt gelezen via de Nmbrs Payroll REST API met OAuth 2.0 (authorization code), met leesscopes zoals employee.employment.read; de gebruiker die toestemming geeft bepaalt de zichtbare bedrijven. De SOAP API stopt op 1 maart 2027 en wordt niet gebruikt.
- OneLogin API v2 met een API-credential met het recht Manage Users: POST /api/2/users met username, email, firstname, lastname, title, department, company, external_id, manager_user_id en custom_attributes, met mappings=sync. Opzoeken met GET /api/2/users?external_id=… (50 per pagina, filter updated_since). Status 1 is Active, 2 is Suspended.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in OneLogin | Toelichting |
|---|---|---|
Bedrijfscode + personeelsnummer | external_id | Personeelsnummers zijn per Nmbrs-bedrijf uniek |
Roepnaam | firstname | |
Achternaam volgens naamstelling | lastname | |
Naamgevingsregel | username en email | Username moet uniek zijn binnen het OneLogin-subdomein |
Functie | title | |
Afdeling | department | |
Nmbrs-bedrijf | company | |
Leidinggevende | manager_user_id | Opgezocht als OneLogin-gebruiker |
Datum in en uit dienst | custom_attributes | |
Datum uit dienst verstreken | status = 2 (Suspended) |
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