Identity en access management
AFAS JumpCloud koppeling: medewerkers uit AFAS Profit als gebruiker in JumpCloud
Met een koppeling tussen AFAS Profit en JumpCloud haalt de Custom API-import van JumpCloud elke medewerker uit AFAS op als gebruiker, met functie, afdeling, werkgever en een status die volgt uit de datums in en uit dienst. KoppelHet levert AFAS aan in de vorm die JumpCloud kan lezen, zodat een nieuwe collega klaarstaat en een vertrekker op tijd wordt geschorst.
Wat de koppeling doet
Organisaties die AFAS Profit als HR-systeem hebben en JumpCloud gebruiken voor accounts, SSO en apparaten, zetten nieuwe medewerkers vaak met de hand of met een CSV-bestand in JumpCloud, en schorsen vertrekkers pas als de leidinggevende eraan denkt.
- De AFAS-beheerder maakt een eigen app connector voor KoppelHet, met één GetConnector met alleen de velden voor JumpCloud.
- KoppelHet leest AFAS op wijzigingen en zet per medewerker één regel klaar op een eigen beveiligd adres.
- In JumpCloud richten we de Custom API-import in op dat adres, met de mapping en een statusregel op de datums.
- We controleren met Preview Mappings, zetten een geplande import aan en koppelen de gebruikers aan groepen met hun applicaties.
- Na de datum uit dienst schorst JumpCloud de gebruiker; KoppelHet bewaakt of elke import slaagt.
Waar je op let bij AFAS Profit en JumpCloud
- Een GetConnector van AFAS geeft zonder skip en take alleen de eerste honderd regels terug, en AFAS raadt af om alles in één keer op te vragen. De Custom API-import van JumpCloud kent voor de paginagrootte wel limit, pageSize, count en size, maar niet take. KoppelHet biedt daarom een eigen adres met paginering die JumpCloud begrijpt.
- JumpCloud kan zelf een API met een vaste header lezen, en AFAS werkt met een AfasToken in de Authorization-header. Toch geven we JumpCloud geen AFAS-token. Dat token zou bij de hele GetConnector kunnen; JumpCloud krijgt alleen een eigen sleutel voor het adres van KoppelHet.
- Werkadres en gebruikersnaam zijn verplicht in de JumpCloud-import. Bij een nieuwe medewerker is het werkadres in AFAS vaak nog leeg. KoppelHet vult dan het adres volgens jullie naamgevingsregel in, zodat de gebruiker toch wordt aangemaakt.
- Een nieuwe medewerker staat in AFAS vaak weken voor de eerste werkdag. KoppelHet levert de datum in dienst mee, en de statusregel in JumpCloud zet de gebruiker tot die dag op klaargezet. Een klaargezette gebruiker heeft volgens JumpCloud nog geen toegang tot toegewezen applicaties.
- Een gebruiker die eenmaal actief is geweest, kan in JumpCloud niet meer terug naar klaargezet. Trekt HR een indiensttreding in AFAS na de startdatum in, dan zet de regel de gebruiker op geschorst; KoppelHet meldt dat aan IT.
- In AFAS staat de werkgever bij het contract. Bij meerdere administraties levert KoppelHet de werkgever van het geldende contract als company, zodat een overstap naar een andere bv dezelfde JumpCloud-gebruiker houdt en alleen het groepslidmaatschap wijzigt.
- AFAS houdt voorvoegsel en achternaam apart. KoppelHet voegt ze samen tot de achternaam in JumpCloud, zodat apps achter JumpCloud "Jan van Dijk" tonen en niet "Jan Dijk".
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
Wordt een vertrekker verwijderd uit JumpCloud?
Nee, geschorst. Bij een schorsing vervalt volgens JumpCloud direct de toegang tot alles wat via JumpCloud loopt; verwijderen blijft een stap van IT.
Hoe vaak haalt JumpCloud de gegevens op?
Een geplande import staat standaard uit. Wij zetten hem bij livegang aan, meestal elk uur.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- AFAS wordt gelezen met een eigen GetConnector onder een eigen app connector (header Authorization: AfasToken met het token in Base64), met skip, take en een vaste sortering, gefilterd op wijzigingsdatum. Antwoord als JSON met skip, take en rows.
- JumpCloud: Custom API-import (HR Directories) met Bearer Token of API Key op het KoppelHet-adres, methode GET, Resource Location naar de lijst met gebruikers, offset-paginering met limit en offset; verplichte mapping Company email en Username; State via EXPR met manageUserState (STAGED, ACTIVATED, SUSPENDED) en datumfuncties als today() en dateAfter(); geplande import per uur, per dag of eigen schema.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in AFAS Profit | Veld in JumpCloud | Toelichting |
|---|---|---|
Medewerker (EmId) | employeeIdentifier | Sleutel tussen beide systemen |
E-mail werk | Company email en Username | Verplicht in JumpCloud |
Roepnaam en voorvoegsel + achternaam | firstname en lastname | |
Functie (omschrijving) | jobTitle | |
Organisatorische eenheid | department | |
Werkgever | company | |
Kostenplaats | costCenter | |
Datum in dienst en datum uit dienst | State via manageUserState | Klaargezet, actief of geschorst |
Gerelateerd
ADP Workforce Now → AFAS Profit
ADP Workforce Now AFAS koppeling: Nederlandse medewerkers uit het Amerikaanse HR-systeem in AFAS Profit
AFAS Profit → 4PS Construct
AFAS 4PS Construct koppeling: loonjournaal per werkgever in de juiste 4PS-administratie
AFAS Profit → Active Directory
AFAS koppelen met Active Directory: accounts automatisch bij in- en uitdienst
AFAS Profit → Adobe Creative Cloud
AFAS Adobe Creative Cloud koppeling: gebruikers en productprofielen uit AFAS Profit