Identity en access management
Talentech Entra ID koppeling: Microsoft-accounts vanuit Talentech PeopleCore
Met een koppeling tussen Talentech PeopleCore en Microsoft Entra ID krijgt elke medewerker die HR in Talentech afrondt een Microsoft-account met functie, afdeling, locatie en leidinggevende, en wordt het account geblokkeerd na het einde van het dienstverband uit de ontslagaanvraag. Het Microsoft-adres gaat terug naar Talentech als zakelijk e-mailadres en als inlog voor Talentech ID.
Wat de koppeling doet
Organisaties die Talentech gebruiken voor HR en Microsoft 365 voor de werkplek, maken Microsoft-accounts vaak met de hand na een melding van HR. Het adres moet daarna nog in Talentech, ook omdat medewerkers met dat adres bij Talentech inloggen, en een ontslag komt pas bij IT als iemand het doorgeeft.
- Talentech geeft KoppelHet een client voor de token service, met alleen de scopes voor medewerkers, posities, contracten en ontslagaanvragen, plus schrijven op medewerkers voor het adres.
- KoppelHet leest elk uur de stand in PeopleCore en vergelijkt die met de vorige ronde.
- Een afgerond profiel met een contract krijgt een Microsoft-account, uitgeschakeld tot de startdatum.
- Het Microsoft-adres gaat terug naar Talentech als zakelijk adres en als Talentech ID-adres.
- Na het einde van het dienstverband uit de ontslagaanvraag blokkeert KoppelHet het account en zet de vertrekdatum in Entra ID.
Waar je op let bij Talentech en Microsoft Entra ID
- Talentech schrijft dat accounts in de Entra ID van een klant in principe automatisch kunnen ontstaan bij een nieuwe medewerker in PeopleCore, en verwijst voor meer informatie naar contact. Hoe die stroom werkt, staat niet in de openbare documentatie. KoppelHet bouwt hem op de PeopleCore-API, met regels die jullie zelf bepalen.
- In de app-galerie van Microsoft staat ook een Talentech-app, maar die werkt de andere kant op, van Entra ID naar Talentech. Gebruiken jullie die al, dan leggen we vast welke kant leidend is per veld, zodat Entra ID en PeopleCore elkaar niet om de beurt overschrijven.
- Elke medewerker in PeopleCore heeft een Talentech ID met een eigen e-mailadres, waarmee hij bij Talentech inlogt. Talentech kan dat adres via de API laten wijzigen. KoppelHet zet het Microsoft-adres daar terug, zodat inloggen bij Talentech met hetzelfde adres gaat als bij Microsoft.
- Een leidinggevende staat in PeopleCore als een bovenliggende positie, niet als persoon. KoppelHet zoekt de medewerker die op die positie zit en koppelt diens Microsoft-account als manager. Is de positie vacant, dan zoekt KoppelHet een niveau hoger.
- Een medewerker die in PeopleCore nog als concept staat, krijgt geen account. Pas als HR het profiel afrondt en er een contract is, maakt KoppelHet het Microsoft-account aan, zodat een kandidaat die nog afhaakt geen account achterlaat.
- Een ontslagaanvraag in PeopleCore heeft een laatste werkdag en een einddatum van het dienstverband. KoppelHet blokkeert het account na de einddatum, en kan op verzoek al op de laatste werkdag blokkeren, bijvoorbeeld bij vrijstelling van werk.
- De PeopleCore-API kan medewerkers niet opvragen op wijzigingsdatum en stuurt voor deze gegevens geen meldingen die we hebben gevonden. KoppelHet bewaart daarom de vorige stand en vergelijkt elk uur, zodat alleen echte wijzigingen naar Entra ID gaan.
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
Biedt Talentech hier zelf iets voor?
Talentech noemt HR-gestuurde provisioning naar Entra ID en vraagt daarvoor contact op te nemen. Vraag Talentech wat dat bij jullie dekt; KoppelHet bouwt de koppeling als het niet past.
Werkt dit ook met Active Directory on-premise?
Ja, die koppeling bouwen we ook, met een klein programma in jullie netwerk.
Leest de koppeling salarissen in Talentech?
Nee. De client krijgt geen scope voor salarissen of nationale nummers.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Talentech PeopleCore API (api.talentech.io/peoplecore) met een JWT uit de token service (client credentials) en scopes peoplecore-employees:read en :write, peoplecore-positions:read, peoplecore-contracts:read en peoplecore-resignations:read. GET /v1/Employees (isDrafted, talentechId, talentechIdEmail, businessContactInformation.businessEmail, manager, positionId, hasActiveResignation; filters alleen op naam, HasResigned en TalentechId), /v1/Positions (organizationInformation met jobTitle, departmentId, locationId, legalEntityId, superiorPositionId; isVacant), /v1/Contracts, /v1/EmployeeResignApplications (lastDayOfWork, employmentEndDate). Terugschrijven met PATCH /v1/Employees/{employeeId} en PUT /v1/Employees/{employeeId}/TalentechIdEmail.
- Naar Entra ID via API-driven inbound provisioning (POST /bulkUpload met SCIM, vraagt Entra ID P1 of hoger) of Microsoft Graph (user met employeeId, givenName, surname, userPrincipalName, jobTitle, department, officeLocation, companyName, manager, usageLocation, employeeHireDate, employeeLeaveDateTime en accountEnabled).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Talentech | Veld in Microsoft Entra ID | Toelichting |
|---|---|---|
Kort nummer in externalSystemIdentifiers | employeeId | Het Talentech-id is een uuid en past niet in de 16 tekens van employeeId |
employee.id (uuid) | Extensieattribuut met het Talentech-id | |
personalDetails.firstName, middleName, lastName | givenName, surname en displayName | |
Naamgevingsregel | userPrincipalName en mailNickname | |
position.organizationInformation.jobTitle | jobTitle | |
position.organizationInformation.departmentId (naam) | department | |
position.organizationInformation.locationId (naam) | officeLocation en usageLocation | |
position.organizationInformation.legalEntityId (naam) | companyName | |
superiorPositionId (medewerker op die positie) | manager | |
contract.startDate | employeeHireDate | |
resignation.employmentEndDate | employeeLeaveDateTime en accountEnabled | |
userPrincipalName (Entra ID) | businessEmail en talentechIdEmail |
Gerelateerd
Recruitee → Talentech
Recruitee Talentech koppeling: aangenomen kandidaten met contract op een positie in Talentech
Talentech → Active Directory
Talentech Active Directory koppeling: accounts in je eigen domein vanuit PeopleCore
Talentech → ADP iHCM
Talentech ADP iHCM koppeling: salarissen en ontslagaanvragen uit PeopleCore naar de Nederlandse ADP-payroll
Talentech → AFAS Profit
Talentech AFAS koppeling: medewerkers, contracten en salarissen uit Talentech PeopleCore in AFAS