Identity en access management

BuddeeHR Active Directory koppeling: domeinaccount uit dienstverband en positie in Buddee

Met een koppeling tussen BuddeeHR en Active Directory krijgt elke nieuwe medewerker in Buddee een domeinaccount met functie, afdeling, locatie en leidinggevende uit zijn positie in Buddee. Na de einddatum van het dienstverband in Buddee schakelt het programma van KoppelHet het account in Active Directory uit, en het nieuwe werkadres gaat terug naar Buddee.

Bespreek je koppeling Zo werkt de koppeling

Geschreven door Marcel van Beek, oprichter en integratiespecialistLaatst bijgewerkt: 9 november 2026

Wat de koppeling doet

Organisaties met HR in Buddee en een eigen domein met Active Directory maken accounts aan via een formulier of ticket. Een overplaatsing naar een andere afdeling of locatie staat wel in Buddee, maar in het domein blijven de oude groepen en het oude adres staan.

IT plaatst eenmalig het programma van KoppelHet in het domein, en HR maakt in Buddee een apart account voor de koppeling.
KoppelHet leest medewerkers, dienstverbanden en posities uit Buddee.
Voor een nieuwe medewerker maakt het programma een account aan in de OU van zijn bedrijf, met inlognaam volgens de afgesproken regel.
Het werkadres gaat terug naar Buddee; een nieuwe positie past afdeling, locatie en groepen aan op de begindatum.
Na de einddatum van het dienstverband wordt het account uitgeschakeld en verplaatst naar de OU voor vertrekkers.

Heen: Domeinaccount met inlognaam, UPN en personeelsnummer · Functie, afdeling, locatie en kostenplaats · Leidinggevende · OU per bedrijf en groepen per soort dienstverband · Werkadres terug naar Buddee
Terug: Werkadres uit Active Directory als zakelijk e-mailadres in Buddee

Waar je op let bij BuddeeHR en Active Directory

Functie, afdeling, locatie, kostenplaats en leidinggevende staan in Buddee op een positie met een eigen begin- en einddatum, los van het dienstverband. Het programma voert een overplaatsing in het domein door op de begindatum van de nieuwe positie, zodat mappen van de oude afdeling tot die dag blijven werken.
Buddee heeft naast de datum in dienst een aparte eerste werkdag. KoppelHet maakt het account klaar voor de eerste werkdag en zet het pas daarna aan, zodat een contract dat eerder ingaat dan de echte start geen account oplevert dat weken ongebruikt openstaat.
Het zakelijke e-mailadres is in Buddee via de API te wijzigen. Na het aanmaken schrijft KoppelHet de UPN uit Active Directory terug als werkadres, zodat de uitnodiging voor Buddee en meldingen naar het nieuwe zakelijke adres gaan.
Buddee kent soorten dienstverband als medewerker, stagiair, zzp'er, uitzendkracht, DGA en vrijwilliger. In het domein worden dat groepen, zodat een uitzendkracht of vrijwilliger alleen bij de mappen en programma's komt die bij zijn rol horen.
Bij een medewerker in Buddee staan ook BSN, IBAN en noodcontact. Het programma in het domein krijgt alleen de velden die het account nodig heeft, zodat die gegevens niet in Active Directory en niet bij beheerders van het domein terechtkomen.
Buddee geeft per pagina hoogstens 200 records en kent een filter op actieve medewerkers die niet gearchiveerd zijn. KoppelHet leest toch ook gearchiveerde medewerkers, omdat een archivering in Buddee anders onopgemerkt blijft en het domeinaccount aan zou blijven.
De koppeling meldt zich aan bij Buddee met e-mail en wachtwoord van een gewone gebruiker. Krijgt die gebruiker zelf ook een domeinaccount, dan kan zijn wachtwoordbeleid de koppeling stilleggen; daarom valt het koppelaccount buiten de synchronisatie.

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

Veelgestelde vragen

Moeten er poorten open in de firewall?

Nee. Het programma in het domein maakt zelf een uitgaande verbinding met het KoppelHet-platform.

Werkt dit ook met Entra ID?

Ja. Wordt het domein naar Microsoft 365 gesynchroniseerd, dan komen de gegevens via die synchronisatie in Entra ID. Een directe koppeling met Entra ID is een aparte koppeling.

Wat gebeurt er met de buddy en de HR-manager uit Buddee?

Die nemen we niet mee. Alleen de directe leidinggevende van de positie wordt manager in Active Directory.

Technische details voor IT

Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.

Buddee wordt gelezen via api.buddee.nl na Basic Auth op /auth/token (JWT-accesstoken en refreshtoken): GET /employees (company_id, number, first_name, composed_last_name, work_email, first_day_at_work_date, archived_at), /employments (type, start_date, end_date) en /positions (job_id, department_id, location_id, cost_center_id, manager_id met start_date en end_date); 200 per pagina. Terugschrijven met PUT /employees/{id} (work_email).
Een KoppelHet-agent in het domein schrijft via een uitgaande verbinding employeeID, sAMAccountName (maximaal 20 tekens, uniek in het domein), userPrincipalName, mail, givenName, sn, displayName, title, department, physicalDeliveryOfficeName, company, manager, een extensionAttribute voor de kostenplaats en userAccountControl; OU per bedrijf.

Welke velden overgaan

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

Veld in BuddeeHR	Veld in Active Directory	Toelichting
`company_id + number`	`employeeID`	Het nummer is alleen per bedrijf uniek
`Naamgevingsregel`	`sAMAccountName`	Maximaal 20 tekens
`Naamgevingsregel met domein`	`userPrincipalName en mail`
`first_name`	`givenName`
`composed_last_name_prefix + composed_last_name`	`sn en displayName`
`job_id van de actieve positie`	`title`
`department_id van de actieve positie`	`department en groepen`
`location_id`	`physicalDeliveryOfficeName`
`cost_center_id`	`Eigen attribuut kostenplaats`
`manager_id`	`manager`
`employment.type`	`Groepen per soort dienstverband`
`employment.end_date`	`userAccountControl (uitgeschakeld)`
`userPrincipalName`	`work_email`	Terugweg naar Buddee

Bronnen

BuddeeHR Active Directory koppeling: domeinaccount uit dienstverband en positie in Buddee

Wat de koppeling doet

Waar je op let bij BuddeeHR en Active Directory

Hoe we het bouwen en beheren

Implementatie en prijs

Veelgestelde vragen

Moeten er poorten open in de firewall?

Werkt dit ook met Entra ID?

Wat gebeurt er met de buddy en de HR-manager uit Buddee?

Technische details voor IT

Welke velden overgaan

Gerelateerd

BuddeeHR → AllSolutions

BuddeeHR → Arbodienst (SIVI)

BuddeeHR → Microsoft Entra ID

BuddeeHR → Exact Online

Welke systemen wil je koppelen?