eHealth platform services connectors

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:

• default.rsa.digest.method.algorithm;
• default.rsa.signature.method.algorithm;
• service.sts.class. = be.ehealth.technicalconnector.service.sts.impl.STSServiceWsTrustImpl

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.