eIDAS Notification

This repository contains the eIDAS Proxy Node implementation, which consists of the following services:

• stub-connector
• proxy-node-gateway
• proxy-node-translator
• soft-hsm
• stub-idp

This stack allows a user journey from a stub EU connector, through the eIDAS Proxy Node, to a stub UK IDP, and back. The eIDAS Proxy Node will not perform matching.

Running the proxy node services

Preparing your environment (MacOS)

./Brewfile defines system dependencies for this project, notably Docker, Minikube and Kubernetes. First install homebrew, then run brew bundle to install these dependencies.

This will allow minikube to manage a virtualbox VM containing a Kubernetes cluster of the eIDAS Proxy Node services.

Startup

1. Run ./startup.sh
2. Visit http://$(minikube ip):31100/Request to start a journey from stub-connector.

Troubleshooting the minikube cluster

• use startup.sh to rebuild services which have changed, in preference to using shutdown.sh then startup.sh. The latter will rebuild all services and possibly reassign the minikube ip address.
• view logs on the VM with minikube logs
• ssh onto the VM with minikube ssh
• if minikube will not initialise the VM, run: ./shutdown.sh, and remove ~/.minikube directory.
• to use hyperkit in preference to virtualbox, first install hyperkit , then run:

  minikube stop
  minikube config set vm-driver hyperkit
  

Running unit tests

1. To run the tests manually, execute: ./gradlew clean test.
2. Test results are output to ./build/test-results.