Nmbrs logoActive Directory logo

Identity en access management

Nmbrs Active Directory koppeling: accounts vanuit de salarisadministratie

Met een koppeling tussen Nmbrs en Active Directory krijgt een nieuwe medewerker in Nmbrs automatisch een account in Active Directory, met functie, afdeling en groepen, en wordt het account na de laatste werkdag uitgeschakeld. Ook zonder apart HR-systeem hoort IT zo op tijd van nieuwe collega's, en salarisgegevens blijven buiten beeld.

Wat de koppeling doet

Organisaties die de salarisadministratie in Nmbrs doen zonder apart HR-systeem, hebben in Nmbrs de enige lijst van wie er werkt. IT beheert Active Directory en hoort van nieuwe collega's via een losse melding, vaak pas op de eerste werkdag.

  1. IT installeert eenmalig een klein programma van KoppelHet in het eigen netwerk, en iemand met toegang tot Nmbrs geeft de koppeling toestemming.
  2. De salarisadministratie voert een nieuwe medewerker in in Nmbrs.
  3. Het account staat daarna in Active Directory in de map van het juiste bedrijf, met functie, afdeling en leidinggevende.
  4. Een nieuwe functie of afdeling in Nmbrs gaat in vanaf de salarisperiode waarin hij is vastgelegd; gegevens en groepen passen zich aan.
  5. Na de einddatum van het dienstverband wordt het account uitgeschakeld en apart gezet bij de vertrokken medewerkers.
Nmbrs → KoppelHet → Active DirectoryBRONNmbrsDOELActive DirectoryKoppelHetmapping · logging · monitoringNmbrs → KoppelHet → Active DirectoryBRONNmbrsDOELActive DirectoryKoppelHetmapping · logging · monitoring
Heen: Gebruikersaccount met gebruikersnaam en e-mailadres · Map per bedrijf in Nmbrs · Functie en afdeling · Leidinggevende · Beveiligingsgroepen

Waar je op let bij Nmbrs en Active Directory

  • Draait de koppeling met Active Directory nu op een eigen script, dan werkt dat script na 1 maart 2027 waarschijnlijk niet meer, want Nmbrs stopt dan met zijn oude koppelvorm. KoppelHet bouwt deze koppeling meteen op de nieuwe, zodat er geen tweede migratie nodig is.
  • De koppeling vraagt in Nmbrs alleen leesrechten op persoons- en dienstverbandgegevens en de bedrijfsstructuur. Loon- en salarisgegevens kan ze niet zien.
  • Functie en afdeling hebben in Nmbrs een startperiode, geen exacte datum. Een functiewissel geldt dus per salarisperiode; KoppelHet voert hem in Active Directory door op de eerste dag van die periode.
  • Functies en afdelingen zijn in Nmbrs lijsten per bedrijf. Elke functie koppelen we aan een of meer groepen. Maakt de salarisadministratie een nieuwe functie aan zonder afspraak over groepen, dan krijgt de medewerker alleen de basisgroepen en ziet IT een melding.
  • Een terugkerende medewerker krijgt in Nmbrs een nieuw dienstverband onder hetzelfde personeelsnummer. KoppelHet herkent hem daaraan en zet het oude account weer aan in plaats van een tweede aan te maken.
  • Eén Nmbrs-omgeving bevat vaak meerdere bv's. Elke bv krijgt een eigen map en eventueel een eigen e-maildomein, zodat het beleid per bv kan verschillen.
  • Nmbrs meldt wijzigingen direct, maar Active Directory staat achter jullie firewall. De melding komt binnen op het KoppelHet platform, en het programma in jullie netwerk haalt de opdracht daar op.

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

We hebben geen HR-systeem, alleen Nmbrs. Is dat genoeg?

Ja. Nmbrs heeft naam, dienstverband, functie, afdeling en leidinggevende, en dat is wat Active Directory nodig heeft.

Kan het e-mailadres terug naar Nmbrs?

Dat kan. We doen het alleen als jullie dat willen, omdat de koppeling dan ook in Nmbrs mag schrijven.

Werkt dit ook als ons salaris bij een administratiekantoor loopt?

Meestal wel. De toestemming moet komen van een Nmbrs-gebruiker met toegang tot jullie bedrijven; welke login dat is, stemmen we af met het kantoor.

Wat als we naar Entra ID zonder Active Directory gaan?

Dan blijft de Nmbrs-kant gelijk en zetten we het doel om naar Entra ID.

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, met alleen leesscopes (zoals employee.employment.read) voor persoons- en dienstverbandgegevens en de bedrijfsstructuur; geen loon- of salarisscopes. Webhooks bij wijzigingen, met een periodieke vergelijking per bedrijf. De SOAP API stopt per 1 maart 2027.
  • Een KoppelHet-agent in het domein haalt opdrachten op via een uitgaande verbinding. Organizational unit (OU) en eventueel UPN-achtervoegsel per bedrijf.
  • AD-attributen onder meer employeeID (EmployeeNumber), givenName, sn, sAMAccountName, userPrincipalName, mail, title, department, company, manager en userAccountControl.

Welke velden overgaan

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

Veld in NmbrsVeld in Active DirectoryToelichting
EmployeeNumberemployeeID
Nickname of FirstNamegivenNameRoepnaam als die in Nmbrs staat
Prefix + LastNamesnMet PartnerPrefix en PartnerLastName als de naamstelling dat vraagt
NaamgevingsregelsAMAccountName, userPrincipalName en mail
Function (Description)title
Department (Description)department
Bedrijf in Nmbrscompany en OU
Manager (Email of Number)managerGekoppeld aan het AD-account met hetzelfde e-mailadres of personeelsnummer
Employment StartDateAccount inschakelen
Employment EndDateuserAccountControl (uitgeschakeld)

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.