The eIDAS-client project is a sample solution that communicates with Bulgarian eIDAS Node connector service.
The solution consists of two parts:
- Library - provides functions necessary for trust operations, including service provider metadata generation, connector service metadata acquisition, authentication request generation and response validation, and processing.
- Web service - microservice that provides a web interface for performing SAML specific operations. Publishing metadata of the service provider, processing metadata of the connector service and sending and receiving authentication requests from the connector service are supported.
An overview of the construction and components of the eIDAS client project can be found here.
You can find an overview of which endpoints the eIDAS client web service offers here.
Activities necessary to install and start the eIDAS client web service in brief (requires Java 8):
- Get the latest source code from git
git clone https://git.egov.bg/meu/eidas-node-bulgaria/eidas-client/5_25.07.2022.git
- Build the eIDAS-client project
./mvnw clean install
- Generate sample keys and associated configuration file (or create your own, see Configuration)
eidas-client-webapp/src/test/resources/scripts/generateTestConfiguration.sh
- Start the web service
java -jar eidas-client-webapp/target/eidas-client-webapp-1.0.0 -SNAPSHOT.war
- To verify that the application launched successfully, open the URL http://localhost:8889/metadata in the browser
In order to actually use the eidas client against the test connector service, a subscription agreement must be concluded and the metadata public key from the generated keystore must be transferred to the EGOV (in the case of the generated sample configuration /eidas-client-webapp/target/generated-test-conf/sp_metadata.crt)
You can find a longer and more detailed explanation of how to install and configure the web service in the integrator guide.