Identity en access management
Cezanne HR Okta koppeling: Okta-gebruikers uit Cezanne, en daarna Cezanne-accounts uit Okta
Met een koppeling tussen Cezanne HR en Okta krijgt een nieuwe medewerker uit Cezanne een Okta-gebruiker met functie, afdeling, locatie en bedrijf, en deactiveert Okta die gebruiker na het einde van het dienstverband in Cezanne. De SCIM-koppeling die Cezanne zelf voor Okta beschrijft, werkt de andere kant op en maakt alleen Cezanne-accounts; KoppelHet vult Okta vanuit Cezanne, zodat die SCIM-koppeling daarna de juiste persoon vindt.
Wat de koppeling doet
Organisaties die Cezanne HR voor HR gebruiken en Okta voor toegang, zetten vaak de Cezanne-app in Okta aan en verwachten dat Okta daarmee uit Cezanne gevuld wordt. Die app maakt echter Cezanne-gebruikers vanuit Okta, en de Okta-gebruiker zelf blijft handwerk van IT.
- Via de Customer Success-contactpersoon van Cezanne krijgt KoppelHet API-toegang met een koppelgebruiker die alleen de nodige werkgevers ziet.
- In Okta zet het accountteam een eigen HR-bron aan voor KoppelHet.
- KoppelHet leest personen, primaire dienstverbanden en de toewijzingen van functie, eenheid en locatie, en levert de wijzigingen aan Okta.
- Wie de SCIM-app van Cezanne gebruikt, laat Okta daarna het Cezanne-account maken op basis van de persoonscode.
- Na de einddatum van het primaire dienstverband deactiveert Okta de gebruiker.
Waar je op let bij Cezanne HR en Okta
- Cezanne beschrijft voor Okta een SCIM-koppeling waarmee Okta Cezanne-gebruikers aanmaakt en deactiveert. Gegevens van Cezanne naar Okta noemt Cezanne niet. KoppelHet levert de richting die ontbreekt, van HR naar Okta, en raakt de SCIM-instellingen van Cezanne niet aan.
- De SCIM-app van Cezanne kan alleen een account maken voor iemand die al als persoon in Cezanne staat, en zoekt die op via e-mail of via een personeelsnummer dat gelijk is aan de persoonscode of het dienstverband-id. KoppelHet zet de persoonscode uit Cezanne in employeeNumber in Okta, zodat die koppeling altijd de juiste persoon vindt.
- Via SCIM vanuit Okta kan Cezanne alleen gebruikersnaam, Cezanne-rol en e-mail bijwerken; voornaam, achternaam en personeelsnummer komen uit het Cezanne-record en veranderen niet. Namen en organisatiegegevens horen dus in Cezanne thuis, en KoppelHet neemt ze van daaruit mee naar Okta.
- Alle personen opvragen in Cezanne geeft ook toekomstige instroom; het filter op actieve medewerkers laat die juist weg. KoppelHet leest de volledige tabel met de startdatum, zodat een nieuwe collega in Okta klaarstaat en op de startdatum wordt geactiveerd.
- Een dienstverband zonder einde heeft in Cezanne 31 december 2999 als einddatum. KoppelHet behandelt die datum als leeg en plant pas een deactivering in Okta bij een echte einddatum.
- Functie, organisatie-eenheid en locatie zijn in Cezanne aparte toewijzingen met een eigen ingangsdatum. Okta neemt in een eigen HR-bron alleen tekstwaarden aan. KoppelHet levert de waarde die vandaag geldt als tekst, en wisselt de Okta-groep van locatie of eenheid op de ingangsdatum.
- Elk dienstverband in Cezanne hoort bij een bedrijfscode. KoppelHet gebruikt het primaire dienstverband voor de bedrijfsgroep en het e-maildomein in Okta, zodat iemand met een detachering naast zijn vaste baan één Okta-gebruiker houdt.
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
Doet de Cezanne-app in Okta dit niet al?
Nee. Die maakt Cezanne-accounts vanuit Okta. De Okta-gebruiker uit Cezanne maakt KoppelHet. Samen dekken ze beide richtingen.
Hebben we People PLUS+ nodig?
Nee. Zonder webhooks vergelijkt KoppelHet elk uur.
Werkt dit met meerdere werkgevers?
Ja. De bedrijfscode van het primaire dienstverband bepaalt groep en domein in Okta.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Cezanne HR API v2 (OData, dataservice.svc, JSON) met OAuth 2.0; toegang via Customer Success. Tabellen People (filter ActiveEmployee), PeopleToEmploymentCurrentPrimary, Employments (CompanyCode, TerminationDate), JobDeployments, OrgUnitPositionDeployments en LocationDeployments. Webhooks alleen bij People PLUS+.
- Okta via een Custom Identity Source (bulk-upsert van maximaal 200 profielen per verzoek, alleen tekstwaarden, bulk-delete deactiveert) of de Users API. Naast deze koppeling optioneel de Cezanne-app in Okta (SCIM, Administration > Integrations > SCIM in Cezanne, OAuth2-bearertoken, matching op e-mail of personeelsnummer).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Cezanne HR | Veld in Okta | Toelichting |
|---|---|---|
PersonCode | employeeNumber en externalId | Ook de sleutel voor de SCIM-app van Cezanne |
Voornaam en achternaam | firstName en lastName | |
Werkadres of naamgevingsregel | login en email | |
JobDeployments | title | |
OrgUnitPositionDeployments | department en groep | |
LocationDeployments | city en groep per locatie | |
CompanyCode (Employments) | organization en groep per bedrijf | |
TerminationDate | Deactiveren | 31-12-2999 betekent geen einde |
Gerelateerd
Cezanne HR → Active Directory
Cezanne HR koppelen met Active Directory: domeinaccounts per werkgever en locatie
Cezanne HR → ADP iHCM
Cezanne HR ADP iHCM koppeling: compensatie, eenmalige betalingen en vertrek naar de Nederlandse ADP-payroll
Cezanne HR → AFAS Profit
Cezanne HR koppelen met AFAS: de Nederlandse werkgever uit Cezanne in AFAS Profit Payroll
ASCezanne HR → Arbodienst (SIVI)
Cezanne HR koppelen met de arbodienst via SIVI: absence events voor ziekte als verzuimmelding