
Identity en access management
Lucca Active Directory koppeling: accounts in je eigen domein op basis van Lucca
Met een koppeling tussen Lucca en Active Directory krijgt een nieuwe medewerker uit Lucca een account in jullie eigen domein, in de map van zijn vestiging en met functie, afdeling en leidinggevende. Zodra het dienstverband in Lucca afloopt, wordt het account uitgeschakeld en vervalt het op de einddatum.
Wat de koppeling doet
Organisaties met Lucca als HR-systeem en een eigen Active Directory, vaak met Entra Connect naar Microsoft 365, laten de servicedesk accounts aanmaken op basis van een formulier of mail. Een vestiging in Frankrijk en een in Nederland krijgen dan elk hun eigen gewoontes, en vertrekkers blijven staan tot iemand ze ziet.
- In Lucca maakt de beheerder een OAuth-client voor KoppelHet; in het domein komt een KoppelHet-agent met rechten op alleen de mappen van de koppeling.
- Lucca meldt nieuwe medewerkers en wijzigingen aan het KoppelHet-platform; de agent haalt de opdrachten daar op via een uitgaande verbinding.
- Een medewerker met status upcoming krijgt een uitgeschakeld account in de map van zijn vestiging, dat op de startdatum aangaat.
- Het e-mailadres uit het domein gaat terug naar Lucca.
- Bij het einde van het dienstverband schakelt de agent het account uit en verplaatst het naar een map voor vertrekkers.
Waar je op let bij Lucca en Active Directory
- Lucca kan geen verbinding maken met een server in jullie netwerk. Meldingen van Lucca komen daarom binnen op het KoppelHet-platform, en de agent in het domein haalt ze daar op. Er hoeft geen poort naar binnen open.
- Een gebruikersnaam in Active Directory mag hooguit 20 tekens hebben en geen tekens als / of [. Lucca wordt veel gebruikt voor Franse collega's met namen als Benoît of Anaïs. KoppelHet zet accenten om voor de gebruikersnaam en laat de weergavenaam zoals Lucca hem heeft.
- Lucca geeft elke medewerker de status upcoming, active of deactivated, berekend uit zijn dienstverbanden. KoppelHet maakt bij upcoming het account al uitgeschakeld aan, schakelt het in bij active en uit bij deactivated, zodat IT nooit zelf data hoeft te vergelijken.
- Een dienstverband in Lucca heeft een einddatum, en dienstverbanden van één medewerker overlappen nooit. KoppelHet zet die einddatum als vervaldatum op het account. Dan weigert Active Directory zelf de aanmelding na die dag, ook als de agent op dat moment niet bereikbaar is.
- De vestiging hangt in Lucca aan de functie, niet aan de medewerker. Een overplaatsing naar een andere vestiging is een nieuwe functie met een eigen begindatum. KoppelHet verplaatst het account naar de map van de nieuwe vestiging op die datum, zodat groepsbeleid per locatie op tijd wisselt.
- Lucca bewaart meldingen twee maanden, ook als ze niet zijn afgeleverd. Na een storing van de agent of het netwerk haalt KoppelHet gemiste meldingen alsnog op, en de nachtelijke vergelijking vangt de rest op.
- Lucca heeft per medewerker een uniek veld voor een nummer in een ander systeem. KoppelHet zet daar de objectGUID of het accountnummer uit Active Directory in, zodat HR in Lucca kan zien aan welk account een medewerker hangt.
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 een poort open in onze firewall?
Nee. De agent maakt alleen een uitgaande verbinding naar het KoppelHet-platform.
Werkt dit ook als we alleen Entra ID hebben?
Ja, dan schrijft KoppelHet rechtstreeks naar Entra ID zonder agent.
Welke rechten heeft de agent in ons domein?
Alleen op de mappen van de koppeling: accounts maken, wijzigen en uitschakelen. Geen domeinbeheerder.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Lucca API (v5, header Api-Version 2024-11-01) met OAuth 2.0: employees (status, email, remoteId uniek tot 100 tekens), employments (start.date, end.date, legalEntity), job-positions (jobTitle, department, businessEstablishment, manager). Webhooks employee.* en employment.*; events twee maanden bewaard. Limiet 50 verzoeken per minuut per tenant.
- Een KoppelHet-agent in het domein haalt opdrachten op via een uitgaande verbinding en heeft alleen rechten op de OU's van de koppeling. AD-attributen employeeID, sAMAccountName (maximaal 20 tekens), userPrincipalName, mail, title, department, physicalDeliveryOfficeName, company, manager, accountExpires en userAccountControl. Entra Connect neemt het account daarna mee naar Entra ID.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Lucca | Veld in Active Directory | Toelichting |
|---|---|---|
employee.id | employeeID | |
givenName | givenName | |
familyName | sn | |
Naamgevingsregel zonder accenten | sAMAccountName | Maximaal 20 tekens |
Naamgevingsregel | userPrincipalName en mail | |
applicableJobPosition.jobTitle | title | |
applicableJobPosition.department | department | |
applicableJobPosition.businessEstablishment | physicalDeliveryOfficeName en OU | |
applicableJobPosition.manager | manager | |
employment.legalEntity | company | |
employment.end.date | accountExpires en userAccountControl |
Gerelateerd
Lucca → ADP iHCM
Lucca ADP iHCM koppeling: vaste en variabele beloning uit Lucca Compensation naar de Nederlandse ADP-payroll
Lucca → AFAS Profit
Lucca AFAS koppeling: medewerkers en beloning van de Nederlandse entiteit uit Lucca in AFAS
Lucca → Arbodienst (SIVI)
Lucca koppelen met de arbodienst via SIVI: bevestigde ziekte per halve dag als verzuimmelding
Lucca → DATEV
Lucca DATEV koppeling: Duitse in- en uitdiensttreding en stamgegevens uit Lucca naar DATEV