De architectuur van Joinly uitgelegd: hoe alles met elkaar samenwerkt

Marcel van Beek

6 minutes min read

1. Drie lagen in de Joinly-architectuur

Joinly is opgebouwd uit drie logische lagen die samenwerken:

  1. De bronsystemen (HR)
    HR-systemen zoals AFAS, Visma of Nmbrs leveren de gegevens van medewerkers.
    Joinly haalt deze gegevens op via een beveiligde API-connector.

  2. De Joinly Core (verwerkingslaag)
    Hier gebeurt de logica. Joinly vergelijkt HR-data met de actuele situatie in Microsoft Entra ID en bepaalt wat er moet veranderen.
    Dit deel bevat:

    • De lifecycle engine (joiners, movers, leavers)

    • De mapping engine (velden en regels vertalen tussen systemen)

    • De provisioning engine (aanmaken, updaten, deactiveren van accounts)

  3. De doelsystemen (targets)
    Dit zijn systemen waarin Joinly accounts beheert, zoals Microsoft Entra ID, Active Directory, Exchange of SaaS-apps via SCIM.


2. HR-driven provisioning als startpunt

De meeste organisaties gebruiken HR als source of truth.
Wanneer HR een wijziging registreert (bijvoorbeeld nieuwe medewerker of functiewijziging), detecteert Joinly dit en start een provisioning-flow.

Joinly bepaalt vervolgens:

  • Welke accounts moeten worden aangemaakt of aangepast

  • Welke rechten en groepen daarbij horen

  • Welke licenties moeten worden toegekend

Deze logica wordt opgeslagen in de Joinly Core en kan per organisatie worden uitgebreid met regels, goedkeuringen of uitzonderingen.


3. Delta-API voor efficiëntie

Joinly gebruikt de Delta API van Microsoft Entra ID om alleen wijzigingen op te halen.
In plaats van elke nacht alle gebruikers opnieuw in te lezen, vraagt Joinly:

“Wat is er veranderd sinds de vorige keer?”

Dit maakt het systeem snel, efficiënt en schaalbaar. ook bij duizenden gebruikers.


4. Beveiligde communicatie

Alle communicatie verloopt via beveiligde HTTPS-verbindingen met OAuth 2.0 authenticatie.
Tokens worden versleuteld opgeslagen en periodiek vernieuwd.
Geen enkel systeem krijgt meer toegang dan strikt noodzakelijk (least privilege).

Bij verbinding met on-premises omgevingen (zoals Active Directory) gebruikt Joinly:

  • Een hybride connector of Azure Function in de klantomgeving

  • Alleen uitgaande verbindingen, dus geen open poorten van buitenaf


5. Uitbreidbaar via connectors en API’s

Joinly is modulair gebouwd.
Nieuwe koppelingen worden toegevoegd als connectors:

  • HR-connectors (AFAS, Visma, Youforce, Personio, etc.)

  • Target-connectors (Microsoft Entra, AD, HubSpot, Exact, Topdesk, etc.)

Elke connector gebruikt hetzelfde onderliggende provisioning-framework, zodat uitbreidingen consistent blijven.


6. Samenvattend

De architectuur van Joinly is eenvoudig te visualiseren:

HR bepaalt wat er verandert

  • Joinly Core vertaalt en automatiseert

  • Wijzigingen worden doorgezet naar Microsoft Entra ID/AD On Premise

  • Gebruikers worden vanuit Microsoft Entra doorgezet naar Doelsystemen en Microsoft Applicaties zoals Teams, Sharepoint en Exchange me de juiste rechten


Conclusie

De kracht van Joinly zit in eenvoud: HR levert de data, Joinly verwerkt de logica, en via beveiligde API’s worden alle systemen up-to-date gehouden.
Of dat nu in de cloud is of on-premises, de architectuur blijft hetzelfde: veilig, modulair en schaalbaar.

1. Drie lagen in de Joinly-architectuur

Joinly is opgebouwd uit drie logische lagen die samenwerken:

  1. De bronsystemen (HR)
    HR-systemen zoals AFAS, Visma of Nmbrs leveren de gegevens van medewerkers.
    Joinly haalt deze gegevens op via een beveiligde API-connector.

  2. De Joinly Core (verwerkingslaag)
    Hier gebeurt de logica. Joinly vergelijkt HR-data met de actuele situatie in Microsoft Entra ID en bepaalt wat er moet veranderen.
    Dit deel bevat:

    • De lifecycle engine (joiners, movers, leavers)

    • De mapping engine (velden en regels vertalen tussen systemen)

    • De provisioning engine (aanmaken, updaten, deactiveren van accounts)

  3. De doelsystemen (targets)
    Dit zijn systemen waarin Joinly accounts beheert, zoals Microsoft Entra ID, Active Directory, Exchange of SaaS-apps via SCIM.


2. HR-driven provisioning als startpunt

De meeste organisaties gebruiken HR als source of truth.
Wanneer HR een wijziging registreert (bijvoorbeeld nieuwe medewerker of functiewijziging), detecteert Joinly dit en start een provisioning-flow.

Joinly bepaalt vervolgens:

  • Welke accounts moeten worden aangemaakt of aangepast

  • Welke rechten en groepen daarbij horen

  • Welke licenties moeten worden toegekend

Deze logica wordt opgeslagen in de Joinly Core en kan per organisatie worden uitgebreid met regels, goedkeuringen of uitzonderingen.


3. Delta-API voor efficiëntie

Joinly gebruikt de Delta API van Microsoft Entra ID om alleen wijzigingen op te halen.
In plaats van elke nacht alle gebruikers opnieuw in te lezen, vraagt Joinly:

“Wat is er veranderd sinds de vorige keer?”

Dit maakt het systeem snel, efficiënt en schaalbaar. ook bij duizenden gebruikers.


4. Beveiligde communicatie

Alle communicatie verloopt via beveiligde HTTPS-verbindingen met OAuth 2.0 authenticatie.
Tokens worden versleuteld opgeslagen en periodiek vernieuwd.
Geen enkel systeem krijgt meer toegang dan strikt noodzakelijk (least privilege).

Bij verbinding met on-premises omgevingen (zoals Active Directory) gebruikt Joinly:

  • Een hybride connector of Azure Function in de klantomgeving

  • Alleen uitgaande verbindingen, dus geen open poorten van buitenaf


5. Uitbreidbaar via connectors en API’s

Joinly is modulair gebouwd.
Nieuwe koppelingen worden toegevoegd als connectors:

  • HR-connectors (AFAS, Visma, Youforce, Personio, etc.)

  • Target-connectors (Microsoft Entra, AD, HubSpot, Exact, Topdesk, etc.)

Elke connector gebruikt hetzelfde onderliggende provisioning-framework, zodat uitbreidingen consistent blijven.


6. Samenvattend

De architectuur van Joinly is eenvoudig te visualiseren:

HR bepaalt wat er verandert

  • Joinly Core vertaalt en automatiseert

  • Wijzigingen worden doorgezet naar Microsoft Entra ID/AD On Premise

  • Gebruikers worden vanuit Microsoft Entra doorgezet naar Doelsystemen en Microsoft Applicaties zoals Teams, Sharepoint en Exchange me de juiste rechten


Conclusie

De kracht van Joinly zit in eenvoud: HR levert de data, Joinly verwerkt de logica, en via beveiligde API’s worden alle systemen up-to-date gehouden.
Of dat nu in de cloud is of on-premises, de architectuur blijft hetzelfde: veilig, modulair en schaalbaar.

Kijken kost niets

Plan een vrijblijvende demo

In 30 minuten laat we je graag zien hoe Joinly toegevoegde waarde biedt voor de gehele organisatie.

Kijken kost niets

Plan een vrijblijvende demo

In 30 minuten laat we je graag zien hoe Joinly toegevoegde waarde biedt voor de gehele organisatie.

Kijken kost niets

Plan een vrijblijvende demo

In 30 minuten laat we je graag zien hoe Joinly toegevoegde waarde biedt voor de gehele organisatie.