Inhoud van deze pagina
Terug: Technische documentatie

eHealth platform services connectors RSS

Algemene informatie

Download het informatieblad

De “eHealth platform services connectors” zijn lokale (en lichte) bibliotheken met de bedoeling om de ontwikkelaars van software voor individuele zorgverleners en apotheken te helpen bij de integratie van de basisdiensten van het eHealth-platform die worden aangeboden via “web service”-interfaces. Deze bibliotheken dienen meer algemeen eveneens ter ondersteuning van de verbindingen met de diensten met toegevoegde waarde die via het eHealth-platform beschikbaar zijn of die gebruik maken van de ICT-standaarden die door het eHealth platform werden vastgesteld (zoals de "hubs" bijvoorbeeld). De ontwikkeling van deze bibliotheken kadert dus in de standaardisering en de ondersteuning bij het gebruik van de basisdiensten van het eHealth-platform.

Deze connectoren zijn opgebouwd uit twee "lagen".

  • De eerste laag of “technische connector” biedt een algemene API ter ondersteuning van het gebruik van louter technische basisdiensten (hoofdzakelijk in het domein van de beveiliging: authenticatie, vercijfering, …)
  • De tweede laag of “businessconnector” maakt gebruik van de technische connector om de verbinding met een reeks diensten voor een bepaalde doelgroep binnen éénzelfde sessie te vergemakkelijken.

De connectoren zijn uiteraard afhankelijk van de interfaces van de diensten die zij integreren. De updates van de connectoren ingevolge de wijzigingen aan deze interfaces worden in de mate van het mogelijke ter beschikking gesteld via deze webpagina..

Deze connectoren zijn beschikbaar in JAVA en .NET, maar worden uitsluitend ontwikkeld in JAVA. De .NET-code is dus geen ‘native code’. Deze connectoren worden gegenereerd aan de hand van een versie van de tool IKVM die licht werd aangepast aan onze behoeften. Als u van plan bent om vanuit dezelfde filosofie uw eigen library’s te ontwikkelen op basis van de onze, raden we u aan om diezelfde versie van de tool te gebruiken en de richtlijnen voor de integratie ervan na te leven.
De connectoren zijn bibliotheken die verdeeld worden onder vrije licentie. Ze zijn beschikbaar voor iedereen die ze wil gebruiken. Voor ondersteuning bij het gebruik van deze bibliotheken dient er op voorhand een aanvraag te worden ingediend bij het eHealth-platform via het e-mailadres info@ehealth.fgov.be (met als onderwerp "eHealth platform service connectors").

Wijzigingen april 2025 ten opzichte van de vorige versies

Release 4.7.3 & 3.28.5

Ter herinnering, de versies 4.X.X. zijn bestemd voor de JAVA-gebruikers en de versies 3.X.X.X voor de .NET-gebruikers en dit om redenen van performantie verbonden aan de gebruikte IKVM-versie.

Businessconnectoren

Toevoeging van de dienst synchrone eAgreementV2 bestemd voor de kinesitherapeuten en logopedisten. Zie voorbeeld van gebruik in de zip-archieven in de volgende folder:

  • examples\be\ehealth\businessconnector\test\businessconnector\mycarenet\agreementv2

Bug Fix voor TherLink e-ID proof: 

  • Verbetering van de bepaling van het default CMS-handtekeningalgoritme (SHA256withRSA of SHA256withECDSA) ;
  • Toevoeging van de mogelijkheid om het algoritme van de CMS-handtekening te specificeren

Technische connectoren:

Bug Fix voor Schematron : verbeteren van het genereren van de default “endpoint” voor incapacitynotification (https://raw.githubusercontent.com/ehealthplatformstandards/schematrons/prod/overview.xml).

Bug Fix voor CMS signature: verbetering van de bepaling van het default handtekeningalgoritme (SHA256withRSA of SHA256withECDSA).

Specifieke bijkomende Bug Fix met betrekking tot V4 CMS signature voor versie 4.7.3 JAVA : verbetering van de volgorde van de  “JCA security providers” om compatibel te zijn met de security provider geleverd door Commons eID voor de identiteitskaarten.

Diensten die gedekt worden op het niveau van de “business”-lagen

Compatibiliteit van de technische connector

  • De compatibiliteit van de technische connector versie 4.4.0 met de Recip-e-connectoren is gevalideerd.

Download

De java-connectoren en een archief-bestand met de “.net”-connectoren zijn beschikbaar via een maven repository. De volgende lijst bevat links naar de business connectoren van de diverse beroepsgroepen en de technische connector.

Cookbook

Connector v4: Inleidende gids

Dit is een technisch overzicht over het gebruik van de eHealth connector (versie 4). Het doel is om een ontwikkelaar van een softwareapplicatie voor eindgebruikers te begeleiden bij het gebruik, de configuratie, de uitbreiding en de integratie van zijn applicatie met de eHealth-connector.

Connector v4: Inleidende gids Versie 1.9 (13/10/21) - 1.39 MB
Dit document is in het Engels

Contact

Ons formulier wordt geladen. Als deze melding zichtbaar blijft en er geen formulier verschijnt, controleer dan of Javascript in uw browser is geactiveerd, accepteer de betreffende cookies en probeer deze pagina opnieuw te laden.

API Catalog

De portal 'API Catalog' is de catalogus van de webservices die aangeboden worden door het eHealth-platform en zijn partners via de API Gateway, die onder meer instaat voor het beheer van het gebruik van de webservices.

Het betreft:

  • technische informatie: URL, versie, formeel contract (WSDL+XSD voor de SOAP-diensten of Swagger voor de REST-diensten
  • functionele informatie: link naar de beschikbare documentatie, beschrijving van de online diensten.
Toegang tot de API Catalog

FAQ

U vindt de laatste versie van de .jks-bestanden telkens in de nieuwste connectorversie die u via de Maven-repository kunt downloaden. Raadpleeg een voorbeeld in de Index of maven2. De .jks-bestanden zitten in de map ‘config/P12’.

U vindt de verschillende keystores ook bij het onderdeel ‘Keystore’ onder eHealth-certificaten.
 

U vindt voorbeeldcodes in de generische connector van de repository. Hij bevat voorbeelden voor zowel java als net. Download de package, en bekijk de voorbeelden in het mapje ‘examples’.

De connector vindt u in de Index of maven2.
 

Vanaf oktober 2023 is de minimaal ondersteunde versie 4.1.2.
Gelieve over te schakelen naar een nieuwe versie mocht dit nog niet het geval zijn.

Voorlopig wordt alleen Java 1.8 volledig ondersteund. Recentere versies van Java zullen minstens verschillende klassen missen die in JRE 1.8 zijn opgenomen.
Het is de bedoeling dat in de toekomst ten minste Java 11 wordt ondersteund, maar de planning staat nog niet vast.

Sinds oktober 2023 is het gebruik van SHA256 verplicht. De minimaal ondersteunde connectorversie is 4.1.2.
De nodige aanpassingen zijn afhankelijk van de gebruikte connectorversie.

Versie 4.1.2 en versie 4.2.x

Volgende eigenschappen dienen aangepast/toegevoegd te worden:

Versie 4.3.x

Deze versie maakt standaard gebruik van SHA256.

Voor alle versies

Indien u gebruikmaakt van de IntraHub Services dient volgende eigenschap toegevoegd te worden: intrahubv3.sha1feature.enabled=false

Meer informatie over de werking kunt u vinden op de pagina Beveiliging van webservices van deze website.
 

De STS service Saml11TokenService wordt sinds oktober 2023 niet meer gebruikt.

U kunt volgende eigenschap toevoegen om naar de nieuwe SecurityTokenService over te schakelen: endpoint.sts=$uddi{uddi:ehealth-fgov-be:business:iamsecuritytokenservice:v1}

of afhankelijk van de omgeving:

  • endpoint.sts=https://services-acpt.ehealth.fgov.be/IAM/SecurityTokenService/v1;
  • endpoint.sts=https://services.ehealth.fgov.be/IAM/SecurityTokenService/v1.

Meer informatie over de werking kunt u vinden op de pagina’s Beveiliging van webservices en Identity & Access Management van deze website.
 

Een mogelijke oorzaak is een verouderde waarde bij de eigenschap 'endpoint.sts', bijvoorbeeld:

  • endpoint.sts=$uddi{uddi:ehealth-fgov-be:business:iamsaml11tokenservice:v1}, of
  • endpoint.sts=https://services-acpt.ehealth.fgov.be/IAM/Saml11TokenService/v1.

Zie FAQ 'Hoe pas ik de connector aan naar de nieuwe SecurityTokenService?' voor de juiste waarde.
 

U kan de headers ’User-Agent’ en ’From’ configureren a.d.h.v. volgende connectoreigenschappen:

  • be.ehealth.technicalconnector.handler.mimeheaders.user-agent.prefix=<content>
  • be.ehealth.technicalconnector.handler.mime-headers.from.value=<emergency email adress>

Om de validatie te configureren gebruikt u de volgende code:

java.lang.System.setProperty("be.ehealth.technicalconnector.handler.mimeheaders.user-agent.parts-regex","[a-zA-Z0-9-]*\\/[0-9a-zA-Z-_.]*");

Hou er rekening mee dat vanaf connector versie 4.3.x deze elementen verplicht zijn.

Meer uitleg over de verwachte waarden vindt u in de specifieke webservices cookbooks.