Nmbrs logoOI

Identity en access management

Nmbrs One Identity koppeling: medewerkers uit de salarisadministratie in One Identity Manager

Met een koppeling tussen Nmbrs en One Identity Manager staan medewerkers, bedrijven en afdelingen uit Nmbrs klaar in vaste bestanden, die de CSV-connector van One Identity Manager inleest. One Identity Manager maakt daarmee accounts en rechten aan en ziet een vertrek op de datum uit dienst, zonder dat er salarisgegevens meegaan.

Wat de koppeling doet

Organisaties met Nmbrs voor salaris en One Identity Manager voor identiteiten, lezen medewerkers vaak in via een export uit Nmbrs. Die export is gemaakt voor de salarisadministratie, telt personeelsnummers per bedrijf en staat soms nog op de oude SOAP-koppeling die Nmbrs in 2027 uitzet.

  1. Iemand met een Nmbrs-login op werkgeversniveau geeft de koppeling toestemming om medewerkers en bedrijfsstructuur te lezen.
  2. KoppelHet haalt per bedrijf medewerkers, afdelingen en functies op.
  3. KoppelHet zet een medewerkerbestand en een afdelingsbestand klaar op een plek die de synchronisatieserver kan lezen.
  4. One Identity Manager leest beide bestanden in met de CSV-connector en past zijn regels voor accounts en rechten toe.
  5. Na de datum uit dienst ziet One Identity Manager het vertrek in het bestand en volgt het eigen proces voor uit dienst.
Nmbrs → KoppelHet → One IdentityBRONNmbrsDOELOne IdentityOne IdentityKoppelHetmapping · logging · monitoringNmbrs → KoppelHet → One IdentityBRONNmbrsDOELOne IdentityOne IdentityKoppelHetmapping · logging · monitoring
Heen: Medewerkerbestand met bedrijfscode en personeelsnummer · Afdelingsbestand per Nmbrs-bedrijf · Functie en leidinggevende · Datum in en uit dienst

Waar je op let bij Nmbrs en One Identity

  • Een personeelsnummer is in Nmbrs alleen binnen één bedrijf uniek. De CSV-connector van One Identity Manager mag meer dan één sleutelkolom hebben. KoppelHet levert bedrijfscode en personeelsnummer daarom als twee kolommen die samen de sleutel vormen, zodat niemand op een collega van een ander bedrijf wordt gematcht.
  • Nmbrs legt vast of iemand de eigen naam, de partnernaam of een combinatie gebruikt. KoppelHet zet de achternaam in het bestand zoals de medewerker hem gebruikt, zodat One Identity Manager weergavenamen en e-mailadressen niet op de geboortenaam baseert als iemand dat niet wil.
  • Afdeling en functie hebben in Nmbrs een startperiode in plaats van een exacte datum. KoppelHet zet de nieuwe waarde in het bestand vanaf de eerste dag van die periode, zodat One Identity Manager rechten wisselt op hetzelfde moment als de salarisadministratie.
  • One Identity Manager leest een geïmporteerd bestand niet als bron die ontbrekende personen als openstaand kan markeren. KoppelHet laat iemand die uit dienst gaat daarom met de datum uit dienst in het bestand staan, in plaats van de regel weg te laten.
  • Afdelingen zijn in Nmbrs lijsten per bedrijf, en twee bedrijven kunnen allebei een afdeling "Verkoop" hebben. KoppelHet geeft elke afdeling een pad met het bedrijf ervoor, zodat One Identity Manager ze als aparte afdelingen in één boom ziet.
  • Nmbrs stopt op 1 maart 2027 met de SOAP API. Een export voor One Identity Manager die daarop leunt, houdt dan op. KoppelHet leest via de REST API met een login op werkgeversniveau, zodat de bestanden na die datum gewoon blijven komen.
  • Kan de synchronisatieserver de map met bestanden niet zelf bereiken, dan werkt One Identity Manager met een remote connection server. KoppelHet zet de bestanden op die server neer met een uitgaande verbinding, zodat er geen share naar buiten open hoeft.

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, architectuur en compliance

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.

Prijsindicatie · Basis

Laat je zakelijke e-mailadres achter, dan zie je de prijsindicatie direct.

We gebruiken je adres alleen om je vraag over deze koppeling op te volgen.

Veelgestelde vragen

Werkt dit met meerdere Nmbrs-bedrijven?

Ja. Alle bedrijven komen in hetzelfde bestand, met de bedrijfscode als deel van de sleutel.

Kan het werkadres terug naar Nmbrs?

Ja, maar niet via de bestanden. Als jullie dat willen, schrijft KoppelHet het adres apart terug naar Nmbrs.

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, geen loon- of bankscopes). De SOAP API stopt per 1 maart 2027.
  • One Identity Manager leest via de CSV-connector: twee bestanden in één systeemverbinding, UTF-8, vaste kopregel, twee sleutelkolommen in het medewerkerbestand (bedrijf en nummer), Hierarchical sort order op het afdelingspad, Uniqueness violation behavior op Throw error, Read-only access en Data import in de synchronisatiestap. Toegang tot de bestanden direct of via een remote connection server met RemoteConnectPlugin.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in NmbrsVeld in One IdentityToelichting
BedrijfscodeSleutelkolom 1 (bedrijf)
PersoneelsnummerSleutelkolom 2 (nummer)Samen uniek
RoepnaamFirstName
Achternaam volgens naamstellingLastName
Afdeling (code en omschrijving)Afdelingskolom en afdelingsbestand
Functie (omschrijving)Functiekolom
LeidinggevendeKolom leidinggevende (bedrijfscode + nummer)
Datum in en uit dienstEntryDate en ExitDateAltijd JJJJ-MM-DD

Gerelateerd

Welke systemen wil je koppelen?

Vertel welke systemen je gebruikt en wat er automatisch moet gebeuren. Samen bepalen we de kleinste werkende oplossing, met een helder ontwerp en een offerte vooraf.