https://github.com/thomaschampagne/traefik-sso
Docker image implementing a straightforward Single Sign-On authentication for your containers behind a Traefik v2 edge router
https://github.com/thomaschampagne/traefik-sso
authentication docker sso traefik
Last synced: 2 days ago
JSON representation
Docker image implementing a straightforward Single Sign-On authentication for your containers behind a Traefik v2 edge router
- Host: GitHub
- URL: https://github.com/thomaschampagne/traefik-sso
- Owner: thomaschampagne
- License: mit
- Created: 2020-07-19T22:40:47.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-06-05T05:08:57.000Z (about 2 years ago)
- Last Synced: 2024-04-11T15:58:05.658Z (over 1 year ago)
- Topics: authentication, docker, sso, traefik
- Language: TypeScript
- Homepage: https://hub.docker.com/r/thomaschampagne/traefik-sso
- Size: 1.43 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 62
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
README
[](https://github.com/prettier/prettier)
------------
# Traefik SSO
## What'is Traefik-sso?
It's a docker image which implements a straightforward **Single Sign-On** authentication for containers behind a [Traefik v2](https://hub.docker.com/_/traefik) edge router.
Authentication sequence to a Portainer container through Traefik v2 + Traefik-sso
## Local demo
1 - Run the below docker-compose command locally
```bash
docker-compose -f ./docker-compose.yml -f ./docker-compose.local.yml up -d
```
See [docker-compose.yml](./docker-compose.yml), [docker-compose.local.yml](./docker-compose.local.yml) & [.env](./.env) files
2 - When containers are up, open `${PWD}/data/db.json` and add the below temporary `alice` user:
```json
{
"users": [
{
"username": "alice",
"password": "$2y$10$mNJw6ojRWORz10gDaj602.8auytb58peR/hwdewqFpCershSO7DGm"
}
]
}
```
The password has been hashed using `bcrypt`, value is `4lic3`.
3 - Open http://iamfoo.domain.localhost in a browser (or http://iambar.domain.localhost).
4 - You should be redirected to http://sso.domain.localhost to logon on the domain `domain.localhost`
5 - Logon using username: `alice` and password: `4lic3`.
6 - You should be redirected to http://iamfoo.domain.localhost (or http://iambar.domain.localhost)
7 - Logout from sso using http://sso.domain.localhost/logout. This will clear jwt token cookie on domain `*.domain.localhost`
*Note: Environment variables used in demo are defined in `.env` file.*
## Environment variables
| Name | Description |
|---------------|---------------------------------------------------------------------------------------------------|
| DOMAIN | Domain to authenticate through the sso |
| SECRET | Secret used for JWT token signature. |
| TOKEN_MAX_AGE | Set JWT token life time. Must match with regex: https://regex101.com/r/Q9rYJW/2 |
| LOG_LEVEL | Log level (DEBUG, INFO, WARN or ERROR). Do not use DEBUG in production. |
## Manage users
Users can be currently managed by editing json database file `${PWD}/data/db.json` through the key `users`. A user-friendly UI is planned to perform this. The current workflow is temporary.
### Add or edit users
To add new or update existing credentials you might use the following curl command on `/hash` endpoint. This api will hash the account password using bcrypt:
```bash
curl -d '{"username":"eve", "password":"3v3"}' -H "Content-Type: application/json" -X POST https://sso.domain.localhost/hash; echo
```
Result:
```bash
{"username":"eve","password":"$2a$10$f1sHYu64iZ0zUX6vXnqj0uLE691O0bQTV.YuHw1At2PGL8CBWk/P6"}
```
You need to manually add this json output in the **db.json** database file (`users` key).
### Remove users
Just remove selected users entries in json array.
## Configure SSO login page labels and styles
You can change every text and css styles of you sso login page by editing file `${PWD}/data/config.json`.
This `config.json` file is following the [AppConfig](https://github.com/thomaschampagne/traefik-sso/blob/master/shared/models/app-config.ts) typescript structure
Here's the UML diagram of this structure:
Note: To configure properly your styles css properties (default, small & large screens) in `config.json` file, you can refer to the typescript interface [CSSStyleDeclaration](https://github.com/microsoft/TypeScript/blob/v3.9.7/lib/lib.dom.d.ts#L2757).
## Build production image
```bash
docker build -t traefik-sso:yourtag .
```
## Local development
1 - Install npm dependencies
```bash
npm install
```
2 - Build local `traefik-sso:dev` image through compose
```bash
npm run docker:dev:build
# or
docker-compose -f ./docker-compose.yml -f ./docker-compose.dev.yml build
```
3 - Run local development
```bash
npm run docker:dev:up
# or
docker-compose -f ./docker-compose.yml -f ./docker-compose.dev.yml up
```
4 - Now follow steps from [local demo](#local-demo) section, you have same environment but in development 😊.