Identity en access management
Sympa Omada koppeling: medewerkers en organisatie-eenheden uit Sympa als identiteiten in Omada
Met een koppeling tussen Sympa en Omada Identity leest Omada elke medewerker uit Sympa als identiteit, met entiteit, organisatie-eenheid, leidinggevende en de begin- en einddatum die vandaag gelden. KoppelHet leest de Integration API van Sympa en levert aan de REST-collector van Omada.
Wat de koppeling doet
Organisaties met Sympa als HR-systeem en Omada voor identity governance zetten medewerkers vaak met een export in Omada, en een overplaatsing die HR weken vooruit in Sympa zet, geeft te vroeg of te laat andere rechten.
- In Sympa stelt de beheerder een eigen API-interface samen met alleen de velden voor Omada, met een sleutel en secret.
- KoppelHet leest die interface elk uur en houdt per medewerker één regel bij met de stand van vandaag.
- In Omada maakt de beheerder een systeem met de REST-collector voor identiteitsgegevens, met OAuth2 Client Credentials naar KoppelHet.
- Omada leest identiteiten, contexten en eigenaren en berekent rollen per entiteit en organisatie-eenheid.
- Bij livegang zetten we een drempel op verwijderde identiteiten.
Waar je op let bij Sympa en Omada
- De Integration API van Sympa volgt een deel van OData 4, en Omada heeft een OData-collector met Basic-authenticatie, die Sympa ook ondersteunt. Sympa kent echter alleen een beperkte set queryopties, en de collector zet een lijst sinds Omada 14.0.7 alleen in een extensieattribuut. KoppelHet toetst die directe route eerst; past hij niet, dan levert KoppelHet platte regels aan de REST-collector.
- Sympa geeft met de parameter at de stand van een tabel met geldigheid op een bepaalde dag, maar at mag niet samen met since of until. KoppelHet vraagt daarom eerst op wat sinds het vorige uur veranderde, en daarna de stand van vandaag, zodat Omada een overplaatsing pas op de ingangsdatum ziet.
- Sympa beantwoordt leesverzoeken uit een rapportagedatabase die tot een half uur achter kan lopen. Een medewerker die net is ingevoerd, kan in een leesronde nog ontbreken. KoppelHet markeert een identiteit voor Omada alleen als beëindigd op een einddatum uit Sympa, nooit omdat ze in één ronde niet terugkwam.
- In een Sympa-interface kan het veld leidinggevende een doelveld van die persoon tonen, zoals zijn personeelsnummer. Omdat dat nummer ook de business key in Omada is, wijst de eigenaar van een identiteit zonder vertaling naar de juiste persoon, ook als de leidinggevende bij een andere entiteit werkt.
- Sympa staat standaard honderd verzoeken per uur per interface toe, voor alle verzoeken samen, en mislukte aanmeldingen staan niet in het activiteitenlog van Sympa. KoppelHet gebruikt een eigen interface voor Omada, leest in een paar grote pagina's en bewaakt zelf of het lezen lukt.
- Met de optie errordata geeft Sympa een overzicht van fouten in de gegevens bij een leesverzoek. KoppelHet zet dat overzicht per medewerker in een melding voor HR, zodat een ontbrekende organisatie-eenheid in Sympa wordt opgelost voordat Omada een identiteit zonder context krijgt.
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
Kan Omada Sympa niet rechtstreeks via OData lezen?
Mogelijk wel, voor eenvoudige gevallen. We toetsen dat eerst. Voor de stand op de ingangsdatum, de leidinggevende en een veilige vertrekregel is KoppelHet ertussen meestal nodig.
Ziet Omada salarisgegevens uit Sympa?
Nee. De interface in Sympa bevat alleen de velden voor Omada.
Hoe snel staat een vertrek in Omada?
KoppelHet heeft het binnen het uur, Omada ziet het bij de volgende import.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- KoppelHet leest Sympa via de Sympa Integration API (deel van OData v4) op een eigen interface op api.sympahr.net met Basic-authenticatie (sleutel en secret) of X-ApiKey: $filter op modified, $top, $skip, $count, since en until, at voor de geldige stand (niet samen met since of until, anders 400), errordata=true en een doelveld op de leidinggevende. Standaard 100 verzoeken per uur per interface; GET uit de rapportagedatabase (meestal binnen een minuut, tot 30 minuten).
- Omada leest via de REST-collector (Content: Identity data) met OAuth2 Client Credentials: identiteiten met Business key, Unique ID, Name en Status, contexten met Business key, Name en Type, context assignments en identity owners. Alternatief te toetsen: de OData-collector met Basic-authenticatie, eigen headers en $select of $expand; lijsten sinds v14.0.7 alleen naar extensieattributen.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Sympa | Veld in Omada | Toelichting |
|---|---|---|
Personeelsnummer (uniek veld van de interface) | Business key en Unique ID | |
Roepnaam en achternaam | Name | |
Begin- en einddatum dienstverband (at=vandaag) | Status en geldigheid | |
Entiteit | Context (type entiteit) | |
Organisatie-eenheid | Context (type organisatie-eenheid) | |
Leidinggevende (doelveld personeelsnummer) | Owner UID | |
Functie | Extensieattribuut functie |
Gerelateerd
Greenhouse → Sympa
Greenhouse Sympa koppeling: aangenomen kandidaat als datakaart met contractregel in Sympa
Recruitee → Sympa
Recruitee Sympa koppeling: aangenomen kandidaten als datakaart in Sympa
SmartRecruiters → Sympa
SmartRecruiters Sympa koppeling: klaar voor onboarding wordt een datakaart in Sympa
Sympa → 4PS Construct
Sympa 4PS Construct koppeling: monteurs van de Nederlandse werkgever uit Sympa in 4PS, met kostenplaats als dimensie