Submission server/infrastructure for the SRS challenge at FIC https://fic.srs.epita.fr/
Go to file
nemunaire 5d7967a157 Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
db Fix DB schema by adding missing hash algorithms 2014-11-10 18:14:51 +01:00
docs Add themes DTD 2014-11-19 18:30:07 +01:00
front Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
htdocs Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
misc Fix CA path 2014-11-21 23:07:01 +01:00
onyx New instruction to regen nginx team file 2014-11-23 16:29:10 +01:00
submission Create submission dir 2013-11-05 02:51:43 +01:00
.dockerignore Add .dockerignore 2014-11-19 18:01:04 +01:00
.gitignore Ignore emacs temp files 2014-11-20 12:21:57 +01:00
Dockerfile Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
README.md New instruction to regen nginx team file 2014-11-23 16:29:10 +01:00
TODO Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
backup.sh Use bash for Debian compat 2014-11-20 21:03:35 +01:00
check.pl Fix bad query when checking for already solved exercice 2014-11-20 21:02:29 +01:00
clear_cache.sh Use bash for Debian compat 2014-11-20 21:03:35 +01:00
comm-socket.pl Can use comm-socket with argument 2014-01-20 10:58:59 +01:00
config.sh Document some script + centralize script configuration 2014-11-19 18:29:46 +01:00
gen_hash_link_files.sh Make raw copy or hardlink instead of symlink, mainly for container test usage 2014-11-21 10:24:13 +01:00
gen_site.pl New instruction to regen nginx team file 2014-11-23 16:29:10 +01:00
gen_site.sh Use bash for Debian compat 2014-11-20 21:03:35 +01:00
launch.sh New instruction to regen nginx team file 2014-11-23 16:29:10 +01:00
launch_local.sh New instruction to regen nginx team file 2014-11-23 16:29:10 +01:00
nginx-server-common.conf Calculate countdown by reading X-FIC-time giving by the server instead of rely on user system date 2014-11-23 16:56:30 +01:00
nginx-server.conf Add a Dockerfile for frontend test container; adapt code to simplify synchronization or Docker linkage 2014-11-21 15:55:38 +01:00
nginx_gen_team.sh Add a Dockerfile for frontend test container; adapt code to simplify synchronization or Docker linkage 2014-11-21 15:55:38 +01:00
php-fpm.conf Add a Dockerfile for development purpose 2014-08-27 12:26:49 +02:00
stop.sh Document some script + centralize script configuration 2014-11-19 18:29:46 +01:00
synchro.sh Add a Dockerfile for frontend test container; adapt code to simplify synchronization or Docker linkage 2014-11-21 15:55:38 +01:00

README.md

FIC forensic challenge validation server

This is a CTF server for distributing and validating exercices. It is design to be robust, so it uses some uncommon technologies like client certificate for authentication, cryptographic functions and DMZ network architecture.

Development And Testing

The easiest way to have a working server is to build a Docker container.

Docker

First, build the container with the following command:

docker build -t fic .

Then, run it with:

docker run -t -i -P fic

It will ask you for a passphrase, you must provide one with at least 4 characters. This key is used to generate the server certificate.

When you see:

root@xxxxxxxxxxxx:/var/www/fic-server/misc#

congratulations, the container is running!

Use docker ps to view to which local ports was assigned the contained webserver.

Database

Demo data are available in /var/www/fic-server/db/feed.sql. In test environment, you can run the following command:

mysql -u root fic < /var/www/fic-server/db/feed.sql

Frontend container

To run the frontend on the same machine as the backend (but in another container), run the following command:

docker run -P -ti --volumes-from BACKEND_CNTNR_NAME FRONTEND_IMG

Production Environnement

Setup

You should compile/install hardened kernel (with latest stable GrSec patch) on each machine.

Prefer GNU/Linux distributions where most packages are compiled with -fPIC and -fstack-protector, like Ubuntu or Gentoo Hardened.

As machines aren't always in safe place (transportation, night before CTF, ...), disks should be encrypted.

Always set strong password when it is possible eg. SSL certificats, ...

Frontend

Keep in mind that this is the machine exposed to participant.

Requirements
  • nginx with those modules: aio (for fast delivery of huge content), fastcgi, rewrite, ssl;
  • php-fpm with mcrypt module (for submission encryption);
Firewall rules

Expose to participants only 80 and 443 ports.

Expose on synchronization interface the 22 port, used for synchronization and administration purpose from backend.

DROP has to be the default rule for INPUT, FORWARD and OUTPUT chains; use CONNTRACK states.

Backend

Requirements
  • realpath;
  • mysql;
  • nginx with fastcgi module;
  • php-fpm with mysql module;
  • openssl and pwgen for client certificat generation;
  • mcrypt;
  • HTTP::Request::Common perl module (provided by libwww-perl);
  • Digest::Whirlpool perl module (provided by lib-digest-whirlpool-perl);
  • Mcrypt from CPAN (cpan -i Mcrypt, on Debian, it requires libltdl-dev and build-essential) to decrypt submissions (see https://metacpan.org/pod/Mcrypt);
Files distribution

You need to manually place challenge given files in the tree. To avoid path guessing, files path are hashed. To generate hashed paths, use the script gen_hash_link_files.sh:

mkdir $TO
./gen_hash_link_files.sh FROM TO

Where FROM is the directory with the orignal tree and TO the directory where placed symlink.

Firewall rules

This machine shouldn't have any network connection, except outgoing one to the frontend for synchronization.

Others setups

Indicate in /etc/hosts.conf IP(s) of the frontend.

Run

Two scripts are available, depending if directories synchronization has to be made or not.

You don't need to handle synchronization if it's done by a separate container or if frontend is linked to backend.

The launch.sh and launch_local.sh scripts do all backend stuff for you: synchronization with frontend (only launch.sh), submission checking and smart static pages regeneration.

History

FIC2014

Two machines (DC7900: Core 2 Quad) were used : one for backend (Deimos) and one for frontend (Phobos). They ran a GNU/Linux Gentoo Hardened with custom 3.2 kernel without module loading, unused and unecessary components and with all GrSecurity features activated.

Each machine was two network interfaces: one was used to permit to the backend machine to connect to the frontend (over IPv6). The second interface on the backend was used for administration purpose (with a laptop not connected to Internet). The second interface on the frontend was used to provide network connectivity to participants.

Both frontend and backend were 2 500GB hard-drives with software RAID1. The whole logical RAID disk was LUKS encrypted using Serpent algorithm.

The D Day

Interact with the scheduler

When you launch launch.sh or launch_local.sh script, a socket is open at /tmp/scheduler.sock. Use perl comm-socket.pl /tmp/scheduler.sock to connect to the scheduler. Consult gen_site.pl manual (perldoc gen_site.pl) for list of available instructions.

More

TODO