diff --git a/Datamatrix/Makefile b/Datamatrix/Makefile new file mode 100755 index 0000000000000000000000000000000000000000..cbbc56c706e2a9d7c1b43999f7199c4c956757ea --- /dev/null +++ b/Datamatrix/Makefile @@ -0,0 +1,3 @@ +SHELL := /bin/bash + +include ../Makefile.generic diff --git a/Datamatrix/installation.md b/Datamatrix/installation.md new file mode 100755 index 0000000000000000000000000000000000000000..68b5679fe74a4d82bdd1cddebdd85bd96bc0a69f --- /dev/null +++ b/Datamatrix/installation.md @@ -0,0 +1,106 @@ +--- +title: Installation Manual +subtitle: Datamatrix +author: Nicolas BAILLIET +function: Developer +date: 2023-10-24 +toolversion: 1.X.X +version: 1.0 +status: Approved +reference: KER1-MAN-ANS-DATAMATRIX_INSTALLATION +customer: ANS +--- + +# Installation process for autethenticator-simulator + +## Sources & binaries + +Authentication Simulator is an open-source project under Apache License Version 2.0 ([https://gazelle.ihe.net/content/license](https://gazelle.ihe.net/content/license)). Sources are available via Subversion at [https://svn.ihe-europe.net/gazelle/Maven/simulators/authentication-simulator/](https://svn.ihe-europe.net/gazelle/Maven/simulators/authentication-simulator/). + +The latest public packaged release can be downloaded from our Nexus repository [https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~authentication-simulator-ear](https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~authentication-simulator-ear) (search for **authentication-simulator-X.X.X.ear**) for Authentication Simulator and [https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~idp-adapter-ear](https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~idp-adapte-ear) (search for **idp-adapte-X.X.X.ear**) for the IDP Adapter. + +If you need for any reason a more recent version (hotfix, experimental feature...), the public packaged application of our development trunk can be found at [https://gazelle.ihe.net/jenkins/job/authentication-simulator/ws/authentication-simulator-ear/target/authentication-simulator.ear](https://gazelle.ihe.net/jenkins/job/authentication-simulator/ws/authentication-simulator-ear/target/authentication-simulator.ear). This package can be unstable. The IDP Adapter ear can be found in the same directory. + +## Installation + +If you are installing a Gazelle tool for the first time in your environment, make sure to read carefully the [general considerations for JBoss7](/gazelle-documentation/General/jboss7.html) + +### Database creation + +Your database must have a user **gazelle** : + +1. Connect to your database + +```bash +psql -U gazelle +``` + +1. Execute the SQL statement to create the database. + +```sql +CREATE DATABASE "authentication-simulator" OWNER gazelle ENCODING 'UTF8' ; +``` + +### Deployment + +To deploy Authentication : + +1. Download the ear file from our Nexus repository + +1. Paste the archive **authentication-simulator.ear** in the JBoss deployment directory `${JBOSS7\_HOME}/standalone/deployments/` + +1. Display JBoss server logs, start JBoss and wait for **ear** deployment. + +1. The application can be browsed at [http://yourserver/authentication-simulator](http://yourserver/authentication-simulator) +_Port could also be different whether you have modified the JBoss server configurations or not._ + +Authentication Simulator needs an another ear to parse the shibboleth logs. This ear does not need a database, just put the ear in a jboss. This ear needs to be installed in the same machine as Shibboleth IDP but not necessarily in the same machine as Authentication Simulator. + +### Application configuration + +1. Download the SQL scripts archive from our Nexus repository [https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~authentication-simulator-ear](https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~authentication-simulator-ear) (search for **authentication-simulator-X.X.X-sql.zip**) + +1. Unzip the archive + +1. Edit the application_url value in init.sql. You might also want to edit application_works_without_cas and the idp_adapter_wsdl_endpoint configurations. + +1. From the bash, update the application configuration by running : + +```bash +psql -U gazelle authentication-simulator < init.sql +``` + +# Installation process for ch-idp-renewal + +## Sources & binaries + +`ch-idp-renewal` is an open-source project under Apache License Version 2.0 ([https://gazelle.ihe.net/content/license](https://gazelle.ihe.net/content/license)). Sources are available via Gitlab at [https://gitlab.inria.fr/gazelle/specific-tools/epr/idp-renewal/](https://gitlab.inria.fr/gazelle/specific-tools/epr/idp-renewal). + +The latest public packaged release can be downloaded from our Nexus repository [https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~ch-idp-renewal](https://gazelle.ihe.net/nexus/index.html#nexus-search;quick~ch-idp-renewal) (search for **ch-idp-renewal-X.X.X.war**) + +## Installation + +If you are installing a Gazelle tool for the first time in your environment, make sure to read carefully the [general considerations for Wildfly26](/gazelle-documentation/General/wildfly26.html) + +### Configuration + +In the saml metadata file of the SUT (by default in /opt/shibboleth-idp/metadata/), add the following AssertionConsumerService: + +```xml +<AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:PAOS" Location="https://sp-clone.ihe-europe.net/Shibboleth.sso/SAML2/ECP" index="3"/> +``` + +In the same file, in the `<SPSSODescriptor>` element, change the `AuthnRequestsSigned` to **false** instead of **true** if present. + +### Deployment + +To deploy Authentication : + +1. Download the war file from our Nexus repository + +1. Paste the archive **ch-idp-renewal-X.X.X.war** in the JBoss deployment directory `${WILDFLY26\_HOME}/standalone/deployments/` + +1. Display JBoss server logs, start JBoss and wait for **war** deployment. + +1. The application can be browsed at [http(s)://yourServer/ch-idp-renewal/ws-trust?wsdl](http(s)://yourServer/ch-idp-renewal/ws-trust?wsdl) +_Port could also be different whether you have modified the Wildfly server configurations or not._ diff --git a/Datamatrix/release-note.md b/Datamatrix/release-note.md new file mode 100755 index 0000000000000000000000000000000000000000..e4fe9b582c6314c1789ddcade9813489cafcdf39 --- /dev/null +++ b/Datamatrix/release-note.md @@ -0,0 +1,16 @@ +--- +title: Release note +subtitle: Datamatrix +toolversion: 1.0.1 +releasedate: 2023-10-24 +author: Nicolas BAILLIET +function: Developer +customer: ANS +reference: KER1-RNO-ANS-DATAMATRIX +--- +# 1.0.1 +_Release date: 2023-10-24_ + +__Task__ +* \[[DATAMATRIX-1](https://gazelle.ihe.net/jira/browse/DATAMATRIX-1)\] IHE improvement +* \[[DATAMATRIX-2](https://gazelle.ihe.net/jira/browse/DATAMATRIX-2)\] C40 encoding and broken link \ No newline at end of file diff --git a/Datamatrix/user.md b/Datamatrix/user.md new file mode 100755 index 0000000000000000000000000000000000000000..90ce4a94875ec3955b0a28617001dd7033d8c2ce --- /dev/null +++ b/Datamatrix/user.md @@ -0,0 +1,14 @@ +--- +title: User Manual +subtitle: Datamatrix +author: Nicolas BAILLIET +function: Developer +releasedate: 2023-10-24 +toolversion: 1.X.X +version: 1.02 +status: Draft +reference: KER1-MAN-IHE-AUTHENTICATION_SIMULATOR_USER +customer: eHealth Suisse +--- + +The documentation is available directly on the tool : [https://ehealthsuisse.ihe-europe.net/authentication-simulator/home.seam](https://ehealthsuisse.ihe-europe.net/authentication-simulator/home.seam)