Identity en access management
Deel OneLogin koppeling: werknemers, EOR en contractors uit Deel als OneLogin-gebruikers met rollen
Met een koppeling tussen Deel en OneLogin wordt iedereen die via Deel voor jullie werkt een OneLogin-gebruiker, met rollen per entiteit en soort arbeidsrelatie en met de leidinggevende, en wordt die gebruiker geschorst na de laatste werkdag. Deel stuurt zelf niets naar OneLogin; KoppelHet is de tussenlaag die Deel daarvoor voorschrijft.
Wat de koppeling doet
Organisaties die OneLogin als identity provider hebben en mensen via Deel aannemen, zoeken vaak een directory of app van Deel in OneLogin en vinden die niet. Nieuwe collega's worden dan met de hand aangemaakt, en contractors en EOR-medewerkers houden toegang tot iemand eraan denkt ze te schorsen.
- In Deel komt een organisatietoken met alleen leesrechten op mensen, contracten en organisatiestructuur.
- In OneLogin maakt de beheerder een API-credential met Manage Users en de rollen per entiteit en soort arbeidsrelatie, plus de eigen velden die KoppelHet vult.
- Bij een nieuwe persoon maakt KoppelHet de OneLogin-gebruiker aan, geschorst tot de startdatum, met rollen en leidinggevende.
- Op de startdatum zet KoppelHet de gebruiker op actief, en OneLogin geeft via de rollen toegang tot de apps.
- Na een afgeronde beëindiging schorst KoppelHet de gebruiker; verwijderen gebeurt pas na de bewaartermijn.
Waar je op let bij Deel en OneLogin
- Deel schrijft in de eigen gids dat Deel niet zelf naar identity providers provisiont en dat dezelfde aanpak met een tussenlaag ook voor OneLogin geldt. OneLogin heeft geen directory voor Deel. KoppelHet leest Deel en schrijft via de gebruikers-API van OneLogin, zodat er geen tweede identity provider tussen hoeft.
- OneLogin wil bij het aanmaken minimaal een gebruikersnaam en een e-mailadres. Bij een eigen werknemer is het werkadres in Deel optioneel. KoppelHet maakt de gebruiker pas aan als er een werkadres is, of maakt het met jullie naamgevingsregel, en meldt HR dat het ook in Deel moet.
- In OneLogin bepalen rollen welke apps iemand krijgt. Deel kent eigen werknemers, EOR-medewerkers en contractors, elk bij een entiteit. KoppelHet vertaalt de combinatie van entiteit en soort arbeidsrelatie naar role_ids, zodat een contractor in Duitsland andere apps krijgt dan een eigen werknemer in Nederland.
- Een eigen veld dat in OneLogin niet bestaat, geeft bij de API een foutmelding in plaats van te worden genegeerd. KoppelHet controleert bij de start welke eigen velden zoals soort arbeidsrelatie in OneLogin zijn aangemaakt, zodat een nieuwe persoon niet op een ontbrekend veld vastloopt.
- De webhook voor een gewijzigde eigen werknemer geeft de huidige stand zonder lijst van gewijzigde velden. KoppelHet vergelijkt met de vorige stand en stuurt een update naar OneLogin met mappings die meteen draaien, zodat een nieuwe afdeling ook direct de juiste apps oplevert.
- Deel raadt aan gebruikers in de identity provider te deactiveren en niet te verwijderen, voor de audittrail en bij herindiensttreding. KoppelHet zet een vertrekker in OneLogin op geschorst en verwijdert pas na de bewaartermijn, zodat een contractor die terugkomt zijn gebruiker met hetzelfde external_id terugkrijgt.
- Deel geeft de leidinggevende als verwijzing naar een andere persoon in Deel, OneLogin wil het OneLogin-id in manager_user_id. Omdat het Deel-id als external_id op elke gebruiker staat, vindt KoppelHet de leidinggevende met één zoekvraag, ook als die in een ander land werkt.
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
Krijgen contractors andere apps dan werknemers?
Ja, als jullie rollen dat zo regelen. KoppelHet geeft elke soort arbeidsrelatie per entiteit een eigen rol.
Gaan er salaris- of betalingsgegevens naar OneLogin?
Nee. Het token heeft geen rechten op compensatie of betalingen.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- KoppelHet leest Deel via de REST API (versie 2026-01-01; GET /rest/people met hiring_type, person_status, client_legal_entity, department, direct_manager, employments, active_worker_termination_status en direct_employee_termination_last_day) en webhooks, waaronder Employee Created Direct en Employee Updated Direct. Eigen werknemers volgens de Deel-gids als direct employee onder de eigen legal entity. Bij te veel verzoeken antwoordt Deel met 429.
- Naar OneLogin via API v2 met scope Manage Users: POST en PUT /api/2/users met username, email, external_id, title, department, company, manager_user_id, role_ids, custom_attributes en status (1 actief, 2 geschorst), met mappings=sync. Gebruikersnaam uniek per subdomein; onbekend eigen veld geeft 400; geen uitnodigingsmail via de API.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in OneLogin | Toelichting |
|---|---|---|
Deel-id van de persoon | external_id | |
first_name en last_name | firstname en lastname | |
work_email | email en username | |
job_title | title | |
department | department | |
client_legal_entity | company en role_ids | |
hiring_type | role_ids en custom attribute soort arbeidsrelatie | |
direct_manager | manager_user_id | |
person_status en beëindiging | status (1 actief, 2 geschorst) |
Gerelateerd
Ashby → Deel
Ashby Deel koppeling: aannames bij de eigen entiteit als direct employee in Deel
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel
Deel → 4PS Construct
Deel 4PS Construct koppeling: eigen werknemers van de bouwentiteit in 4PS, met afdeling en kostenplaats als dimensie