Identity en access management
YouForce OneLogin koppeling: OneLogin-gebruikers uit Visma YouForce
Met een koppeling tussen Visma YouForce en OneLogin krijgt elke medewerker uit YouForce een OneLogin-gebruiker met afdeling, functie en leidinggevende, waarop de mappings in OneLogin rollen en apps toekennen. Pas als het laatste dienstverband in YouForce is geëindigd, zet KoppelHet de gebruiker op geschorst.
Wat de koppeling doet
Organisaties die YouForce voor HR en salaris gebruiken en OneLogin voor single sign-on, beheren de gebruikers in OneLogin vaak los van HR. De servicedesk maakt accounts aan op basis van een formulier, en omdat YouForce de leidinggevende niet bij de medewerker bewaart, staat die in OneLogin meestal leeg.
- In Visma Connect krijgt KoppelHet een applicatie met alleen de leesscope voor basisgegevens van de Youforce IAM API.
- In OneLogin maken we een API-credential om gebruikers te beheren en een eigen attribuut voor het persoonsnummer.
- KoppelHet haalt personen, dienstverbanden en rolverdelingen op en bepaalt per persoon afdeling, functie en leidinggevende.
- Nieuwe medewerkers worden OneLogin-gebruiker; wijzigingen gaan naar dezelfde gebruiker, gevonden via het persoonsnummer.
- Na de einddatum van het laatste dienstverband zet KoppelHet de status op geschorst.
Waar je op let bij Visma Raet YouForce en OneLogin
- YouForce bewaart de leidinggevende als rol op de afdeling, en OneLogin wil voor de manager een OneLogin-gebruikers-id. KoppelHet leidt per medewerker de leidinggevende af uit de rolverdeling en zoekt daarna diens OneLogin-gebruiker op via het persoonsnummer.
- Een leidinggevende die zelf in zijn eigen afdeling werkt, zou volgens de rolverdeling zijn eigen manager worden. KoppelHet neemt in dat geval de leidinggevende van de bovenliggende afdeling, zodat goedkeuringen in apps achter OneLogin niet bij de aanvrager zelf uitkomen.
- Iemand met meerdere dienstverbanden staat in YouForce met meerdere afdelingen, terwijl OneLogin één afdeling en één functie per gebruiker heeft. KoppelHet gebruikt het hoofddienstverband voor de mappings en schorst pas als het laatste dienstverband voorbij is.
- Vertrekkers met een einddatum buiten de historicalDays geeft YouForce niet meer terug. KoppelHet onthoudt welke OneLogin-gebruikers uit YouForce kwamen en blijft ze bij de nachtelijke vergelijking als geschorst behandelen, ook als YouForce ze niet meer noemt.
- Beide kanten hebben een limiet. YouForce staat 30.000 aanroepen per dag per domein en tenant toe, OneLogin 5.000 per uur per account. KoppelHet vraagt in YouForce alleen wijzigingen sinds de vorige ronde op en schrijft in OneLogin alleen gebruikers waarvan echt iets veranderde.
- Het persoonsnummer heeft in OneLogin geen standaardveld en gaat daarom in een eigen attribuut. Daarop zoekt KoppelHet een herintreder terug, zodat die zijn oude gebruiker en rollen terugkrijgt in plaats van een nieuwe gebruiker met een volgnummer.
- Met een aparte schrijfscope kan de identiteit uit OneLogin terug naar het YouForce-account, zodat medewerkers met dezelfde login in YouForce werken. Dat zit niet in de basis en kan later als uitbreiding.
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
Krijgt OneLogin BSN of privéadres te zien?
Nee. KoppelHet vraagt de scope voor privégegevens niet aan.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- YouForce via de Youforce IAM API (api.youforce.com/IAM), token van Visma Connect met client_credentials en scope Youforce-IAM:Get_Basic: GET /v1.0/persons, /v1.0/employments en rolverdelingen met from/to op latestSync, take tot 1000 en nextLink; historicalDays per abonnement. Limieten 60 per seconde, 2.500 per minuut en 30.000 per dag. Terugschrijven van de identiteit met Youforce-IAM:Update_Identity (PATCH /v1.0/users(employeeId=…)/identity).
- OneLogin API v2 (API-credential met Manage Users): POST /api/2/users en PUT /api/2/users/{id} met title, department, manager_user_id, status en custom_attributes; zoeken met custom_attributes.{naam}. Limiet 5.000 aanroepen per uur per account (X-RateLimit-Remaining).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Raet YouForce | Veld in OneLogin | Toelichting |
|---|---|---|
Persoonsnummer | custom_attributes.employeenumber | Eigen attribuut in OneLogin |
Naamgevingsregel | username | |
Zakelijk e-mailadres | email | |
Roepnaam, voorvoegsel en achternaam | firstname en lastname | |
Functie van het hoofddienstverband | title | |
Afdeling van het hoofddienstverband | department | |
Leidinggevende-rol op de afdeling | manager_user_id | |
Einddatum laatste dienstverband | status 2 (Suspended) |
Gerelateerd
ADP Workforce Now → Visma Raet YouForce
ADP Workforce Now koppelen met YouForce: aanvragen voor nieuwe Nederlandse medewerkers en contractwijzigingen
Bullhorn → Visma Raet YouForce
Bullhorn YouForce koppeling: plaatsing wordt een aanvraag voor indiensttreding
Carerix → Visma Raet YouForce
Carerix koppelen met YouForce: een geplaatste kandidaat start de indiensttreding in YouForce
Darwinbox → Visma Raet YouForce
Darwinbox YouForce koppeling: aanname en salariswijziging uit Darwinbox als aanvraag in YouForce