eHealth platform services connectors

Alles over deze dienst

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 ICTstandaarden 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 .NETcode 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 ( wcag.label.externalLink) (met als onderwerp "eHealth platform service connectors").

Wijzigingen voor oktober 2021 ten opzichte van vorige versies

In de businessconnectoren wordt Dozer vervangen door de mapping library MapStruct. In sommige gevallen zal u hierdoor uw project moeten hercompileren.

De volgende functionaliteiten werden gewijzigd:

  • Businessconnector VSB async : kleine update van de XSD MOHM : Statussen voor advies ZKC toegevoegd aan ApplicationStatustype.
  • Businessconnector Therlink: verwijdering van het type bewijs SISREADING.
  • Businessconnector Dics v5: kleine update van de XSD (versie 5.1.4).
  • Businessconnector Intrahub V3: default gebruik van SHA1 bij het oproepen van de hubdiensten.

In de technische connectoren werden de volgende punten gewijzigd:

  • Verbeteringen
    • Toevoeging van de basisverificatie van de pincode van een eID (het aantal resterende pogingen is niet aangeduid).
    • Detectie van de aanwezigheid van een default gedeactiveerde kaart.
    • Beheer van de certificaten gebaseerd op de elliptische curves (“elliptic curve based”).
    • Default activering van TLSv1.2 voor de connector .NET.
  • Bug fix :
    • Opkuis (‘sanitizing’) van de cid-identiers van de ‘multipart’-berichten. -
    • Java-connector: Verwijdering van de cache uit de keystore om problemen met het afmelden van de eID te vermijden.

De « Release notes » bevatten meer informatie hieromtrent.

Betrokken diensten op het vlak van de "business"-lagen

Compatibiliteit van de technische connector

De compatibiliteit van de technische connector versie 4.1 met de Recip-e connectors is gevalideerd

Download

De java-connectoren en een archief-bestand met de “.net”-connectoren zijn beschikbaar via een maven repository ( repo.ehealth.fgov.be ( wcag.label.externalLink) ). De volgende lijst bevat links naar de business connectoren van de diverse beroepsgroepen en de technische connector.

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.

Versie 1.9 (13/10/2021) - 1.39 MB Bestand PDF (Dit document is in het Engels)

Omwille van de migratie naar een nieuwe technologie, hierdoor zal het niet meer mogelijk zijn om WSDL’s en XSD’s te downloaden via de UDDI. In het vervolg kan u deze informatie terugvinden op de API Portal.

Om de eHealth Service Bus (ESB) niet te overbelasten, zullen de WSDL's en XSD's vanaf 11 mei 2014 alleen via UDDI-downloads beschikbaar zijn.

De "Registry" is de catalogus van webservices die aangeboden worden door het eHealth-platform en zijn partners. De informatie is gestructureerd volgens de UDDI-standaard.
Het gaat om de volgende informatie:

  • technisch : URL, versie, WSDL en XSD
  • functioneel : link naar de beschikbare documentatie, beschrijving van de online diensten

 

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

U vindt de verschillende keystores ook bij het onderdeel ‘Keystore’ op de pagina eHealth-certificaten van de eHealth-website.
 

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

De connector vindt u op de pagina Index of maven2 van de eHealth-website.