Identity en access management
BambooHR Omada koppeling: identiteiten in Omada uit BambooHR, met de Omada-connector of maatwerk
Met een koppeling tussen BambooHR en Omada Identity leest Omada elke medewerker uit BambooHR als identiteit, met afdeling, divisie, locatie, leidinggevende en een begin- en einddatum. Omada heeft zelf een BambooHR-connector die een rapport uit BambooHR volledig inleest; KoppelHet komt erbij als je wijzigingen sneller wilt, een terugkerende medewerker aan zijn oude identiteit wilt koppelen of een functiewissel met ingangsdatum op de juiste dag wilt laten tellen.
Wat de koppeling doet
Organisaties die BambooHR voor HR en Omada voor identity governance gebruiken, zetten meestal eerst de BambooHR-connector van Omada aan. Die leest elke keer het hele rapport, zodat een vertrek of afdelingswissel pas na de volgende volledige import in Omada staat, en een terugkerende collega als nieuwe identiteit binnenkomt.
- In BambooHR komt een aparte gebruiker voor de koppeling, zonder toegang tot salaris en privégegevens, met een eigen API-sleutel.
- KoppelHet verwerkt meldingen uit BambooHR en houdt per medewerker één regel bij met de gegevens die vandaag gelden.
- In Omada richt de beheerder de REST-collector in op het adres van KoppelHet, met identiteiten, contexten en eigenaren.
- Bij livegang zetten we een drempel op verwijderde identiteiten, zodat een fout in de bron niet iedereen in één keer laat verdwijnen.
- Na een vertrek blijft de regel staan met de einddatum, zodat Omada toegang intrekt op de dag die HR heeft vastgelegd.
Waar je op let bij BambooHR en Omada
- De BambooHR-connector van Omada ondersteunt alleen importeren, en alleen volledig. Hij leest steeds het hele rapport. KoppelHet reageert op de meldingen van BambooHR en houdt de regels actueel, zodat Omada bij elke import de nieuwste stand ziet, ook als die import vaker draait.
- De Omada-connector leest een bedrijfsrapport in BambooHR, aangewezen met het nummer uit de URL van dat rapport. Past iemand in BambooHR het rapport aan of verwijdert hij het, dan mist Omada velden of stopt de import. KoppelHet leest de velden via de API van BambooHR en hangt niet aan een rapport dat HR kan wijzigen.
- In BambooHR zijn afdeling, divisie en locatie tekstvelden op de medewerker, geen eigen objecten. Omada maakt er contexten van met de naam als sleutel. Wordt een afdeling hernoemd, dan ontstaat in Omada een nieuwe context en hangen rollen nog aan de oude. KoppelHet geeft elke afdeling een vaste sleutel en houdt een hernoeming bij als wijziging van naam.
- BambooHR bewaart naast de laatste datum in dienst ook de oorspronkelijke. KoppelHet herkent daarmee een terugkerende medewerker en levert hem onder zijn eerdere business key, zodat Omada de identiteit en de historie van reviews houdt.
- Functie en afdeling staan in BambooHR in de tabel jobInfo, met een ingangsdatum per regel, ook voor wijzigingen in de toekomst. KoppelHet levert de regel die vandaag geldt, zodat een promotie per volgende maand niet nu al andere rechten in Omada geeft.
- De API-sleutel van BambooHR hoort bij een gebruiker en ziet alleen wat die gebruiker mag zien; Omada toont een slotje bij velden zonder recht. Een ontbrekende afdeling wordt zo een identiteit zonder context. KoppelHet controleert of de verwachte velden gevuld zijn en houdt een onvolledige regel vast op de vorige stand.
- Omada zet in het voorbeeld een lege status uit BambooHR om naar Inactive. Een medewerker met een tijdelijk lege status zou zo zijn toegang verliezen. KoppelHet leidt de status af uit de geschiedenis van de dienstverbandstatus en de einddatum, en levert nooit een lege status.
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
Kan Omada daarna zelf accounts maken in Entra ID of Active Directory?
Ja, met de connectoren van Omada. KoppelHet levert alleen de HR-bron.
Gaan er salarisgegevens naar Omada?
Nee. De gebruiker achter de API-sleutel heeft geen toegang tot salaris.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Omada BambooHR-connector (Omada Identity v14 update 10, BambooHR REST v1): alleen import, alleen volledig. Basic authentication met de API-sleutel als gebruikersnaam en een willekeurig wachtwoord; Base URL api.bamboohr.com/api/gateway.php/{bedrijf}/v1; identiteiten uit reports/{id}; mapping onder meer id, displayName, hireDate (Valid from), terminationDate (Valid to) en supervisorEId als eigenaar; contexten met business key 'orgunit_' plus afdeling.
- KoppelHet leest BambooHR via event-based webhooks (employee.created, employee.updated met monitor fields), het endpoint voor gewijzigde medewerkers en de tabellen jobInfo en employmentStatus. Omada leest KoppelHet via de REST-collector (Content: Identity data) met OAuth2 Client Credentials; drempels voor nieuwe, gewijzigde en verwijderde objecten.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in BambooHR | Veld in Omada | Toelichting |
|---|---|---|
id | Business key en Unique ID | |
displayName, firstName en lastName | Name, First name en Last name | |
employmentHistoryStatus | Status | |
hireDate of originalHireDate | Valid from | |
terminationDate | Valid to | |
department, division en location | Contexten (OrgUnit, Division, Location) | |
supervisorEId | Identity owner | |
jobTitle en workEmail | Job title en Email |
Gerelateerd
Ashby → BambooHR
Ashby BambooHR koppeling: aanname, gewijzigde startdatum en dienstverbandstatus in BambooHR
BambooHR → 4PS Construct
BambooHR 4PS Construct koppeling: medewerkers uit BambooHR in de 4PS-administratie van hun vestiging
BambooHR → Active Directory
BambooHR koppelen met Active Directory: accounts in je eigen domein vanuit HR
BambooHR → ADP iHCM
BambooHR ADP iHCM koppeling: salaris, bonussen en commissies naar de Nederlandse payroll