Identity en access management
ADP iHCM JumpCloud koppeling: medewerkers uit iHCM als JumpCloud-gebruikers, geschorst bij vertrek
Met een koppeling tussen ADP iHCM en JumpCloud komt elke medewerker uit iHCM als JumpCloud-gebruiker binnen, met functie, afdeling, kostenplaats en leidinggevende, en wordt hij geschorst als hij in iHCM uit dienst is. KoppelHet richt de import in op het workerID en de statuswaarden van iHCM, of levert een eigen lijst als dat beter past.
Wat de koppeling doet
Organisaties die ADP iHCM gebruiken voor hun Europese medewerkers en JumpCloud voor accounts en apparaten, willen dat de accounts het HR-systeem volgen. Een import op de associateOID mist medewerkers die er geen hebben, en een statusregel op de verkeerde waarden schorst vertrekkers niet.
- Met ADP regelen we API-toegang voor iHCM, met client-ID, secret en certificaat, en zetten de Worker API aan in de Consumer Application Registry.
- KoppelHet test vooraf met jullie gegevens of elke medewerker een associateOID heeft en welke statuswaarden voorkomen.
- Klopt dat, dan richten we de Custom API-import van JumpCloud in met een statusregel op de iHCM-waarden; zo niet, dan leest JumpCloud een lijst van KoppelHet.
- Na een proefronde met de preview zetten we de geplande import aan.
- KoppelHet bewaakt het certificaat, dat na twee jaar vervalt, en de laatste geslaagde import.
Waar je op let bij ADP iHCM en JumpCloud
- ADP schrijft in de iHCM-gids dat niet iedere medewerker in iHCM een associateOID heeft. KoppelHet zet daarom het workerID als unieke sleutel in de import, zodat geen medewerker stil uit de import valt.
- Een statusregel op Terminated, Retired of Deceased schorst die gebruikers en activeert alle anderen. De iHCM-gids gebruikt voor actieve medewerkers de waarde current. KoppelHet bouwt de regel op de waarden die in jullie iHCM voorkomen, zodat een vertrekker echt wordt geschorst.
- De import vraagt ADP in pagina's van vijftig met $top en $skip, en leest het totaal uit meta.totalNumber. iHCM staat hooguit honderd per aanroep toe en meldt het einde met een lege respons. Of iHCM dat totaal teruggeeft, beschrijft ADP niet; geeft het niets, dan zetten we het totaal in JumpCloud op niet beschikbaar.
- In iHCM kan een medewerker een 'Reports to' en een supervisor hebben, en ADP stuurt verlofaanvragen naar 'Reports to'. KoppelHet mapt 'Reports to' als manager; JumpCloud vult dat veld pas als de leidinggevende zelf al als gebruiker bestaat.
- Voor de import vraagt JumpCloud een client-ID en secret uit het ADP API-pakket plus een certificaat voor mutual TLS, dat twee jaar geldig is. Verloopt het certificaat, dan stopt de import. KoppelHet zet de vervaldatum in de bewaking en vraagt op tijd een nieuw certificaat aan.
- Filteren op werktoewijzing kan in de Worker API van iHCM niet, dus ook niet op land. Horen niet alle iHCM-landen in deze JumpCloud-omgeving, dan levert KoppelHet een eigen lijst met alleen de juiste landen, die JumpCloud met dezelfde Custom API-import leest.
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
Wordt een vertrekker verwijderd uit JumpCloud?
Nee, de statusregel schorst hem. Verwijderen blijft een keuze van IT.
Wat als het ADP-certificaat verloopt?
Dan stopt de import. KoppelHet bewaakt de vervaldatum en vraagt op tijd een nieuw certificaat aan.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- JumpCloud Custom API-import: Base URL https://api.adp.com/hr/v2, token-URL https://accounts.adp.com/auth/oauth/v2/token, OAuth 2.0 Client Credentials, mutual TLS met certificaat en privésleutel (PEM), endpoint /workers?count=true, Resource Location workers, offset-paginering $top 50 en $skip vanaf 0, totaal via meta.totalNumber; Unique ID workerID; State via manageUserState op workerStatus.statusCode.codeValue.
- ADP iHCM Worker Management API: GET /hr/v2/workers met $top (standaard en maximaal 100, daarboven een fout) en $skip, lege respons aan het einde; per persoon op associateOID of, zonder associateOID, op workerID; filter workerStatus/statusCode/codeValue eq 'current'; geen filters op WorkAssignment; toegang via de Consumer Application Registry (CAR).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in ADP iHCM | Veld in JumpCloud | Toelichting |
|---|---|---|
workerID (idValue) | Unique ID en employeeIdentifier | In plaats van associateOID |
person.legalName | firstname, lastname | |
businessCommunication.email | Company email en Username | |
workAssignments (primair): jobTitle | jobTitle | |
workAssignments (primair): homeOrganizationalUnits | department | |
assignmentCostCenters | costCenter | |
reportsTo ('Reports to') | manager | |
workerStatus.statusCode.codeValue | State via manageUserState |
Gerelateerd
ADP iHCM → Active Directory
ADP iHCM Active Directory koppeling: netwerkaccounts per land, met vervaldatum bij tijdelijke contracten
ADP iHCM → Coupa
ADP iHCM Coupa koppeling: goedgekeurde onkosten uit Coupa als variabel looncomponent in ADP iHCM NL
DyADP iHCM → Dyflexis
ADP iHCM Dyflexis koppeling: medewerkers en contracten in de planning, uren terug naar ADP
ADP iHCM → Microsoft Entra ID
ADP iHCM Entra ID koppeling: accounts uit de ADP-payroll, in elk Europees land met de juiste licentie