Identity en access management

BuddeeHR Okta koppeling: Buddee als HR-bron voor Okta

Met een koppeling tussen BuddeeHR en Okta wordt elke medewerker uit Buddee een Okta-gebruiker met functie, afdeling, locatie, soort dienstverband en leidinggevende, en volgen de groepen in Okta de positie die op die dag geldt. Na het laatste contract in Buddee deactiveert Okta de gebruiker, en het Okta-loginadres gaat terug naar Buddee als werkadres.

Bespreek je koppeling Zo werkt de koppeling

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

Wat de koppeling doet

Organisaties die HR in BuddeeHR doen en Okta voor toegang gebruiken, zetten nieuwe collega's nu met de hand in Okta. Een overstap naar een andere afdeling per de eerste van de maand wordt te vroeg of te laat doorgevoerd, en een uitzendkracht met een reeks tijdelijke contracten verliest tussen twee contracten soms zijn toegang.

In Buddee komt een apart account voor de koppeling, en in Okta een eigen HR-bron met een service-app voor KoppelHet.
KoppelHet leest medewerkers, dienstverbanden, contracten en posities en kiest de positie die die dag geldt.
KoppelHet levert nieuwe en gewijzigde medewerkers, groepen en lidmaatschappen in één Okta-sessie.
Okta maakt de gebruiker aan; KoppelHet zet het loginadres terug in het werkadres in Buddee.
Na het laatste contract in de reeks levert KoppelHet een verwijdering, en Okta deactiveert de gebruiker.

Heen: Okta-gebruiker uit een eigen HR-bron · Groepen per afdeling, locatie en bedrijf · Soort dienstverband als tekstattribuut · Werkadres terug naar Buddee
Terug: Het Okta-loginadres gaat via de Buddee-API terug naar het werkadres van de medewerker.

Waar je op let bij BuddeeHR en Okta

Buddee biedt inloggen met Microsoft of Google, maar geen koppeling met Okta. KoppelHet gebruikt de eigen HR-bron van Okta, zodat Buddee bepaalt wie er een Okta-gebruiker krijgt en Okta daarna de apps regelt.
Buddee geeft lijsten in pagina's van tweehonderd, en Okta neemt per verzoek hoogstens tweehonderd gebruikers aan, met vijftig verzoeken per sessie. KoppelHet zet bij de eerste vulling elke Buddee-pagina om in één verzoek en verdeelt een grote organisatie over meer sessies na elkaar.
Contracten staan in Buddee als reeks met een volgnummer en een kenmerk voor het laatste contract. KoppelHet levert een medewerker pas als verwijdering aan Okta als het laatste contract van de reeks is afgelopen, zodat een uitzendkracht tussen twee tijdelijke contracten zijn Okta-gebruiker houdt.
Naast de leidinggevende kent Buddee een indirect leidinggevende, een HR-manager en een buddy. Okta heeft alleen een veld voor de manager; KoppelHet vult dat met de directe leidinggevende en zet de buddy in een eigen tekstattribuut, zodat een Okta-workflow de buddy bij de start een bericht kan sturen.
Afdeling, locatie en functie staan in Buddee als posities met een begin- en einddatum. Okta neemt geen lijsten aan uit een eigen HR-bron. KoppelHet kiest de positie die vandaag geldt en levert die op de ingangsdatum, zodat de groepen in Okta pas wisselen op de dag van de overstap.
Buddee kent zes soorten dienstverband, van werknemer tot zzp'er en vrijwilliger. KoppelHet zet het soort als tekst in Okta, zodat een groepsregel een vrijwilliger of zzp'er alleen de apps geeft die bij zijn rol horen.
De Buddee-API meldt zich aan met e-mail en wachtwoord van een gewone gebruiker. Verplicht een organisatie later inloggen met Microsoft of Google, dan moet dat koppelaccount een wachtwoord houden. KoppelHet gebruikt een apart account met alleen de nodige rechten en sluit het uit van de HR-bron voor Okta.

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

Heeft Buddee een Okta-koppeling?

Niet volgens de integratiepagina van Buddee; die noemt inloggen met Microsoft en Google. KoppelHet levert Buddee aan Okta via de eigen HR-bron.

Gaan er salaris- of bankgegevens naar Okta?

Nee. KoppelHet leest geen salarissen en laat IBAN en BSN uit het medewerkerrecord direct vallen.

Technische details voor IT

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

Buddee via de REST API op api.buddee.nl: /employees (company_id, number, first_name, composed_last_name, manager_id, buddy_id, work_email), /employments (type, start_date, end_date), /contracts (sequence_number, is_last_in_sequence, start_date, end_date) en /positions (job_id, department_id, location_id, manager_id met start_date en end_date); per_page 200; filter active=1. Basic Auth op /auth/token, daarna JWT-accesstoken met refreshtoken. Terugschrijven via PUT /employees/{id} (work_email).
Okta via de Identity Sources API (Custom Identity Source) met een service-app: één sessie tegelijk per bron, bulk-upsert met externalId en alleen tekstattributen (200 per verzoek, 50 verzoeken per sessie), groepen en lidmaatschappen apart, bulk-delete deactiveert. Alleen importType INCREMENTAL.

Welke velden overgaan

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

Veld in BuddeeHR	Veld in Okta	Toelichting
`company_id + number`	`externalId en employeeNumber`	number is uniek binnen een bedrijf
`first_name`	`firstName`
`composed_last_name_prefix + composed_last_name`	`lastName`
`Naamgevingsregel of work_email`	`email en login`
`Functie (job_id, positie van vandaag)`	`title`
`Afdeling (department_id)`	`department en groep`
`Locatie (location_id)`	`Groep per locatie`
`manager_id`	`managerId`	Externe ID van de leidinggevende
`buddy_id`	`Eigen attribuut buddy (tekst)`
`employment.type`	`userType`
`Laatste contract in de reeks`	`Uit de HR-bron (deactiveren)`

Bronnen

BuddeeHR Okta koppeling: Buddee als HR-bron voor Okta

Wat de koppeling doet

Waar je op let bij BuddeeHR en Okta

Hoe we het bouwen en beheren

Implementatie en prijs

Veelgestelde vragen

Heeft Buddee een Okta-koppeling?

Gaan er salaris- of bankgegevens naar Okta?

Technische details voor IT

Welke velden overgaan

Gerelateerd

BuddeeHR → Active Directory

BuddeeHR → AllSolutions

BuddeeHR → Arbodienst (SIVI)

BuddeeHR → Microsoft Entra ID

Welke systemen wil je koppelen?