nemunaire/fic-admin repository overview

⁠Quick reference

• Maintained by: SRS FIC team⁠
• Where to get help: on our Matrix channel⁠

⁠Supported tags and respective Dockerfile links

• latest⁠

⁠Quick reference (cont.)

• Where to file issues: https://git.nemunai.re/fic/server/issues⁠
• Supported architectures: (more info⁠) amd64, arm/v7 and arm64.

⁠What is the FIC platform?

FIC⁠ is an event organized by CEIS about cybersecurity and cybercriminality. During this event, we organize a forensic CTF. This image is part of the platform used to manage the CTF.

This image fic-admin is the administrative part of the platform. It perform team and exercices management, it can synchronize scenarios, handle issues, publish events and manage challenge global settings.

⁠How to use this image

This image requires a mysql-like database. It should work with mariadb or mysql:

docker run -d --name fic-db -e MARIADB_USER=fic -e MARIADB_PASSWORD=fic -e MARIADB_DATABASE=fic -e MARIADB_RANDOM_ROOT_PASSWORD=true mariadb

If you plan to deploy the entire stack, you should also create a network:

docker network create fic-net
docker network connect fic-net fic-db

To run this image:

docker run --network fic-net -p 8081:8081 -e MYSQL_HOST=fic-db nemunaire/fic-admin

The admin platform can be then reached at http://localhost:8081/⁠.

⁠Environment Variables

⁠MYSQL_HOST

Hostname where the database can be reached.

⁠MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD

Thoses variables are used to alter the DSN string (option -dsn), and replicate the one found to initialize your database container.

⁠FICCA_PASS

This is the passphrase used to protect the PKI's private key.

⁠FICOIDC_SECRET

When using DexIdP⁠ as OIDC provider to manage user authentication, this variable stores the OIDC client secret, shared with DexIdP.

⁠FICCLOUD_URL, FICCLOUD_USER, FICCLOUD_PASS

When using WebDAV synchronization, thoses variables hold the related parameters.

⁠FIC_BASEURL

Alter the base URL of the administrative part. By default it is expected to be reached at http://localhost:8081/, others settings suggest http://localhost:8081/admin. In the later case, use -e FIC_BASEURL=/admin/.

⁠License

View license information⁠ for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.