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").

Wijziging van mei 2024 ten opzichte van de vorige versies

Release 4.5.4 & 3.26.1

Business connectoren

Bug fixes

  • eh2ebox en ehboxv3: het MIME-type van de berichttekst is niet langer beperkt tot text/plain of text/html, om het gebruik van andere MIME-types voor eH2eBox mogelijk te maken.
  • MyCareNet Registratie: verwijderen van de datum-tijdzone in de xml gegenereerd door de connector (sommige mutualiteiten accepteren geen tijdzones).

Technische connectoren

Update van het standaard configuratiebestand van de connector om de configuratiemodule ConfigurationModuleRegisterTransformers te starten, zodat de XAdES optionele-deflate transformatie beschikbaar is.

Opmerking: de minor versies van afhankelijkheden zijn ook bijgewerkt voor versie 4.5.4, in het bijzonder het verplaatsen van org.apache.commons:commons-compress naar v1.26.1, die beveiligingsproblemen oplost.

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.