simpleauth/README.md

47 lines
1.3 KiB
Markdown
Raw Normal View History

2021-12-05 17:18:57 -07:00
# Simple Auth
2021-08-15 11:03:25 -06:00
All this does is present a login page.
Upon successful login, the browser gets a cookie,
2021-08-15 11:12:07 -06:00
and further attempts to access will get the success page.
I made this to use with the Traefik forward-auth middleware.
2021-12-05 17:18:57 -07:00
All I need is a simple password, that's easy to fill with a password manager.
2021-08-15 11:12:07 -06:00
This checks those boxes.
2021-12-05 17:18:57 -07:00
## Installation with Traefik
I only use docker swarm. You'd do something like the following:
```yaml
services:
my-cool-service:
# All your cool stuff here
deploy:
labels:
# Keep all your existing traefik stuff
traefik.http.routers.dashboard.middlewares: forward-auth
traefik.http.middlewares.forward-auth.forwardauth.address: http://simpleauth:8080/
simpleauth:
image: ghcr.io/nealey/simpleauth
secrets:
- password
deploy:
labels:
traefik.enable: "true"
traefik.http.routers.simpleauth.rules: "PathPrefix(`/`)"
traefik.http.services.simpleauth.loadbalancer.server.port: "8080"
secrets:
password:
file: password
name: password-v1
```
## Note
For some reason that I haven't bothered looking into,
I have to first load `/` in the browser.
I think it has something to do with cookies going through traefik simpleauth,
and I could probably fix it with some JavaScript,
but this is good enough for me.