Identity en access management
Nedap ONS koppelen met Omada: zorgmedewerkers, teams en contracten als bron voor Omada Identity
Met een koppeling tussen Nedap ONS en Omada Identity wordt ONS de gezaghebbende bron voor identiteiten in Omada, met team, deskundigheid en een status die volgt uit de contracten in ONS. KoppelHet vangt de meldingen van ONS op, haalt de actuele gegevens erbij en zet ze klaar op een adres dat de REST-collector van Omada inleest, zonder cliëntgegevens.
Wat de koppeling doet
Organisaties die roosters en dossiers in Nedap ONS bijhouden en toegang met Omada Identity regelen, laten Omada vaak de salarisadministratie lezen, terwijl de teams en deskundigheden waar de toegang van afhangt in ONS staan.
- De zorgorganisatie vraagt de koppeling aan via het Ons API Dashboard; Nedap beoordeelt de aanvraag en geeft een certificaat uit.
- KoppelHet haalt eenmalig alle medewerkers met contracten, teams en deskundigheden op en houdt die daarna bij met de meldingen uit ONS.
- Per medewerker staat één regel klaar op een beveiligd adres van KoppelHet, met status, team, deskundigheid en type medewerker.
- De REST-collector van Omada leest dat adres als gezaghebbende bron; Omada kent rollen toe op team en deskundigheid.
- Na het laatste contract wordt de status inactief en trekt Omada de toegang in.
Waar je op let bij Nedap ONS en Omada
- Een melding uit ONS bevat alleen het soort gegeven, de gebeurtenis en een id, niet de medewerker zelf. De REST-collector van Omada kan zulke meldingen niet ontvangen. KoppelHet vangt ze op, haalt per melding het actuele record uit ONS en houdt zo de regel bij die Omada inleest.
- ONS herhaalt een mislukte melding niet zelf en bewaart haar 24 uur. KoppelHet vraagt mislukte meldingen binnen die termijn opnieuw op, en draait daarnaast een volledige vergelijking, zodat een storing van een dag geen identiteit in Omada laat achterlopen.
- Meldingen uit ONS komen niet altijd op volgorde binnen; een wijziging kan eerder aankomen dan de aanmaak. Omdat KoppelHet bij elke melding het actuele record ophaalt in plaats van de melding zelf toe te passen, maakt de volgorde voor Omada niet uit.
- Omada eist voor elke identiteit een status, maar ONS heeft geen statusveld voor medewerkers. KoppelHet leidt de status af uit de contracten - actief zolang er een lopend contract is - en vraagt jullie om de statusregel in Omada uit te zetten als security identiteiten ook zelf blokkeert, zoals Omada zelf aanraadt.
- Een medewerker kan in ONS in meerdere teams tegelijk staan, elk met eigen datums. KoppelHet levert alleen de teams die vandaag gelden, zodat een rol in Omada vervalt op de dag dat een invalperiode afloopt en niet pas bij het einde van het contract.
- Flexkrachten en zzp'ers staan in ONS als extern. Die markering gaat mee naar Omada, zodat zij een eigen identiteitstype en een kortere hercertificering kunnen krijgen dan eigen personeel.
- Het Nedap-certificaat geeft toegang tot een systeem met cliëntdossiers. Het blijft daarom op het KoppelHet platform en niet in de connectie-instellingen van Omada; Omada krijgt alleen de identiteitsgegevens, met een eigen OAuth-sleutel.
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
Moet Nedap de koppeling goedkeuren?
Ja. De zorgorganisatie vraagt haar aan via het Ons API Dashboard, en Nedap beoordeelt de aanvraag voordat er een certificaat komt.
Gaan er cliëntgegevens naar Omada?
Nee. De koppeling leest alleen medewerkers, contracten en hun toewijzingen.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Nedap ONS via de Ons API met webhooks voor employee, contract, team_assignment en expertise_profile (alleen metadata, HMAC-SHA512 in X-Signature-SHA512, 200 binnen 3 seconden, geen automatische herhaling, 24 uur bewaard, opnieuw opvragen met PUT /webhooks/redeliver) en een eerste volledige lading via /v0/xstream/api/employees/data. Toegang met een clientcertificaat dat Nedap ondertekent.
- Omada leest via de REST-collector (Content: Identity data) met OAuth2 Client Credentials; verplichte velden Business key, Unique ID, Name en Status; paginering via Link header of Paging URL; Thresholds voor nieuwe, gewijzigde en verwijderde objecten (standaard 0, uit).
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Nedap ONS | Veld in Omada | Toelichting |
|---|---|---|
identificationNo | Business key en Unique ID | Verplicht in Omada |
Naam volgens naamgebruik | Name | Verplicht in Omada |
Begin- en einddatum van de contracten | Status | Verplicht in Omada; afgeleid door KoppelHet |
TeamAssignment (team, begin, einde) | Team | Alleen toewijzingen die vandaag gelden |
ExpertiseProfileAssignment | Deskundigheid | |
type (0 Regular, 1 External) | Soort identiteit | |
birthName en birthNamePrefix | Basis voor de accountnaam | Blijft gelijk bij een huwelijk |
Gerelateerd
AFAS Profit → Nedap ONS
AFAS Nedap ONS koppeling: contracten naar de planning, uren terug naar salaris
HR2day → Nedap ONS
HR2day Nedap ONS koppeling: arbeidsrelaties, cao en contracturen automatisch in de zorgplanning
Nedap ONS → Active Directory
Nedap ONS Active Directory koppeling: accounts per zorglocatie, automatisch
Nedap ONS → Microsoft Entra ID
Nedap ONS Entra ID koppeling: Microsoft-accounts en teamgroepen voor zorgmedewerkers