README.md

# docker-shib-test
A Shibboleth SAML test environment for Docker containers

_(Based on https://github.internet2.edu/docker/shib-idp/tree/master/test-compose)_

This repository contains a docker-compose configuration to create a SAML test
environment with the following containers:

  * LDAP server
  * SAML identity provider (Shibboleth IdP)
  * SAML-authenticating reverse proxy (Shibboleth SP)
  * Simple web application
  * Acceptance test runner


## Quick Start

To start all required containers and run automated tests:

```
docker-compose up test
```

To stop all containers:

```
docker-compose down
```


## Interacting with the Environment

### Prerequisites

To interact with the test environment, you'll need to update your /etc/hosts
file to include "idp.example.edu" and "sptest.example.edu" aliases for
localhost:

```
# /etc/hosts
127.0.0.1       localhost idp.example.edu sptest.example.edu
```

### Logging in to the Test Application

To start the proxy and its dependencies:

```
docker-compose up proxy
```

To login, visit https://sptest.example.edu:8443 in a web browser. Log in with
username "banderson", password "password". If login succeeds, you'll see
phpinfo() output with HTTP headers X-Forwarded-User and X-Forwarded-Groups
populated.

Press Ctrl-C to stop the containers and return to the command line.


To stop and remove all containers:

```
docker-compose down
```


## FAQ

### Replacing keys and certificates

### Running on cloud providers

### CloudFormation template

### Terraform configuration

### Replacing test components