Improve documentation

This commit is contained in:
Paul 2018-04-22 19:47:26 +02:00
parent f83b9ae696
commit 83d0ed4cb7

View file

@ -13,12 +13,14 @@ linked and have no additional dependencies. Supported plattforms are:
Simply download them from the "artifacts" section of this project.
### Docker
A prebuilt docker image (10MB) is available:
```bash
```
docker pull docker.klink.asia/paul/certman
```
### From Source-Docker
You can easily build your own docker image from source
```bash
```
docker build -t docker.klink.asia/paul/certman .
```
@ -37,4 +39,12 @@ variables:
* `OAUTH2_REDIRECT_URL` the redirect URL used by the app, usually the hostname suffixed by "/login/oauth2/redirect"
* `USER_ENDPOINT` the URL to the Identity provider user endpoint, for gitlab this is "/api/v4/user". The "username" attribute of the returned JSON will used for authentication.
* `APP_KEY` random ASCII string, 32 characters in length. Used for cookie generation.
* `APP_LISTEN` port and ip to listen on, e.g. `:8000` or `127.0.0.1:3000`
* `APP_LISTEN` port and ip to listen on, e.g. `:8000` or `127.0.0.1:3000`
There are some files that need to be mounted inside the container:
* `/ca.crt` the certificate of the server PKI
* `/ca.key` the key of the server PKI, unencrypted
* `/clients.json` the generated certificates for each client
There is an [`docker-compose.yml example`](docker-compose.yml.example) you can use as a base for your own docker-compose service.