The EU digital-covid-certificate Validator is an open-source Validation Service (under Apache 2 licence) provided by IHE Europe Gazelle Test Bed for verifying conformity of generated certificates to the EU specifications.
The sources are accessible here: https://gitlab.inria.fr/gazelle/applications/test-execution/validator/eu-digital-covid-certificate-validator
Bugs and issue tracking are accessible here : https://gazelle.ihe.net/jira/projects/DCC. The name of the latest release, can be obtained in the “Releases” section.
To get official artifact (binaries), search for dcc-validator-service in IHE Nexus : https://gazelle.ihe.net/nexus and select the app.dcc-validator-service.war artifact for download.
Patient registry need to be deployed on Widlfly-18. Please read first the documentation on how to install and configure this server for Gazelle applications : general considerations for WildFly 18
Be careful: Once the /etc/init.d/wildfly18 is installed, the Java option -Djsse.enableSNIExtension MUST BE set to true in order to perform DDCC Verifer Validation.
Copy the war artifact app.dcc-validator-service-X.X.X.war in the deployment folder of the wildfly installation under the name app.dcc-validator-service. This is important for the path on which DCC Validator’s web services will be exposed.
cp app.dcc-validator-service-X.X.X.war /usr/local/wildfly18/standalone/deployments/app.dcc-validator-service.war
Start wildfly. The API can be accessed at (depending on your configured host and port): http://localhost:8080/dcc-validator/dccValidationService?wsdl
DCC validator defines mandatory Operational Preferences that you will have to define in your Application server. To know how to do that, see General considerations for WildFly 18
Define a resource in your server with name java:/app/gazelle/dcc-validator/operational-preferences.
This resource should refer to a deployment.properties file. This file shall contain the following properties :
| Property Name | Description | Example value |
|---|---|---|
| svssimulator.url | URL of Simulator | http://localhost/SVSSimulator |
| truststore.path | Path of the truststore containing the trusted certificates that issues Digital covid certificates | /opt/dcc-validator/truststore.jks |
| truststore.password | Password of the truststore containing the trusted certificates that issues Digital covid certificates | password |
Install factories module
Stop wildfly and go to
sudo mkdir -p /usr/local/wildfly18/modules/system/layers/base/net/ihe/gazelle/factories/main
cd /usr/local/wildfly18/modules/system/layers/base/net/ihe/gazelle/factories/main
Download module factories.jar
sudo wget https://gazelle.ihe.net/wildfly18/factories.jar
Create module.xml file
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="net.ihe.gazelle.factories">
<resources>
<resource-root path="factories.jar"/>
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
<module name="javax.servlet.api" optional="true"/>
</dependencies>
</module>
Add jboss:jboss-admin rights
sudo chown jboss:jboss-admin *
sudo chmod 775 *
Stop Wildfly and edit standalone.xml in /usr/local/wildfly18/standalone/configuration ; add the factories binding in the naming subsystem :
Replace this property ${DEPLOYMENT_PROPERTIES} with your own path to the deployment property:
<subsystem xmlns="urn:jboss:domain:naming:2.0">
<bindings>
<object-factory name="java:/app/gazelle/dcc-validator/operational-preferences" module="net.ihe.gazelle.factories" class="net.ihe.gazelle.factories.PropertiesFactory">
<environment>
<property name="path" value="${DEPLOYMENT_PROPERTIES}"/>
</environment>
</object-factory>
</bindings>
<remote-naming/>
</subsystem>