
CTF autoalojado: retos web originales + marcador, desplegado con Docker Compose mediante GitLab CI y un agente GitOps. Flags derivadas de un único secreto de CI; cada pipeline despliega el stack y resuelve automáticamente todos los retos.
Un evento completo de capture-the-flag que puedes ejecutar tú mismo: cuatro retos web originales, un marcador y la maquinaria de GitLab CI/CD + GitOps que compila, escanea, despliega y juega todo el conjunto en cada commit.
Qué demuestra
compose.yaml ejecuta seis contenedores reforzados, sin bind mounts, de modo que el
mismo archivo se despliega en un portátil, en un servicio Docker-in-Docker de CI o en un host remoto por SSH.depends_on, límites de recursos, sistemas de archivos raíz de solo lectura,
capacidades eliminadas, usuarios no root y un volumen persistente que sobrevive a los redespliegues.main es el estado deseado. Un agente basado en pull (ctfops reconcile, un timer de systemd)
despliega un commit solo después de que su pipeline haya pasado, lo verifica y revierte automáticamente si
no arranca correctamente. Revertir a propósito es 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 la puerta de enlace se encuentra en una red enrutable. Cada reto está aislado en una red internal, de modo que un jugador que consigue ejecución de código en un reto no puede alcanzar ni el marcador, ni los demás retos, ni internet. ctfops verify-isolation lo demuestra en CI desde dentro de cada contenedor.
| Servicio | Imagen | Notas |
|---|---|---|
gateway | nginx-unprivileged (digest fijado) | Único punto de entrada. 2 req/s por cliente en el envío de flags, 1 req/s en login/registro, límites de conexiones por IP, sin banner de versión. Resuelve los upstreams de forma diferida, por lo que reemplazar un reto nunca tumba la plataforma. |
scoreboard | Python 3.13 / Flask / gunicorn | Equipos, envío de flags (HTML + API JSON), clasificación con first bloods, ventana del evento, estadísticas de administración. Contraseñas con scrypt, tokens de API con hash, tokens CSRF, CSP. |
paper-trail, cookie-jar, bookworm, fetch-docs | un challenge.Dockerfile compartido | Aplicaciones intencionalmente vulnerables, una por contenedor. El solucionador de referencia se elimina de la imagen. |
Todos originales. Los valores en puntos están en ctf.toml, la única fuente de verdad del evento.
| Reto | Puntos | Descripción |
|---|---|---|
| Paper Trail | 100 | Un portal de facturación con una cuenta de invitado. |
| Cookie Jar | 150 | Un tablón de anuncios del personal que te recuerda mediante una cookie. |
| Bookworm | 200 | Un catálogo de biblioteca con un cuadro de búsqueda. |
| Fetch Docs | 200 | Un visor de documentos interno con un filtro de rutas casero. |
| Reto | Vulnerabilidad | Exploit de referencia |
|---|---|---|
| Paper Trail | Referencia directa insegura a objetos: las facturas comprueban el inicio de sesión, no la propiedad | inicia sesión como invitado, recorre los ids de factura hacia abajo hasta #1001 |
| Cookie Jar | Sesión del lado del cliente sin firmar (JSON en base64) | decodifica la cookie, establece "role": "admin", vuelve a codificarla |
| Bookworm | Inyección SQL (SQLite) | UNION SELECT desde sqlite_master para encontrar una tabla oculta y luego volcarla |
| Fetch Docs | Path traversal que sortea un filtro de ../ de una sola pasada | ....// se colapsa a ../; lee /proc/self/environ, donde la flag fue entregada al proceso |
Cada exploit está implementado en challenges/<id>/solve.py y se ejecuta en cada pipeline.
Requiere Docker con el plugin Compose y 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
Abre http://localhost:8000, registra un equipo y empieza a hackear en los puertos 9001-9004.
python -m ctfops compose down -v elimina todo, incluidos los datos del marcador.
ctfops compose ... es docker compose ... con los secretos derivados inyectados en el entorno del proceso de Compose. Cada contenedor recibe únicamente su propio secreto; un contenedor iniciado sin uno se niega a arrancar, de modo que un despliegue que olvidó la semilla falla de forma ruidosa en lugar de servir una flag adivinable.