CTF self-hosted: challenge web originali + scoreboard, distribuiti con Docker Compose tramite GitLab CI e un agente GitOps. Le flag derivano da un unico secret CI; ogni pipeline distribuisce lo stack e risolve automaticamente ogni challenge.
Un evento capture-the-flag completo che puoi gestire autonomamente: quattro challenge web originali, una classifica e la macchina GitLab CI/CD + GitOps che compila, analizza, distribuisce e gioca l'intero sistema a ogni commit.
Cosa mette in mostra
compose.yaml avvia sei container rafforzati, senza bind mount, così lo
stesso file si distribuisce su un laptop, su un servizio Docker-in-Docker di CI o su un host remoto via SSH.depends_on, limiti di risorse, filesystem
root in sola lettura, capability rimosse, utenti non-root e un volume persistente che sopravvive ai redeploy.main è lo stato desiderato. Un agente pull-based (ctfops reconcile, un timer
systemd) distribuisce un commit solo dopo che la sua pipeline è passata, lo verifica e fa rollback automaticamente se
non si avvia in stato sano. Il rollback intenzionale è git revert.flowchart LR
players((Players)) -->|":8000"| gw
players -->|":9001-9004"| gw
subgraph host["Docker host (compose project 'ctf')"]
gw["gateway<br/>nginx, rate limits"]
subgraph sbnet["network: scoreboard (internal)"]
sb["scoreboard<br/>Flask + SQLite"] --- vol[("scoreboard-data")]
end
subgraph c1["net-paper-trail (internal)"]
pt["paper-trail"]
end
subgraph c2["net-cookie-jar (internal)"]
cj["cookie-jar"]
end
subgraph c3["net-bookworm (internal)"]
bw["bookworm"]
end
subgraph c4["net-fetch-docs (internal)"]
fd["fetch-docs"]
end
gw --> sb & pt & cj & bw & fd
end
Solo il gateway si trova su una rete instradabile. Ogni challenge è isolata su una rete internal, quindi un giocatore
che ottiene l'esecuzione di codice in una challenge non può raggiungere né la scoreboard, né le altre challenge, né
internet. ctfops verify-isolation lo dimostra in CI dall'interno di ogni container.
| Servizio | Immagine | Note |
|---|---|---|
gateway | nginx-unprivileged (digest bloccato) | Ingress unico. 2 req/s per client sull'invio dei flag, 1 req/s su login/register, limiti di connessioni per IP, nessun banner di versione. Risolve gli upstream in modo lazy, così la sostituzione di una challenge non manda mai giù la piattaforma. |
scoreboard | Python 3.13 / Flask / gunicorn | Team, invio dei flag (HTML + API JSON), classifica con first blood, finestra dell'evento, statistiche admin. Password con scrypt, token API con hash, token CSRF, CSP. |
paper-trail, cookie-jar, bookworm, fetch-docs | un unico challenge.Dockerfile condiviso | Applicazioni intenzionalmente vulnerabili, una per container. Il solver di riferimento viene rimosso dall'immagine. |
Tutte originali. I valori in punti si trovano in ctf.toml, l'unica fonte di verità per l'evento.
| Challenge | Punti | Descrizione |
|---|---|---|
| Paper Trail | 100 | Un portale di fatturazione con un account guest. |
| Cookie Jar | 150 | Una bacheca dello staff che ti ricorda tramite un cookie. |
| Bookworm | 200 | Un catalogo di biblioteca con una casella di ricerca. |
| Fetch Docs | 200 | Un visualizzatore di documenti interni con un filtro di percorso fatto in casa. |
| Challenge | Vulnerabilità | Exploit di riferimento |
|---|---|---|
| Paper Trail | Insecure direct object reference: le fatture verificano il login, non la proprietà | accedi come guest, scorri gli id delle fatture fino a #1001 |
| Cookie Jar | Sessione lato client non firmata (JSON in base64) | decodifica il cookie, imposta "role": "admin", ricodifica |
| Bookworm | SQL injection (SQLite) | UNION SELECT da sqlite_master per trovare una tabella nascosta, poi estraila |
| Fetch Docs | Path traversal oltre un filtro ../ a passaggio singolo | ....// collassa in ../; leggi /proc/self/environ, dove il flag è stato passato al processo |
Ogni exploit è implementato in challenges/<id>/solve.py e viene eseguito in ogni pipeline.
Richiede Docker con il plugin Compose e Python 3.11+.
pip install -r requirements-dev.txt
export PYTHONPATH=src
python -m ctfops new-seed > .ctf-seed && chmod 600 .ctf-seed # gitignored; it IS every flag
python -m ctfops compose up -d --build --wait # build and start all six containers
python -m ctfops smoke --host localhost # play the CTF end to end
Apri http://localhost:8000, registra una squadra e inizia a fare hacking sulle porte 9001-9004.
python -m ctfops compose down -v rimuove tutto, inclusi i dati della scoreboard.
ctfops compose ... è docker compose ... con i segreti derivati iniettati nell'ambiente di processo di Compose.
Ogni container riceve solo il proprio segreto; un container avviato senza di esso rifiuta di partire,
così un deploy che ha dimenticato il seed fallisce in modo evidente invece di servire un flag indovinabile.