--- id: ehealth-connector type: Platform type_label: Platform of dienst title: eHealth-connectoren (eHealth platform services connectors) aliases: - eHealth-connector - eHealth platform services connectors - technische connector - business-connector - ehealth-services-connectors names: nl: eHealth-connectoren fr: Connecteurs eHealth en: eHealth platform services connectors jurisdiction: - belgie themes: - architectuur-en-infrastructuur - identiteit-en-toegang lifecycle: productie lifecycle_note: 'In productie. Volgens de op 26/09/2026 geraadpleegde pagina bestaan twee versies; 5.1.x vereist Java 21 en is alleen in Java beschikbaar. De pagina dateert het ontstaan van de twee versies niet. Minimaal ondersteunde connectorversie: 4.1.2 sinds oktober 2023.' version: Twee versies volgens de pagina op 26/09/2026; 5.1.x vereist Java 21 en is alleen in Java beschikbaar summary: 'De eHealth-connectoren zijn onder vrije licentie verspreide lokale bibliotheken van het eHealth-platform die in de eerste plaats ontwikkelaars van software voor individuele zorgverleners en apotheken helpen de basisdiensten te integreren: een technische laag (authenticatie via STS, versleuteling) en business-connectoren per beroepsgroep. Ze worden in Java ontwikkeld; de.NET-variant wordt met IKVM gegenereerd. Daarnaast staan op GitHub (organisatie smals-belgium) losse open-sourcebibliotheken (pseudonimisering, webcomponenten).' last_verified: '2026-09-28' relations: - type: connectsTo direction: uit target: hubs-metahub target_url: https://ehealth-atlas.be/hubs-metahub/ status: established - type: connectsTo direction: uit target: uhmep target_url: https://ehealth-atlas.be/uhmep/ status: hypothesis - type: ownedBy direction: uit target: ehealth-platform target_url: https://ehealth-atlas.be/ehealth-platform/ status: established - type: dependsOn direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/i-am-connect/ status: established - type: dependsOn direction: uit target: ehealth-certificaten target_url: https://ehealth-atlas.be/ehealth-certificaten/ status: established - type: exchangesWith direction: uit target: mycarenet target_url: https://ehealth-atlas.be/mycarenet/ status: established - type: about direction: in target: bihr-connector target_url: https://ehealth-atlas.be/bihr-connector/ status: hypothesis - type: about direction: in target: integratie-engine target_url: https://ehealth-atlas.be/integratie-engine/ status: hypothesis - type: about direction: in target: technische-integratie-ehealth target_url: https://ehealth-atlas.be/technische-integratie-ehealth/ status: established release: 2026.10.05-1 url: https://ehealth-atlas.be/ehealth-connector/ license: CC BY 4.0 --- # eHealth-connectoren (eHealth platform services connectors) De eHealth-connectoren zijn onder vrije licentie verspreide lokale bibliotheken van het eHealth-platform die in de eerste plaats ontwikkelaars van software voor individuele zorgverleners en apotheken helpen de basisdiensten te integreren: een technische laag (authenticatie via STS, versleuteling) en business-connectoren per beroepsgroep. Ze worden in Java ontwikkeld; de .NET-variant wordt met IKVM gegenereerd. Daarnaast staan op GitHub (organisatie smals-belgium) losse open-sourcebibliotheken (pseudonimisering, webcomponenten). ## Wat is het? De 'eHealth platform services connectors' zijn lichte lokale bibliotheken die softwareontwikkelaars helpen bij de integratie van de basisdiensten van het [eHealth-platform](https://ehealth-atlas.be/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](https://ehealth-atlas.be/hubs-metahub/))[^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]. ## Welk probleem lost het op? 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)](https://ehealth-atlas.be/i-am-connect/) en [eHealth-certificaten en versleuteling (ETEE)](https://ehealth-atlas.be/ehealth-certificaten/); de versleuteling dient onder meer voor de [eHealthBox](https://ehealth-atlas.be/ehealthbox/) (zie die pagina). ## Wie beheert het en waar wordt het toegepast? 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]. ## Gegevens en koppelvlakken - **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](https://ehealth-atlas.be/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]. ## Versie, status en roadmap 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. ## Praktische betekenis voor ziekenhuizen - **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]. ## Implementatievoorwaarden en beperkingen 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](https://ehealth-atlas.be/technische-integratie-ehealth/). ## Onzekerheden en tegenstrijdige informatie - 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). ## Relaties - koppelt met: [Hubs-metahubsysteem](https://ehealth-atlas.be/hubs-metahub/) (vastgesteld)[^1]. De bibliotheken ondersteunen ook verbindingen met diensten die eHealth-standaarden gebruiken, zoals de hubs. - koppelt met: [UHMEP en het digitaal verwijsvoorschrift (eReferral)](https://ehealth-atlas.be/uhmep/) (hypothese)[^5]. De GitHub-organisatie smals-belgium bevat webcomponenten voor doorverwijzing/voorschrift-integratie; geen officiële business-connector voor UHMEP gevonden. - valt onder verantwoordelijkheid van: [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/) (vastgesteld)[^1][^2][^5]. Het eHealth-platform beheert de connectoren en verspreidt ze onder vrije licentie. - hangt technisch af van: [I.AM en I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/i-am-connect/) (vastgesteld)[^1]. Connectoren moeten sinds oktober 2023 de SecurityTokenService-endpoint (iamsecuritytokenservice) gebruiken. - hangt technisch af van: [eHealth-certificaten en versleuteling (ETEE)](https://ehealth-atlas.be/ehealth-certificaten/) (vastgesteld)[^4][^1]. Toegang tot de webservices vereist een eHealth-certificaat en de integratie van de connector; SHA256 verplicht sinds oktober 2023. - wisselt gegevens uit met: [MyCareNet](https://ehealth-atlas.be/mycarenet/) (vastgesteld)[^1]. Business-connector voor MyCareNet Hoofdstuk IV (mei 2026: raadplegingsdienst voor apotheken). - gaat over (inkomend): [BIHR-connector (FHIR-broker)](https://ehealth-atlas.be/bihr-connector/) (hypothese)[^8] - gaat over (inkomend): [Integratie-engine (interface engine)](https://ehealth-atlas.be/integratie-engine/) (hypothese) - gaat over (inkomend): [Technische integratie met de eHealth-infrastructuur](https://ehealth-atlas.be/technische-integratie-ehealth/) (vastgesteld)[^1] ## Open vragen - Welke business-connectoren dekken welke versies van MyCareNet, Recip-e, hubs en UHMEP? - Hoe integreren ziekenhuissoftware en middleware de basisdiensten, aangezien de business-connectoren per beroepsgroep bestaan en geen ziekenhuisvariant hebben? - Worden de bibliotheken van de GitHub-organisatie smals-belgium actief onderhouden en officieel aanbevolen als alternatief voor de connectoren? - Versieverschil: de live pagina noemt 5.1.x en 4.9.5; een gecachte versie toonde 5.0.2 en 4.8.4. Controleer de releaseartefacten. ## Bronnen [^1]: [eHealth platform services connectors | eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-platform-services-connectors). eHealth-platform. Opgehaald 2026-09-26, sha256 7e296c8a3bb3c976… (SRC-ef6afc402c) [^2]: [eHealth platform services connectors](https://ehealth.fgov.be/ehealthplatform/fr/service-ehealth-platform-services-connectors). eHealth-platform. Opgehaald 2026-09-26, sha256 7b4f0f6eef088501… (SRC-0e0e2a1c1a) [^3]: [eHealth-platform Services Connectors V4 - Guide](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/8f40846c5d1c18ead66a323e5c51200ee84df14d/eh-connectors-v4-introduction-guide-1-10.pdf). eHealth-platform. Opgehaald 2026-09-26, sha256 1a13c9d128e72085… (SRC-976200c0b6) [^4]: [Richtlijn betreffende de vernieuwing van de publieke sleutel van een certificaat. | eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/nl/de-acceptatieomgeving-van-het-ehealth-platform). eHealth-platform. Opgehaald 2026-09-26, sha256 d507a85f590e7840… (SRC-5e41adfb50) [^5]: [Smals-Belgium · GitHub](https://github.com/smals-belgium). Smals. Opgehaald 2026-09-26, sha256 1af5de10f1822f05… (SRC-378a28a0fc) [^6]: [GitHub - smals-belgium/shared-pseudo-helper-java: Library that helps eHealth Pseudonymisation integration in Java applications · GitHub](https://github.com/smals-belgium/shared-pseudo-helper-java). Smals. Opgehaald 2026-09-26, sha256 00186947ff0cb7bb… (SRC-62e7d58b4b) [^7]: [I.AM (Identity & Access Management) | eHealth-platform](https://www.ehealth.fgov.be/ehealthplatform/nl/service-i.am-identity-access-management). eHealth-platform. Opgehaald 2026-09-26, sha256 7bd6ead93abd8dbd… (SRC-81723a4a0f) [^8]: [BIHR zet in op co-creatie, toegankelijkheid en hergebruik van gegevens - Amaron](https://amaron.be/bihr-zet-in-op-co-creatie-toegankelijkheid-en-hergebruik-van-gegevens/). Amaron, 2026-09-23. Opgehaald 2026-10-01, sha256 fa3a143265e7a1ab… (SRC-66386423aa)