Unit4 HR logoOkta logo

Identity en access management

Unit4 HR Okta koppeling: medewerkers uit Unit4 ERPx als HR-bron voor Okta

Met een koppeling tussen Unit4 HR en Okta wordt elke goedgekeurde medewerker uit Unit4 ERPx een Okta-gebruiker, met bedrijf, afdeling, kostenplaats, functie en leidinggevende van zijn hoofddienstverband. Een wijziging gaat in Okta in op de datum die Unit4 ervoor vastlegt, en na het vertrek deactiveert Okta de gebruiker.

Wat de koppeling doet

Organisaties die HR in Unit4 ERPx vastleggen en Okta als toegangslaag hebben, krijgen nieuwe collega's in Okta via een ticket of een export. Een overplaatsing die HR weken vooruit invoert, komt in Okta te vroeg of te laat, en wie twee dienstverbanden heeft krijgt soms de rechten van het verkeerde.

  1. In Unit4 komt een machineclient voor KoppelHet, en in Okta zet het accountteam een eigen HR-bron aan.
  2. KoppelHet haalt de medewerkers op die sinds de vorige ronde zijn gewijzigd, met hun dienstverbanden en relaties.
  3. Medewerkers die nog in een goedkeuringsworkflow staan, slaat KoppelHet over tot de workflow klaar is.
  4. KoppelHet levert de gegevens van het hoofddienstverband aan de HR-bron in Okta, met groepen per bedrijf en afdeling.
  5. Na de einddatum haalt KoppelHet de medewerker uit de HR-bron, en Okta deactiveert de gebruiker.
Unit4 HR → KoppelHet → OktaBRONUnit4 HRDOELOktaKoppelHetmapping · logging · monitoringUnit4 HR → KoppelHet → OktaBRONUnit4 HRDOELOktaKoppelHetmapping · logging · monitoring
Heen: Okta-gebruiker met bedrijf en resourcenummer · Afdeling, kostenplaats en functie van het hoofddienstverband · Leidinggevende als managerId · Groepen per bedrijf en afdeling

Waar je op let bij Unit4 HR en Okta

  • Een medewerker kan in Unit4 meer dienstverbanden tegelijk hebben, en Okta neemt uit een eigen HR-bron alleen losse tekstwaarden aan, geen lijsten. KoppelHet vult functie, afdeling en kostenplaats daarom met het hoofddienstverband, en maakt van een tweede dienstverband alleen een extra groepslidmaatschap.
  • Organisatie-eenheid, kostenplaats en leidinggevende hangen in Unit4 als relaties met een datum vanaf en tot. KoppelHet levert de nieuwe waarde aan Okta op de dag dat de relatie ingaat, zodat de apps van de nieuwe afdeling niet al weken voor de overplaatsing open staan.
  • Okta beslist op het externe ID of een gebruiker nieuw is of al bestaat, en dat ID mag nooit veranderen. Een Unit4-tenant kan meerdere bedrijven hebben; KoppelHet bouwt het ID uit bedrijf en persoonsnummer, zodat een overstap naar een ander bedrijf in dezelfde tenant geen tweede Okta-gebruiker oplevert.
  • Een nieuwe medewerker kan in Unit4 eerst in een goedkeuringsworkflow staan. KoppelHet levert hem pas aan Okta als die workflow is afgerond, zodat een afgekeurde invoer geen Okta-gebruiker en geen licenties in apps oplevert.
  • Unit4 raadt aan wijzigingen op te halen vanaf het begin van de vorige ronde, waardoor een medewerker twee keer kan terugkomen. Okta verwerkt per bron één sessie tegelijk en wil binnen vijf minuten na het starten geen nieuwe. KoppelHet voegt dubbelen samen en levert elke ronde in één sessie aan.
  • Een machineclient voor koppelingen geeft Unit4 alleen via een gebruiker met de rol SUPER of SYSTEM, en een tenant heeft er hoogstens tien. Okta gebruikt een eigen service-app met een eigen sleutel. KoppelHet bewaart beide apart, zodat jullie de toegang tot Unit4 los van Okta kunnen intrekken.
  • Een sessie in Okta neemt hoogstens vijftig verzoeken van tweehonderd gebruikers. Bij de eerste vulling van een grote Unit4-tenant verdeelt KoppelHet de medewerkers over meer sessies na elkaar, en daarna gaan alleen de wijzigingen mee.

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

Laat je zakelijke e-mailadres achter, dan zie je de prijsindicatie direct.

We gebruiken je adres alleen om je vraag over deze koppeling op te volgen.

Veelgestelde vragen

Welk dienstverband telt bij twee functies?

Het hoofddienstverband in Unit4. Het tweede geeft alleen een extra groep in Okta.

Gaan er salarisgegevens naar Okta?

Nee. Alleen naam, bedrijf, organisatie, functie, leidinggevende en de datums van het dienstverband.

Technische details voor IT

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

  • Unit4 ERPx via de ObjectAPI (GET /v1/objects/employees) met OAuth 2.0 client credentials via Unit4 Identity Services (scope u4erp, token 3600 seconden, M2M-gebruiker met rol SUPER of SYSTEM, maximaal 10 per tenant). Incrementeel met filter op lastUpdated ge het begin van de vorige ronde; velden onder meer companyId, personId, nameInformation, status, employments en relatedValues met datum vanaf en tot; een invoer in workflow geeft 202.
  • Okta via de Identity Sources API (Custom Identity Source) met een service-app en OAuth 2.0; sessies (één tegelijk per bron, vijf minuten wachten na starten), bulk-upsert met externalId en alleen tekstattributen (200 per verzoek, 50 verzoeken per sessie), groepen en lidmaatschappen apart, bulk-delete deactiveert.

Welke velden overgaan

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

Veld in Unit4 HRVeld in OktaToelichting
companyId + personIdexternalIdUniek over alle bedrijven
nameInformation (voornaam)firstName
nameInformation (achternaam)lastName en displayName
Naamgevingsregel of e-mail uit Unit4email en login
Bedrijforganization en groep
Organisatie-eenheid (relatie)department en groep
Kostenplaats (relatie)costCenter
Functie van het hoofddienstverbandtitle
Leidinggevende (relatie)managerIdSleutel van de leidinggevende

Gerelateerd

Welke systemen wil je koppelen?

Vertel welke systemen je gebruikt en wat er automatisch moet gebeuren. Samen bepalen we de kleinste werkende oplossing, met een helder ontwerp en een offerte vooraf.