Demo application is provided to study the flows and integration of Signature Gateway. NB! This is not meant to be used in production!
Functionality:
- Authorization
- Container conversion to and from HASHCODE form
- Mobile-ID signing
- ID card signing (with Web eID in front end)
- Smart-ID signing
- Signature validation
SiGa demo application is not a standalone system, it requires either the SiGa application to already be running on your machine or pointing the demo app towards sample APIs.
Preconditions:
- Java JDK 17 - to compile and run SiVa demo
- SiVa parent project - Can be found here
- Docker must be installed and running.
- Build SiGa demo application docker image:
./mvnw clean spring-boot:build-image
- Then, follow the "Running SiGa with Docker" instructions at SiGa webapp to run both apps at the same time.
If everything was successful, open up the browser at https://siga-demo.localhost:9443/.
- Open up the application.properties file and change the following properties accordingly:
siga.api.uri=https://siga.localhost:8443/siga
siga.api.trust-store=file:/path/to/siga_server_truststore.p12
siga.api.trust-store-password=changeit
siga.api.trust-store-type=PKCS12
siga.client.hmac.algorithm=HmacSHA256
siga.client.hmac.service-uuid=a7fd7728-a3ea-4975-bfab-f240a67e894f
siga.client.hmac.shared-signing-key=746573745365637265744b6579303031
| Parameter | Description | Example |
|---|---|---|
| siga.api.uri | SIGA server URL (without slash symbol in the end) | https://siga.localhost:8443/siga |
| siga.api.trust-store | Location of the trustore containing server's certificate or CA (path without quotes symbol) | classpath:siga_server_truststore.p12 or file:/path/to/siga_server_truststore.p12 |
| siga.api.trust-store-password | Password of the trustore containing server's certificate or CA. | changeit |
| siga.api.trust-store-type | Type of the trustore containing server's certificate or CA. Defaults to system default if not provided. | PKCS12 |
- Build this project
./mvnw clean install- Run compiled JAR (found in target folder)
java -jar siga-demo-application-X.X.X.jarNow application is accessible at https://siga-demo.localhost:9443/.
Example application.properties file can be seen here.
Common Spring Boot properties are
described here.
| Parameter | Mandatory | Description | Example |
|---|---|---|---|
| spring.servlet.multipart.max-file-size | N | Max file size. | 20MB |
| spring.servlet.multipart.max-request-size | N | Max request size. | 35MB |
Before every signing the webapage needs to be reloaded and files uploaded.
With Docker setup, Signature Gateway is in TEST mode. Meaning it is possible to sign only with TEST ID-card, TEST Mobile-ID or TEST Smart-ID.