eHealth-connectoren (eHealth platform services connectors)

De 'eHealth platform services connectors' zijn lichte lokale bibliotheken die softwareontwikkelaars helpen bij de integratie van de basisdiensten van het eHealth-platform, vooral voor beveiliging (authenticatie, versleuteling), via een technische connectorlaag en een business-connectorlaag per doelgroep^[1]. Volgens het eHealth-platform zijn ze in de eerste plaats bedoeld voor ontwikkelaars van software voor individuele zorgverleners en apotheken^[1]; de business-connectoren worden per beroepsgroep aangeboden (o.a. Physician, Physiotherapist, Nurse, Pharmacy, Dentist, Midwife), naast de technische connector^[1]. Meer algemeen ondersteunen de bibliotheken ook verbindingen met diensten die de door het platform vastgestelde standaarden gebruiken, zoals de hubs (Hubs-metahubsysteem)^[1]. Het eHealth-platform verspreidt ze onder vrije licentie en ze zijn beschikbaar voor iedereen^[2]; ondersteuning vereist een voorafgaande aanvraag bij het platform^[1].

De technische connector biedt een algemene API voor de technische basisdiensten, vooral beveiliging (authenticatie, versleuteling)^[1], zodat niet elke leverancier die laag zelf moet bouwen (interpretatie). Volgens de V4-introductiegids (versie 1.10) wordt binnen de connector een eHealth-platformsessie aangemaakt, onderhouden en gedeeld^[3]. De STS-configuratie (endpoint.sts) zit in de connectorconfiguratie^[1]. Zie I.AM en I.AM Connect (Identity & Access Management) en eHealth-certificaten en versleuteling (ETEE); de versleuteling dient onder meer voor de eHealthBox (zie die pagina).

Status: productie, beheerd door het eHealth-platform^[1]. In de acceptatieomgeving vereist toegang tot de webservices naast een acceptatiecertificaat ook de integratie van de connector^[4].

Naast de door het eHealth-platform beheerde connectoren bevat de GitHub-organisatie smals-belgium losse open-sourcebibliotheken, zoals pseudonimiseringshelpers voor Java en .NET en webcomponenten voor doorverwijzing/voorschrift-integratie^[5]. De Smals-bibliotheek voor pseudonimisering zet een patiëntidentificatienummer om in een elliptic-curve-punt en verblindt dit vóór elke aanroep van de pseudonimiseringsdienst, zodat die dienst zelf nooit een patiëntidentificator ziet^[6][6].

• Taal: de connectoren zijn beschikbaar in Java en .NET, maar worden uitsluitend in Java ontwikkeld^[1]; de .NET-variant is geen native code maar wordt met de (aangepaste) IKVM-tool uit de Java-broncode gegenereerd^[1].
• Lagen en afhankelijkheid: volgens de V4-gids 1.10 bevat een business-connector ook de vereiste versie van de technische connector^[3]; wie een business-connector integreert, krijgt dus een bijpassende technische connector mee (afleiding).
• Versies: volgens de pagina (geraadpleegd 26/09/2026) bestaan momenteel twee versies; 5.1.x is enkel in Java beschikbaar en vereist minimaal Java 21^[1]. Wanneer die twee versies ontstonden, vermeldt de pagina niet. In mei 2026 werden wijzigingen in alle versies doorgevoerd, onder meer aan de business-connector (VSB-Net, MyCareNet Hoofdstuk IV)^[1]; zo kreeg de business-connector voor MyCareNet Hoofdstuk IV een raadplegingsdienst voor apotheken^[1].
• STS-endpoint: de oude Saml11TokenService wordt sinds oktober 2023 niet meer gebruikt^[1]. Volgens de FAQ is een mogelijke oorzaak van de fout 'SOA-03005 WSDL compliance failure' een configuratie-eigenschap endpoint.sts die nog naar die oude dienst verwijst^[1].

Sinds oktober 2023 is SHA256 verplicht en is 4.1.2 de minimaal ondersteunde connectorversie; het eHealth-platform raadt sterk aan steeds de laatste versie te gebruiken^[1]. Volgens de op 26/09/2026 geraadpleegde pagina bestaan momenteel twee versies; 5.1.x vereist minimaal Java 21 en is alleen in Java beschikbaar^[1]. Een einddatum voor de andere versie is niet gevonden.

• Doelgroep: de connectoren zijn volgens het eHealth-platform in de eerste plaats bedoeld voor software voor individuele zorgverleners en apotheken^[1], en de business-connectoren bestaan per beroepsgroep, zonder aparte ziekenhuisvariant in de lijst^[1]. Voor ziekenhuissoftware is de technische connector dus het relevantste deel (interpretatie).
• Leveranciersafhankelijk: of een EPD of middleware de connector gebruikt of zelf de protocollen implementeert, is een keuze van de leverancier; de connector is een hulpmiddel, geen verplichting (afleiding uit de beschrijving als hulpbibliotheek^[1]).
• Platformvereiste: 5.1.x vereist minimaal Java 21 en is alleen in Java beschikbaar^[1]. De connectoren worden uitsluitend in Java ontwikkeld; de .NET-variant wordt uit de Java-broncode gegenereerd^[1].
• Aanbeveling (eigen): vraag leveranciers welke connectorversie (en welke runtime) hun koppelingen gebruiken, en of ze de 5.x-lijn plannen. Controleer ook of de configuratie niet meer naar het oude STS-endpoint verwijst, een mogelijke oorzaak van de fout 'SOA-03005'^[1].

De connector werkt samen met een eHealth-certificaat^[4]. Voor REST-diensten via I.AM Connect (OIDC) is de SOAP-gerichte STS-laag niet de route^[7]; welke REST-ondersteuning de connectoren bieden, is niet gevonden (gap). Zie Technische integratie met de eHealth-infrastructuur.

• De live pagina meldde op 26/09/2026 twee versies en identificeerde 5.1.x als de uitsluitend in Java beschikbare lijn die minimaal Java 21 vereist^[1]; een eerdere cache toonde lagere versienummers. Controleer altijd de actuele releaseartefacten.
• De beschrijving van sessiebeheer en connectorlagen komt uit de V4-introductiegids 1.10^[3]; of die ongewijzigd geldt voor de 5.1.x-lijn, is niet nagegaan (gap).
• Of de bibliotheken van smals-belgium door Smals zelf officieel ondersteund worden, blijkt enkel uit de naam van de GitHub-organisatie (gap).