Mich-b / websec-ModernACREST

Modern access control

Set of Docker containers used during various trainings about modern access control. The focus currently is on SAML and OpenID Connect, as well as policy-based authorization.

Getting Started

Make sure to add the following items to your hosts file:

127.0.0.1	identityserver
127.0.0.1	movieswebapp
127.0.0.1	shibbolethidp
127.0.0.1	singlepageapp
127.0.0.1	productapi

Then run the following commands:

git clone https://github.com/Mich-b/websec-ModernACREST.git
cd websec-ModernACREST
docker-compose -f docker-compose.yml build
docker-compose -f docker-compose.yml up

• Movieswebapp (SAML SP - OIDC RP) runs on http://movieswebapp:8081
• Identityserver (OP) runs on http://identityserver:8080
• Shibboleth (SAML IdP) runs on http://shibbolethidp:8090
• Single page javascript app (OIDC RP) runs on http://singlepageapp:8082
• Product API (OAuth2 resource server) runs on http://productapi:8083

You typically want to go to the movieswebapp to start. However, this is limited to authentication since we do not call an external API. That's why the singlepageapp was added, which provides a nice example of how to call a REST API.

Prerequisites

What things you need to install the software and how to install them

• Docker

Remarks

All of the applications run over plain HTTP. You should be using HTTPS when using these for something other than educational purposes.

Improvements

Some of the improvements I would like to make when I find the time:

• Single log-out for the SAML-side of things (OIDC's single log-out is configured)
• Addition of other clients to show various OIDC flows

Acknowledgments

• Unicon idptestbed - Test suite for the Unicon docker images
• Sustainsys - Library which adds SAML2P support to ASP.NET web sites
• Johan Peeters' Github - Containers from a previous work-shop, given by Johan Peeters and myself
• Movieswebapp & Identityserver - Demo application used by Brock Allen and Dominick Baier during the NDC conference in London

No project in this repo is an exact copy of the sources.

Issues

Please feel free to post issues, or inform me about improvements.

Start from scratch

If things don't work out, you can try to start from a new build:

docker-compose build --no-cache
docker-compose -f docker-compose.yml up --force-recreate

If all else fails, remove all containers and start over (run this from a unix bash, on Windows you can run it from git bash) Warning: this will remove all docker containers and images, not just the ones created in this project

docker stop $(docker ps -aq)
docker rm $(docker ps -aq)
docker rmi $(docker images -q)
docker-compose build
docker-compose -f docker-compose.yml up