OIIdentity en access management
UKG Pro One Identity koppeling: de Starling-connector voor UKG Pro, met een eigen mapping in One Identity Manager
Met een koppeling tussen UKG Pro en One Identity Manager wordt elke medewerker uit UKG Pro een Person in One Identity Manager, met afdeling, functie, supervisor en datums, zodat rollen en attestaties op HR-gegevens draaien. One Identity heeft een Starling Connect-connector die UKG Pro kan lezen, maar geen kant-en-klaar sjabloon zoals voor Workday, SuccessFactors en Dayforce; KoppelHet bouwt die mapping en het synchronisatieproject.
Wat de koppeling doet
Organisaties met UKG Pro als HR-systeem en One Identity Manager voor identity governance lezen UKG vaak nog in via een nachtelijk bestand. Bij de overstap naar Starling Connect blijkt het Cloud HR Systems-sjabloon alleen Workday, SuccessFactors en Dayforce te dekken.
- In UKG Pro maakt de beheerder een serviceaccount met alleen leesrechten voor de webservices die de connector gebruikt.
- In Starling Connect zetten we de UKG Pro-connector aan met de gegevens van dat account.
- In de Synchronization Editor bouwt KoppelHet een project op de SCIM-connector met mappings voor Person en Department.
- Met jullie leggen we vast welk organisatieniveau de afdeling is en hoe herindiensttreding en verlof meetellen.
- Na een proefsynchronisatie in een testdatabase gaat het schema aan.
Waar je op let bij UKG Pro en One Identity
- Starling Connect heeft sinds oktober 2023 een UKG Pro-connector, volgens One Identity bedoeld om medewerkers te lezen. Hij maakt niets aan in UKG en schrijft niets terug. Een vertrek begint dus altijd in UKG Pro; One Identity Manager volgt.
- De Cloud HR Systems-module van One Identity Manager levert sjablonen voor SuccessFactors, Workday en Dayforce, met kant-en-klare mappings en workflows. Voor UKG Pro zit er geen sjabloon in. KoppelHet bouwt de mapping naar Person en Department zelf op de SCIM-connector en legt hem vast in de overdracht.
- In januari 2024 kreeg de UKG Pro-connector de endpoints EmpJobs en EmpEmployments erbij, en veranderde het formaat van het id-attribuut. Een synchronisatieproject van voor die tijd kan op een oude sleutel draaien. KoppelHet controleert bij de start welk formaat jullie omgeving gebruikt, zodat er geen dubbele Persons ontstaan.
- UKG Pro heeft vier organisatieniveaus die elke organisatie zelf invult. One Identity Manager bouwt afdelingen als boom. KoppelHet kiest met jullie welke niveaus de boom vormen en sorteert de afdelingen zo dat een bovenliggende afdeling er altijd eerst is.
- Bij een herindiensttreding houdt UKG naast de oorspronkelijke datum in dienst een dateOfLastHire bij. KoppelHet gebruikt die als EntryDate, zodat One Identity Manager de bestaande Person weer actief maakt met de nieuwe datum in plaats van een tweede Person aan te maken.
- UKG geeft de supervisor als supervisorId, het id van een andere medewerker. One Identity Manager heeft de leidinggevende nodig als verwijzing naar een andere Person. KoppelHet lost die verwijzing op na het inlezen van alle Persons, zodat attestaties niet bij een lege leidinggevende blijven hangen.
- Volgens One Identity ondersteunt de UKG Pro-connector het uitschakelen van attributen. KoppelHet zet velden uit die One Identity Manager niet nodig heeft, zoals adres en telefoon privé, zodat die persoonsgegevens niet via Starling Connect meekomen.
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
Hebben we Starling Connect nodig?
Voor deze route wel. Of het in jullie One Identity-licentie zit, controleren we vooraf met One Identity.
Schrijft One Identity Manager iets terug naar UKG Pro?
Nee, de UKG Pro-connector leest alleen. Het werkadres terugzetten kan later als uitbreiding.
Wat gebeurt er met een terugkerende collega?
Hij komt terug op zijn bestaande Person, met de datum van de laatste indiensttreding als nieuwe datum in dienst.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Starling Connect UKG Pro-connector (sinds 04-10-2023, lezen van employee resources): endpoints Employees, EmpJobs en EmpEmployments (januari 2024), uitschakelen van attributen, gewijzigd formaat van het id-attribuut. One Identity Manager Cloud HR Systems-module (9.3 of later) met de SCIM-connector; sjablonen alleen voor SuccessFactors HR, Workday HR en Dayforce, dus een eigen synchronisatieproject in de Synchronization Editor.
- UKG Pro Personnel API (onder de connector): Basic-aanmelding met US-CUSTOMER-API-KEY per tenant; velden onder meer employeeId, employeeNumber, companyId, orgLevel1Code tot orgLevel4Code, jobCode, supervisorId, isActive, employeeStatus, hireDate, dateOfLastHire en terminationDate.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in UKG Pro | Veld in One Identity | Toelichting |
|---|---|---|
id (Employees-endpoint) | Person (sleutel) | |
employeeNumber | PersonnelNumber | |
firstName, lastName | FirstName, LastName | |
orgLevel1Code tot orgLevel4Code | Department (hiërarchie) | |
jobCode (EmpJobs) | Functie op de Person | |
supervisorId | Leidinggevende (UID_PersonHead) | |
hireDate, dateOfLastHire, terminationDate (EmpEmployments) | EntryDate, ExitDate |
Gerelateerd
Recruitee → UKG Pro
Recruitee UKG Pro koppeling: Europese aannames via de Global New Hire-service in UKG Pro
Teamtailor → UKG Pro
Teamtailor UKG Pro koppeling: Europese aannames als global new hire
UKG Pro → Active Directory
UKG Pro koppelen met Active Directory: domeinaccounts voor de Nederlandse vestiging
UKG Pro → ADP iHCM
UKG Pro ADP iHCM koppeling: salaris en uitdiensttreding van de Nederlandse paygroup naar ADP