Identity en access management
Nmbrs Ping Identity koppeling: gebruikers in PingOne vanuit de salarisadministratie
Met een koppeling tussen Nmbrs en Ping Identity heeft een nieuwe medewerker uit Nmbrs automatisch een gebruiker in PingOne, in de populatie van zijn Nmbrs-bedrijf en met afdeling, functie en leidinggevende. Na de datum uit dienst zet KoppelHet de gebruiker uit, zodat hij niet meer bij de applicaties achter PingOne kan.
Wat de koppeling doet
Organisaties die salaris en HR in Nmbrs vastleggen en inloggen via PingOne regelen, hebben een nieuwe collega in Nmbrs ruim voor zijn startdatum staan. In PingOne komt hij pas als IT een verzoek krijgt, en wie vertrekt houdt toegang tot iemand de gebruiker uitzet.
- Iemand met een Nmbrs-login op werkgeversniveau geeft de koppeling leesrechten, en in PingOne komt een Worker-app met beheerrechten op identiteitsgegevens.
- KoppelHet leest per Nmbrs-bedrijf de medewerkers met afdeling, functie en leidinggevende.
- Voor een nieuwe medewerker maakt KoppelHet een gebruiker in de populatie van zijn bedrijf, die kort voor de eerste werkdag aangaat.
- De gebruiker wordt lid van de groep van zijn afdeling; wisselt de afdeling, dan verhuist het lidmaatschap mee.
- Na de datum uit dienst zet KoppelHet de gebruiker uit en verwijdert hem na de afgesproken termijn.
Waar je op let bij Nmbrs en Ping Identity
- Een Nmbrs-omgeving kan meerdere bedrijven bevatten, elk met eigen personeelsnummers. KoppelHet geeft elk bedrijf een eigen populatie in PingOne en maakt de externe sleutel uit bedrijfscode en nummer, zodat twee medewerkers met nummer 1001 twee aparte gebruikers blijven.
- Een nieuwe medewerker heeft in Nmbrs vaak nog geen zakelijk e-mailadres, en PingOne neemt maar één e-mailadres per gebruiker aan. KoppelHet vult dan het adres in volgens de naamgevingsregel en stuurt nooit het privéadres uit Nmbrs door.
- De SCIM-ingang van PingOne pagineert niet en geeft hooguit 200 gebruikers terug. Een vergelijking van alle Nmbrs-medewerkers met PingOne kan daar dus niet. KoppelHet bewaart zelf welke gebruiker bij welke medewerker hoort en zoekt gericht op die sleutel.
- Groepen kan de SCIM-ingang van PingOne niet beheren. KoppelHet maakt de groepen per afdeling via de gewone PingOne-API en zet daar de leden in, zodat applicatietoegang op afdeling meebeweegt met Nmbrs.
- Afdeling en functie gaan in Nmbrs in per salarisperiode. KoppelHet verhuist de gebruiker in PingOne op de eerste dag van die periode naar de nieuwe groep, en niet op het moment dat de salarisadministratie de wijziging invoert.
- Nmbrs bevat BSN, salaris en bankgegevens. De koppeling leest alleen medewerkergegevens en bedrijfsstructuur, en in PingOne komen alleen de velden die inloggen en applicatietoegang nodig hebben.
- Nmbrs zet zijn SOAP API op 1 maart 2027 uit. Deze koppeling gebruikt de REST API met een login op werkgeversniveau, dus een overstap later is niet nodig.
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 als Nmbrs via een administratiekantoor loopt?
Ja, met een eigen login voor de koppeling op werkgeversniveau. Een login van het kantoor zelf werkt niet.
Wat als de leidinggevende niet in Nmbrs staat?
Dan blijft het attribuut leeg en meldt het platform het, zodat HR de leidinggevende kan aanvullen.
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 REST API met OAuth 2.0 en alleen leesscopes voor medewerkers en bedrijfsstructuur (login op debiteurniveau). De SOAP API stopt per 1 maart 2027.
- PingOne wordt beschreven met een Worker-app met de rol Identity Data Admin: gebruikers via de SCIM API (/v2/DirectMappedUsers, population.id per Nmbrs-bedrijf, externalId, één e-mailwaarde; zoeken met POST /v2/DirectMappedUsers/.search op de sleutel, maximaal 200 resultaten), groepen en lidmaatschappen via de PingOne Platform API en uitzetten via enabled (PATCH mag enabled niet verwijderen).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nmbrs | Veld in Ping Identity | Toelichting |
|---|---|---|
Bedrijfscode + personeelsnummer | externalId | Uniek over alle bedrijven |
Naamgevingsregel | username | |
Roepnaam | name.given | |
Achternaam volgens naamstelling | name.family | |
Zakelijk e-mailadres of naamgevingsregel | email | |
Functie (omschrijving) | title | |
Afdeling | Groep en eigen attribuut afdeling | |
Leidinggevende | Eigen attribuut leidinggevende | |
Nmbrs-bedrijf | population.id | |
Datum uit dienst | enabled |
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