

Identity en access management
Unit4 HR Active Directory koppeling: accounts uit Unit4 ERPx in het eigen domein
Met een koppeling tussen Unit4 HR en Active Directory maakt een nieuwe medewerker in Unit4 ERPx automatisch een account in Active Directory aan, in de map van zijn bedrijf of organisatie-eenheid en met functie, afdeling en leidinggevende. Na de einddatum van zijn laatste dienstverband wordt het account uitgeschakeld en apart gezet.
Wat de koppeling doet
Organisaties die Unit4 ERPx gebruiken voor HR en financiën en daarnaast een eigen Active Directory hebben, laten IT accounts maken op basis van een formulier of een overzicht uit Unit4. Overplaatsingen naar een andere eenheid of kostenplaats komen daardoor laat of niet in Active Directory, en groepsrechten blijven bij de oude afdeling hangen.
- IT installeert eenmalig het programma van KoppelHet op een server in het domein, en Unit4 levert een aparte client voor deze koppeling.
- KoppelHet vraagt periodiek de medewerkers op die sinds de vorige ronde zijn gewijzigd.
- Voor een nieuwe medewerker maakt het programma een account aan in de juiste map, met gebruikersnaam volgens de naamgevingsregel.
- Bij een overplaatsing verhuist het account op de ingangsdatum en wisselen de groepen mee.
- Na de laatste werkdag wordt het account uitgeschakeld en naar de map voor vertrekkers verplaatst.
Waar je op let bij Unit4 HR en Active Directory
- In Unit4 delen HR en finance dezelfde medewerker. Een andere kostenplaats op de medewerker heeft gevolgen voor projectboekingen, en is in Active Directory vaak de basis voor mappen of printers. KoppelHet neemt de kostenplaats daarom met ingangsdatum mee, zodat Active Directory dezelfde stand heeft als de administratie.
- Unit4 stelt een plafond van 500 verzoeken per minuut en 500.000 per dag, voor alle koppelingen met de tenant samen. KoppelHet vraagt alleen de medewerkers op die sinds de vorige ronde zijn gewijzigd, zodat de koppeling met Active Directory de financiële koppelingen niet in de weg zit.
- Unit4 raadt aan om bij het ophalen van wijzigingen ook de grens van de vorige ronde mee te nemen, zodat er niets tussen valt. Daardoor komt een medewerker soms twee keer binnen. Het programma in het domein schrijft alleen als er echt iets anders is, zodat accounts niet onnodig worden aangeraakt.
- Meldingen bij wijzigingen biedt Unit4 aan via zijn eigen Extension Kit. Zonder die module leest KoppelHet op een vast interval; met Extension Kit kan een wijziging in Unit4 de ronde direct starten.
- Een medewerker kan in Unit4 de status actief, beëindigd of met verlof hebben. KoppelHet schakelt een account bij verlof niet uit, tenzij jullie dat zo afspreken, maar wel bij beëindigd na de laatste werkdag.
- Welk gegeven in Unit4 de afdeling en de leidinggevende draagt, verschilt per inrichting, want Unit4 legt die vast als relaties op de medewerker. KoppelHet legt die keuze vooraf met jullie vast en vertaalt elke organisatie-eenheid naar een map en groep in Active Directory.
- Een tenant met meerdere bedrijven geeft elk bedrijf een eigen map en, als jullie dat willen, een eigen achtervoegsel voor de inlognaam. Resourcenummers die in twee bedrijven voorkomen, krijgen in Active Directory een bedrijfscode ervoor.
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
Moeten er poorten open voor deze koppeling?
Nee. Het programma in jullie domein maakt zelf een uitgaande verbinding met het KoppelHet platform.
Hebben we Extension Kit nodig?
Nee. Zonder Extension Kit werkt de koppeling met een vast interval. Met Extension Kit kan een wijziging sneller doorkomen.
Wat gebeurt er met accounts die niet uit Unit4 komen?
Die blijven buiten beeld, zolang ze niet in de mappen staan die de koppeling beheert. Welke mappen dat zijn, spreken we vooraf af.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Unit4 ERPx wordt gelezen via de ObjectAPI (GET /v1/objects/employees) met OAuth 2.0 client credentials via Unit4 Identity Services, incrementeel met filter=lastUpdated/updatedAt ge en paginering met limit en offset (maximaal 50.000 records per call). Tenantlimieten 500 verzoeken per minuut en 500.000 per 24 uur voor alle M2M-clients samen. Events via Message Hub en Extension Kit (optioneel).
- Een KoppelHet-agent in het domein voert de wijzigingen uit via een uitgaande verbinding. AD-attributen onder meer employeeID, sAMAccountName (maximaal 20 tekens), userPrincipalName, givenName, sn, displayName, title, department, company, manager, een extensionAttribute voor de kostenplaats en userAccountControl; OU per bedrijf of organisatie-eenheid.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Unit4 HR | Veld in Active Directory | Toelichting |
|---|---|---|
personId (resourcenummer) | employeeID | |
Naamgevingsregel | sAMAccountName | Maximaal 20 tekens; bij dubbelen een volgnummer |
nameInformation.firstName en surname | givenName, sn en displayName | |
Positie van het hoofddienstverband | title en groepen | |
Organisatie-eenheid uit de relaties | department en OU | |
Kostenplaats uit de relaties | Eigen attribuut kostenplaats | |
companyId | company | |
Leidinggevende uit de relaties | manager | |
Einde laatste dienstverband | userAccountControl (uitgeschakeld) |
Gerelateerd
Greenhouse → Unit4 HR
Greenhouse Unit4 HR koppeling: geaccepteerd aanbod als medewerker in het juiste Unit4-bedrijf
Recruitee → Unit4 HR
Recruitee Unit4 HR koppeling: aangenomen kandidaat als medewerker in Unit4, gecontroleerd voordat hij wordt opgeslagen
SmartRecruiters → Unit4 HR
SmartRecruiters Unit4 HR koppeling: aanname op de positie uit SmartRecruiters, met onboardingstatus terug
Teamtailor → Unit4 HR
Teamtailor Unit4 HR koppeling: aangenomen kandidaten als medewerker in Unit4 ERPx, met bedrijf en positie