Identity en access management
Remote Entra ID koppeling: Microsoft-accounts voor medewerkers via Remote, in elk land
Met een koppeling tussen Remote en Microsoft Entra ID krijgt elke medewerker die via Remote in dienst komt een Microsoft-account met functie, afdeling, leidinggevende en het land van zijn dienstverband. Het nieuwe werkadres gaat terug naar Remote, en het account wordt pas geblokkeerd op de einddatum die Remote na de landtoets heeft bevestigd.
Wat de koppeling doet
Organisaties die via Remote mensen in dienst nemen in landen zonder eigen entiteit, maken hun Microsoft-accounts vaak aan zodra het contract getekend is. Iemand die tijdens de onboarding afhaakt houdt dan een account, Remote mailt intussen naar het privéadres, en bij vertrek blokkeert IT op een datum die Remote later nog verschuift.
- De organisatie maakt in Remote een API-token met alleen de scopes die de koppeling nodig heeft, en registreert de webhook van KoppelHet.
- Bij een nieuwe employment zet KoppelHet een uitgeschakeld account klaar met het land van het dienstverband.
- Is de onboarding bij Remote afgerond, dan schakelt KoppelHet het account in voor de startdatum en zet het werkadres in Remote.
- Wijzigingen in functie, afdeling of leidinggevende volgen via de meldingen van Remote.
- Bij een offboarding wacht KoppelHet op de bevestigde einddatum en zet die als vertrekdatum in Entra ID.
Terug: KoppelHet zet het adres van het Microsoft-account als work_email op de employment in Remote, en het Entra-nummer als eigen referentie.
Waar je op let bij Remote en Microsoft Entra ID
- Remote kan het werkadres via de API bijwerken bij een employment die is uitgenodigd of actief is, maar niet bij contractors. KoppelHet zet het adres van het Microsoft-account daarom terug bij werknemers, en zet contractors op een lijst zodat HR het adres in Remote zelf invult.
- Remote biedt medewerkers aan als SCIM-gebruikers, met afdeling, personeelsnummer en leidinggevende in de enterprise-extensie, alleen om te lezen. De HR-API van Entra ID verwacht juist SCIM. KoppelHet zet de gebruikers uit Remote daardoor met weinig vertaling door, en voegt alleen het land en de datums toe uit de employment.
- De SCIM-lijst van Remote kan alleen filteren in de vorm veld eq waarde. Een vraag naar alles wat sinds gisteren is gewijzigd kan daar niet; KoppelHet gebruikt voor wijzigingen de meldingen van Remote en de SCIM-lijst alleen voor de dagelijkse volledige vergelijking.
- Een employment doorloopt bij Remote eerst uitnodiging en onboarding. KoppelHet zet het account wel alvast klaar, maar schakelt het pas in als de onboarding is afgerond, zodat iemand die afhaakt nooit kan inloggen.
- Bij een offboarding toetst Remote eerst de regels van het land, waarna de einddatum kan verschuiven. KoppelHet zet de vertrekdatum in Entra ID pas als Remote de offboarding heeft doorgezet, zodat de blokkade niet op een voorgestelde datum valt.
- Een vertrouwelijke offboarding staat bij Remote niet in de gewone lijst. Voor accounts moet hij wel mee; KoppelHet vraagt vertrouwelijke verzoeken daarom expliciet op, gebruikt alleen de einddatum, en toont niets van de reden in Entra ID.
- Medewerkers via Remote werken in heel verschillende landen, en Microsoft wil per account een gebruikslocatie voordat er een licentie op kan. KoppelHet vult die uit het land van de employment, zodat een nieuwe collega in Portugal of Brazilië op de eerste dag een licentie heeft.
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
Komen ook onze eigen medewerkers uit AFAS of een ander HR-systeem erin?
Die lopen via een eigen bron. Per bron leggen we vast welke accounts erbij horen, zodat Remote en het andere systeem elkaar niet overschrijven.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Remote via de Remote API (gateway.remote.com) met een Customer API token met de gekozen scopes. GET /v1/employments en de SCIM-endpoints GET /v1/scim/v2/Users en /Groups (alleen lezen, filter alleen 'attribuut eq waarde'); webhooks onder meer employment.work_email.updated, ondertekend met X-Remote-Signature. Vertrouwelijke offboardings alleen met include_confidential.
- Terugschrijven met PATCH /v1/employments/{employment_id} (work_email bij invited en active, external_id bij elke status; contractors niet via de API), scope employment:write.
- Naar Entra ID via API-driven inbound provisioning (POST /bulkUpload met SCIM, maximaal 50 bewerkingen per aanroep) of Microsoft Graph (user met employeeId, usageLocation, jobTitle, department, manager, employeeType, employeeHireDate, employeeLeaveDateTime, accountEnabled).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Remote | Veld in Microsoft Entra ID | Toelichting |
|---|---|---|
employment id | employeeId | |
Naam (SCIM name.givenName, name.familyName) | givenName, surname, displayName | |
job_title | jobTitle | |
department (SCIM enterprise extension) | department | |
manager (SCIM enterprise extension) | manager | |
country van de employment | usageLocation | Nodig voor licenties |
employment_type en employment_model | employeeType | |
Bevestigde einddatum offboarding | employeeLeaveDateTime en accountEnabled | |
userPrincipalName (Entra ID) | work_email | Retour naar Remote |
Gerelateerd
Greenhouse → Remote
Greenhouse Remote koppeling: buitenlandse aannames als EOR-employment met het formulier van het land
Recruitee → Remote
Recruitee Remote koppeling: buitenlandse aannames direct als employment bij Remote
Remote → 4PS Construct
Remote 4PS Construct koppeling: eigen medewerkers van de bouwentiteit uit Remote in 4PS
Remote → Active Directory
Remote Active Directory koppeling: accounts voor collega's in andere landen