--- id: ehealth-connector type: Platform type_label: Plateforme ou service title: Connecteurs eHealth (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: En production; au 26 septembre 2026, il existait deux lignes de versions, dont la 5.1.x exige au minimum Java 21 et n'est disponible qu'en Java. version: Deux versions selon la page au 26/09/2026 ; 5.1.x requiert Java 21 et n'est disponible qu'en Java summary: Les connecteurs eHealth sont des bibliothèques logicielles locales avec lesquelles les développeurs intègrent des services de base de la plate-forme eHealth. Une couche technique assure entre autres l'authentification et le chiffrement; des connecteurs business ajoutent des fonctions par groupe professionnel. La plate-forme eHealth les diffuse sous licence libre, les développe en Java et génère la variante.NET avec IKVM. Pour les hôpitaux, c'est surtout le connecteur technique qui est pertinent, car les connecteurs business publiés ne contiennent pas de variante hospitalière distincte. links: - soort: website url: https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-platform-services-connectors label: eHealth-connectoren (eHealth-platform) taal: nl last_verified: '2026-10-05' relations: - type: connectsTo direction: uit target: vlaamse-sociale-bescherming target_url: https://ehealth-atlas.be/fr/protection-sociale-flamande/ status: established - type: connectsTo direction: uit target: eagreement target_url: https://ehealth-atlas.be/fr/eagreement-et-chapitre-iv/ status: established - type: connectsTo direction: uit target: hubs-metahub target_url: https://ehealth-atlas.be/fr/hubs-metahub-repertoire-des-references/ status: established - type: ownedBy direction: uit target: ehealth-platform target_url: https://ehealth-atlas.be/fr/plate-forme-ehealth/ status: established - type: dependsOn direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/fr/i-am-identity-access-management/ status: established - type: dependsOn direction: uit target: ehealth-certificaten target_url: https://ehealth-atlas.be/fr/certificats-ehealth/ status: established - type: exchangesWith direction: uit target: mycarenet target_url: https://ehealth-atlas.be/fr/mycarenet/ status: established - type: about direction: in target: bihr-connector target_url: https://ehealth-atlas.be/fr/connecteur-bihr/ status: hypothesis - type: about direction: in target: technische-integratie-ehealth target_url: https://ehealth-atlas.be/fr/integration-technique-avec-l-infrastructure-ehealth/ status: established - type: participatesIn direction: in target: smals target_url: https://ehealth-atlas.be/fr/smals/ status: established release: 2026.11.12-3 url: https://ehealth-atlas.be/fr/connecteurs-ehealth/ license: CC BY 4.0 --- # Connecteurs eHealth (eHealth platform services connectors) Les connecteurs eHealth sont des bibliothèques logicielles locales avec lesquelles les développeurs intègrent des services de base de la plate-forme eHealth.[^1] Une couche technique assure entre autres l'authentification et le chiffrement ; des connecteurs business ajoutent des fonctions par groupe professionnel.[^1][^1] La plate-forme eHealth les diffuse sous licence libre, les développe en Java et génère la variante .NET avec IKVM.[^2][^1][^1] Pour les hôpitaux, c'est surtout le connecteur technique qui est pertinent, car les connecteurs business publiés ne contiennent pas de variante hospitalière distincte.[^1][^1] ## Qu'est-ce que c'est ? Les « eHealth platform services connectors » sont des bibliothèques locales et légères qui aident les développeurs de logiciels à intégrer les services de base de la [plate-forme eHealth](https://ehealth-atlas.be/fr/plate-forme-ehealth/), surtout en matière de sécurité (authentification, chiffrement), au moyen d'une couche de connecteur technique et d'une couche de connecteurs business par public cible[^1]. Selon la plate-forme eHealth, elles visent en premier lieu les développeurs de logiciels pour prestataires de soins individuels et pharmacies[^1] ; les connecteurs business sont proposés par catégorie professionnelle (notamment Physician, Physiotherapist, Nurse, Pharmacy, Dentist, Midwife), à côté du connecteur technique[^1]. Plus généralement, les bibliothèques prennent aussi en charge les connexions avec des services qui utilisent les standards mis en place par la plate-forme, comme les hubs ([Hubs & Metahub (répertoire des références)](https://ehealth-atlas.be/fr/hubs-metahub-repertoire-des-references/))[^1]. La plate-forme eHealth les distribue sous licence libre et elles sont disponibles pour tous[^2] ; pour bénéficier d'un support, il faut avoir introduit au préalable une demande auprès de la plate-forme eHealth[^1]. ## Quels services offre-t-il ? Le connecteur technique offre une API générique pour les services de base techniques, surtout la sécurité avec l'authentification et le chiffrement.[^1] Selon le « Connector v4 : Manuel d'utilisation » (version 1.10), une session de la plate-forme eHealth est créée, maintenue et partagée au sein du connecteur[^3]. La configuration STS (endpoint.sts) se trouve dans la configuration du connecteur[^1]. Voir [I.AM et I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/fr/i-am-identity-access-management/) et [Certificats eHealth et chiffrement (ETEE)](https://ehealth-atlas.be/fr/certificats-ehealth/) ; le chiffrement sert notamment à l'[eHealthBox](https://ehealth-atlas.be/fr/ehealthbox-boite-aux-lettres-electronique-securisee/) (voir la page qui lui est consacrée). | Service | Quoi | Pour qui | Page | |---|---|---|---| | Connecteur technique | prendre en charge l'authentification, la gestion de session et le chiffrement[^1][^3] | développeurs de logiciels | [Intégration technique avec l'infrastructure eHealth](https://ehealth-atlas.be/fr/integration-technique-avec-l-infrastructure-ehealth/) | | Connecteurs business | proposer des fonctions par catégorie professionnelle[^1] | logiciels pour prestataires de soins individuels et pharmacies | [Plate-forme eHealth](https://ehealth-atlas.be/fr/plate-forme-ehealth/) | | MyCareNet Chapitre IV | proposer un service de consultation pour les pharmacies[^1] | logiciel d'officine | [MyCareNet](https://ehealth-atlas.be/fr/mycarenet/) | ### Gestion et public cible Statut : **en production**, géré par la plate-forme eHealth[^1]. Dans l'environnement d'acceptation, l'accès aux services web exige, outre un certificat d'acceptation, l'intégration du connecteur[^4]. Outre les connecteurs gérés par la plate-forme eHealth, l'organisation GitHub smals-belgium contient des bibliothèques open source distinctes, telles que des helpers de pseudonymisation pour Java et .NET et un composant web (shared-referral-prescription-webcomponent)[^5]. La bibliothèque Smals de pseudonymisation convertit un numéro d'identification de patient en un point de courbe elliptique et l'aveugle avant chaque appel au service de pseudonymisation, de sorte que ce service ne voit jamais lui-même d'identifiant de patient[^6][^6]. ### Interfaces techniques - **Langage** : les connecteurs sont disponibles en Java et .NET, mais sont uniquement développés en Java[^1] ; la variante .NET n'est pas un code natif mais est générée à partir du code source Java au moyen de l'outil IKVM (adapté)[^1]. - **Couches et dépendance** : selon le « Connector v4 : Manuel d'utilisation » 1.10, un connecteur business contient aussi la version requise du connecteur technique[^3] ; quiconque intègre un connecteur business reçoit donc un connecteur technique adapté (déduction). - **Versions** : selon la page (consultée le 26/09/2026), il existe actuellement deux versions ; la 5.1.x n'est disponible qu'en Java et nécessite au minimum Java 21[^1]. La page ne date pas l'apparition de ces lignes de versions.[^1] En mai 2026, des modifications ont été apportées à toutes les versions, notamment au connecteur business (VSB-Net, MyCareNet Chapitre IV)[^1] ; ainsi, le connecteur business pour [MyCareNet](https://ehealth-atlas.be/fr/mycarenet/) Chapitre IV a reçu un service de consultation pour les pharmacies[^1]. - **Endpoint STS** : l'ancien service STS Saml11TokenService n'est plus utilisé depuis octobre 2023[^1]. Selon la FAQ, une cause possible de l'erreur « SOA-03005 WSDL compliance failure » est une propriété de configuration endpoint.sts qui renvoie encore à cet ancien service[^1]. ## Où se trouve-t-il et qui l'utilise ? Depuis octobre 2023, SHA256 est obligatoire et la version minimale supportée du connecteur est la 4.1.2 ; la plate-forme eHealth recommande fortement de toujours utiliser la dernière version[^1]. Selon la page consultée le 26/09/2026, il existe actuellement deux versions ; la 5.1.x nécessite au minimum Java 21 et n'est disponible qu'en Java[^1]. La page ne donne pas de date de fin pour l'autre version. ## Qu'est-ce que cela signifie pour un hôpital ? - **Public cible** : selon la plate-forme eHealth, les connecteurs visent en premier lieu les logiciels pour prestataires de soins individuels et pharmacies[^1], et les connecteurs business existent par catégorie professionnelle, sans variante hospitalière distincte dans la liste[^1]. C'est pourquoi, pour les logiciels hospitaliers, c'est surtout le connecteur technique qui est pertinent.[^1][^1] - **Dépend du fournisseur** : le fait qu'un DPI ou un middleware utilise le connecteur ou implémente lui-même les protocoles est un choix du fournisseur ; le connecteur est un outil, pas une obligation (déduction à partir de la description comme bibliothèque d'aide[^1]). - **Exigence de plateforme** : la 5.1.x nécessite au minimum Java 21 et n'est disponible qu'en Java[^1]. Les connecteurs sont uniquement développés en Java ; la variante .NET est générée à partir du code source Java[^1]. - **Recommandation** (propre) : demandez aux fournisseurs quelle version du connecteur (et quel runtime) leurs connexions utilisent, et s'ils prévoient d'adopter la ligne 5.x. Vérifiez aussi que la configuration ne renvoie plus à l'ancien endpoint STS, une cause possible de l'erreur « SOA-03005 »[^1]. ### Conditions de mise en œuvre et limites Le connecteur fonctionne avec un certificat eHealth[^4]. Pour les services REST, l'authentification et l'autorisation des clients passent par I.AM Connect (OIDC)[^7] ; les sources consultées ne décrivent pas quel support REST offrent les connecteurs. Voir [Intégration technique avec l'infrastructure eHealth](https://ehealth-atlas.be/fr/integration-technique-avec-l-infrastructure-ehealth/). ## Incertitudes et informations contradictoires - La page en ligne indiquait le 26/09/2026 deux versions et identifiait la 5.1.x comme la ligne qui n'est disponible qu'en Java et nécessite au minimum Java 21.[^1] **Recommandation :** vérifiez toujours les artefacts de version actuels. - La description de la gestion de session et des couches de connecteur provient du « Connector v4 : Manuel d'utilisation » 1.10 ; la question de savoir si elle s'applique inchangée à la ligne 5.1.x n'a pas été examinée.[^3] - La question de savoir si les bibliothèques de smals-belgium sont officiellement prises en charge par Smals elle-même ne ressort pas de la source consultée.[^5] - **Note méthodologique :** « non trouvé » n'est pas une preuve d'absence. ## Relaties - se connecte à: [Protection sociale flamande (plate-forme numérique)](https://ehealth-atlas.be/fr/protection-sociale-flamande/) (établi)[^1]. De business-connector bevat een module voor VSB-Net async (wijziging mei 2026). - se connecte à: [eAgreement et chapitre IV](https://ehealth-atlas.be/fr/eagreement-et-chapitre-iv/) (établi)[^1]. De business-connector voor MyCareNet Hoofdstuk IV kreeg in mei 2026 de raadplegingsdienst voor apotheken. - se connecte à: [Hubs & Metahub (répertoire des références)](https://ehealth-atlas.be/fr/hubs-metahub-repertoire-des-references/) (établi)[^1]. De bibliotheken ondersteunen ook verbindingen met diensten die eHealth-standaarden gebruiken, zoals de hubs. - relève de: [Plate-forme eHealth](https://ehealth-atlas.be/fr/plate-forme-ehealth/) (établi)[^1][^2][^5]. Het eHealth-platform beheert de connectoren en verspreidt ze onder vrije licentie. - dépend de: [I.AM et I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/fr/i-am-identity-access-management/) (établi)[^1]. Connectoren moeten sinds oktober 2023 de SecurityTokenService-endpoint (iamsecuritytokenservice) gebruiken. - dépend de: [Certificats eHealth et chiffrement (ETEE)](https://ehealth-atlas.be/fr/certificats-ehealth/) (établi)[^4][^1]. Toegang tot de webservices vereist een eHealth-certificaat en de integratie van de connector; SHA256 verplicht sinds oktober 2023. - échange des données avec: [MyCareNet](https://ehealth-atlas.be/fr/mycarenet/) (établi)[^1]. Business-connector voor MyCareNet Hoofdstuk IV (mei 2026: raadplegingsdienst voor apotheken). - porte sur (entrant): [Connecteur BIHR (FHIR-broker)](https://ehealth-atlas.be/fr/connecteur-bihr/) (hypothèse)[^8] - participe à (entrant): [Smals](https://ehealth-atlas.be/fr/smals/) (établi)[^5][^6] - porte sur (entrant): [Intégration technique avec l'infrastructure eHealth](https://ehealth-atlas.be/fr/integration-technique-avec-l-infrastructure-ehealth/) (établi)[^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)