This repo contains a simple stub Single Sign-on server for local application development. The aim is to make working with ITS web applications (e.g. Tabula) painless.
Copy conf/application.conf.example to conf/application.conf and edit the cookie attributes as appropriate.
This application ships with Docker support. To build, tag and run a local container image, perform the following steps:
$ ./buildDocker.sh
$ docker run -p 127.0.0.1:8090:8080 sso-stub
In this example the app will be available on the host on port 8090 over HTTP - i.e. http://localhost:8090
. You can also forward port 8443 if you want HTTPS.
To start the development server locally (without using Docker) on ports 8090 and 8443 (HTTP and self-signed auto TLS respectively) you can instead execute the run.sh
script:
$ ./run.sh
System requirements
Pre-requisites: working NPM and node (LTS is fine)Supported platforms: macOS, Linux
The homepage should be accessible at https://localhost:8443
.
Visit the homepage and read the instructions on configuring your app's sso-config file.