eidas-reference

This repository contains a fork of the eIDAS reference implementation provided by CEF digital. The original code can be obtained here.

NOTE: It's highly recommended that you use the official reference implementation and not this fork.

Licence

This code maintains its original copyright (2016 European Commission) and is licenced under the European Union Public Licence.

Getting Started

There are thorough instructions for getting set up on a range of application servers (pdf) provided by CEF digital.

If you just want to get up and running quickly we recommend you use tomcat, for which we've provided some scripts to help get you started.

Regardless, you'll need to install a version of the JDK (1.7 or higher, we recommend 1.8) with the Unlimited Strength Jurisdiction Policy Extension installed (see this blog post for instructions).

Running the tests

From the EIDAS-Parent folder run mvn test.

Running the applications locally with Tomcat

Setting up tomcat (you should only need to do this once):

# Download a tomcat .zip file from https://tomcat.apache.org/download-80.cgi

# This will create a folder with 4 tomcat instances (one for each of the stub-idp, connector-node, proxy-node and stub-sp) in ~/eidas-tomcat:
./scripts/create-tomcat.sh ~/Downloads/apache-tomcat-8.5.8.zip

Deploying and running the applications:

# This will build and deploy the applications to their tomcat folders:
./scripts/deploy-tomcat.sh

# This will start the tomcat instances:
./scripts/start-tomcat.sh

# And when you're done, stop the instances with:
./scripts/shutdown-tomcat.sh

Where to find the applications

Tomcat will run on ports 56000, 56001, 56002 and 56003, so if all is well the applications will be reachable at:

• Stub Service Provider - http://localhost:56000
• Connector Node - http://localhost:56001
• Proxy Node - http://localhost:56002
• Stub Identity Provider - http://localhost:56003

Editing the code

You can import the code into your IDE of choice by pointing it at the pom.xml in EIDAS-Parent.