Identity en access management
Cezanne HR koppelen met Active Directory: domeinaccounts per werkgever en locatie
Met een koppeling tussen Cezanne HR en Active Directory krijgt een nieuwe medewerker uit Cezanne HR een domeinaccount in de OU van zijn locatie, met functie, afdeling en werkgever, en loopt het account af op het einde van het dienstverband in Cezanne. KoppelHet leest Cezanne via de OData-API en een klein programma in jullie domein voert de wijzigingen uit.
Wat de koppeling doet
Organisaties die Cezanne HR voor meerdere landen gebruiken en lokaal een Windows-domein hebben, willen alleen de medewerkers van de werkgevers die bij dat domein horen. IT maakt accounts nu op basis van een melding, en overplaatsingen naar een andere locatie of afdeling blijven vaak liggen.
- We leggen vast welke werkgevers bij het domein horen, en per locatie de OU en per organisatie-eenheid de groepen.
- KoppelHet leest personen met hun primaire dienstverband, ook mensen die nog moeten beginnen.
- Het programma in het domein maakt het account voor de startdatum, in de OU van de locatie.
- Een nieuwe locatie of organisatie-eenheid verplaatst het account op de ingangsdatum.
- Een einddatum op het dienstverband wordt de vervaldatum van het account.
Waar je op let bij Cezanne HR en Active Directory
- Elk dienstverband in Cezanne hoort via een bedrijfscode bij een werkgever. Het domein bedient vaak alleen de werkgevers in één land; KoppelHet neemt alleen personen mee van wie het primaire dienstverband bij zo'n werkgever hoort, en zet de werkgever in het attribuut company.
- Cezanne kan per persoon direct het primaire lopende dienstverband teruggeven. Heeft iemand er meer, bijvoorbeeld een detachering naast een vaste baan, dan bepaalt dat primaire dienstverband de OU en de vervaldatum.
- Locatie, functie en organisatie-eenheid zijn in Cezanne aparte toewijzingen met een eigen ingangsdatum. Het programma verplaatst een account naar de OU van de nieuwe locatie op die datum, zodat het groepsbeleid van de oude locatie tot de laatste dag blijft gelden.
- Een dienstverband zonder einde staat in Cezanne met 31 december 2999 als einddatum. KoppelHet zet dan geen vervaldatum, en pas bij een echte einddatum komt die als accountExpires op het account.
- Alle personen opvragen geeft ook vertrekkers en toekomstige instroom; het filter op actieve medewerkers niet. KoppelHet leest daarom de hele lijst, zodat een account voor de startdatum klaarstaat en een oud-collega die terugkomt zijn eerdere account terugkrijgt.
- API-toegang regelt Cezanne via de eigen Customer Success-contactpersoon, en de API volgt de rechten van de gebruiker. De koppelgebruiker ziet alleen de werkgevers van dit domein, zodat gegevens van andere landen niet langs het programma in het domein komen.
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
Moet er iets open in de firewall?
Nee. Het programma in het domein maakt alleen een uitgaande verbinding naar het platform van KoppelHet.
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. Tabellen People (filter ActiveEmployee), PeopleToEmploymentCurrentPrimary, Employments (CompanyCode, TerminationDate), JobDeployments, OrgUnitPositionDeployments en LocationDeployments. Webhooks bij People PLUS+, anders elk uur lezen.
- Een KoppelHet-agent op een Windows-server in het domein haalt opdrachten op via een uitgaande verbinding en schrijft employeeID, sAMAccountName, userPrincipalName, givenName, sn, displayName, title, department, company en accountExpires, beheert groepen en verplaatst accounts tussen OU's.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Cezanne HR | Veld in Active Directory | Toelichting |
|---|---|---|
PersonCode | employeeID | Maximaal 16 tekens |
Naamgevingsregel | sAMAccountName en userPrincipalName | sAMAccountName maximaal 20 tekens |
FirstName en FamilyName | givenName, sn en displayName | |
JobDeployments | title | |
OrgUnitPositionDeployments | department en groepen | |
LocationDeployments | OU | |
CompanyCode | company | |
TerminationDate | accountExpires | 2999-12-31 telt als leeg |
Gerelateerd
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
Cezanne HR → DATEV
Cezanne HR DATEV koppeling: de Duitse company uit Cezanne HR naar de Steuerberater