From c143c60ad1a94f48bdbe1c22624eeb0cac2252d5 Mon Sep 17 00:00:00 2001 From: Emile Date: Sun, 20 Oct 2019 17:00:17 +0200 Subject: [CI SKIP] setup information --- README.md | 59 +++++++---------------------------------------------------- 1 file changed, 7 insertions(+), 52 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index e5d7d28..fcf755c 100644 --- a/README.md +++ b/README.md @@ -1,58 +1,13 @@ -# circus-register +# circus-landingpage -Register a new companion +First page the user sees. Contains links to the registration and the scoreboard. ## Setup -First, build an image: +Set some envionment variables before you start the container! -``` -$ docker build . -t circus-register -``` +| env var | value | +| --- | --- | +| `HOSTNAME` | host circus is running on | +| `CTFNAME` | name of the ctf | -Then run the container: - -``` -$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock --net circus -p 8081:8081 circus-register:latest -``` - -## Function - -This container should only show a small registration form for the user. The user -inputs a name and recieves an access token and a link to a companion container. - -All this contains does is run this command with a few custom values: - -``` -$ docker run \ - --net circus \ - -v /var/run/docker.sock:/var/run/docker.sock \ - -v $(pwd)/companion.json:/etc/companion.json \ - -p 8086:8080 \ - -d circus-companion:latest \ - -username "Player 1" \ - -accessCode theoneandonlyplayeroneisready \ - -sessionSalt salty \ - -vpnRemoteAddress 127.0.0.1 \ - -vpnRemotePort 1193 -``` - -What this command does: - -- starts a circus companion -- inserts the companion into the circus network -- mounts the docker socket -- mounts the companion.json seeding the challenges -- exposes port 8080 to the outside world -- defines the name of the player -- defines the access-token the player can use to login -- defines a salt for the session -- defines where the remote vpn is running -- defines behind which port the vpn can be found - -That's a lot, but all we need to do is to get a name for the user, generate a -random access code, start the container and return the access code to the user. - -## Overall procedure: - -![](https://git.darknebu.la/circus/circus-register/raw/branch/master/imgs/Procedure.png) -- cgit 1.4.1