CTF auto-hospedado: desafios web originais + placar, implantado com Docker Compose via GitLab CI e um agente GitOps. Flags derivadas de um único segredo de CI; cada pipeline implanta a stack e resolve automaticamente todos os desafios.
Um evento completo de capture-the-flag que você mesmo pode executar: quatro desafios web originais, um placar e a maquinaria de GitLab CI/CD + GitOps que constrói, escaneia, implanta e joga tudo a cada commit.
O que ele demonstra
compose.yaml executa seis contêineres endurecidos, sem bind mounts, de modo que o
mesmo arquivo é implantado em um laptop, em um serviço Docker-in-Docker de CI ou em um host remoto via SSH.depends_on, limites de recursos, sistemas de arquivos raiz somente leitura,
capacidades removidas, usuários não-root e um volume persistente que sobrevive a reimplantações.main é o estado desejado. Um agente baseado em pull (ctfops reconcile, um timer
systemd) implanta um commit somente após seu pipeline passar, verifica-o e faz rollback automaticamente se
ele não subir saudável. Reverter de propósito é 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
Apenas o gateway fica em uma rede roteável. Cada desafio está isolado em uma rede internal, de modo que um jogador
que obtém execução de código em um desafio não consegue alcançar o placar, nem os outros desafios, nem a
internet. ctfops verify-isolation comprova isso no CI a partir de dentro de cada contêiner.
| Serviço | Imagem | Observações |
|---|---|---|
gateway | nginx-unprivileged (digest fixado) | Ingress único. 2 req/s por cliente no envio de flags, 1 req/s no login/registro, limites de conexão por IP, sem banner de versão. Resolve upstreams de forma lazy, então a substituição de um desafio nunca derruba a plataforma. |
scoreboard | Python 3.13 / Flask / gunicorn | Equipes, envio de flags (HTML + API JSON), ranking com first bloods, janela do evento, estatísticas de admin. Senhas com scrypt, tokens de API com hash, tokens CSRF, CSP. |
paper-trail, cookie-jar, bookworm, fetch-docs | um challenge.Dockerfile compartilhado | Aplicações intencionalmente vulneráveis, uma por contêiner. O solver de referência é removido da imagem. |
Todos originais. Os valores em pontos ficam em ctf.toml, a única fonte de verdade do evento.
| Desafio | Pontos | Descrição |
|---|---|---|
| Paper Trail | 100 | Um portal de cobrança com uma conta de convidado. |
| Cookie Jar | 150 | Um mural de avisos da equipe que se lembra de você por meio de um cookie. |
| Bookworm | 200 | Um catálogo de biblioteca com uma caixa de busca. |
| Fetch Docs | 200 | Um visualizador de documentos internos com um filtro de caminho caseiro. |
| Desafio | Vulnerabilidade | Exploit de referência |
|---|---|---|
| Paper Trail | Referência direta insegura a objeto: as faturas verificam o login, não a propriedade | faça login como convidado, percorra os ids de fatura até #1001 |
| Cookie Jar | Sessão do lado do cliente sem assinatura (JSON em base64) | decodifique o cookie, defina "role": "admin", recodifique |
| Bookworm | Injeção de SQL (SQLite) | UNION SELECT em sqlite_master para encontrar uma tabela oculta e então extraí-la |
| Fetch Docs | Path traversal contornando um filtro de ../ de passagem única | ....// colapsa para ../; leia /proc/self/environ, onde a flag foi entregue ao processo |
Cada exploit é implementado em challenges/<id>/solve.py e roda em todos os pipelines.
Requer Docker com o 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
Abra http://localhost:8000, registre uma equipe e comece a hackear nas portas 9001-9004.
python -m ctfops compose down -v remove tudo, incluindo os dados do placar.
ctfops compose ... é docker compose ... com os segredos derivados injetados no ambiente de processo do Compose. Cada contêiner recebe apenas o seu próprio segredo; um contêiner iniciado sem um recusa-se a iniciar, de modo que uma implantação que esqueceu a seed falha ruidosamente em vez de servir uma flag adivinhável.
| Estágio | Jobs | O que comprova |
|---|---|---|
| lint | python-lint, dockerfile-lint, compose-config | Ruff, Hadolint, o Compose faz o parse; ctfops validate verifica que ctf.toml, compose.yaml, gateway/nginx.conf e as pastas de desafios descrevem a mesma plataforma, e que cada serviço mantém o seu hardening e isolamento |
| test | unit-tests, secret_detection, semgrep-sast | Mais de 100 testes (cada desafio explorado em processo pelo seu solver, gate de cobertura >90%); GitLab Secret Detection: nenhuma flag ou seed foi commitada; SAST no código da plataforma |
| build | build-images | docker compose build + push de todas as seis imagens, marcadas com o SHA do commit |
| scan | trivy-images, trivy-config | Falha em CVEs críticas corrigíveis e em qualquer segredo encontrado dentro de uma imagem; configurações incorretas de Dockerfile |
| verify | deploy-ephemeral | Implanta as imagens enviadas num host Docker-in-Docker com uma seed descartável, depois: health, cabeçalhos de segurança, lista de desafios, cada desafio resolvido e pontuado, flags e tokens inválidos rejeitados, autenticação de admin, rate limiting do gateway, sondas de isolamento, e uma recriação do placar que deve manter os seus dados |
| release | promote-latest (main) | Move :latest para as imagens verificadas |
| deploy | deploy-production (main, manual) | Implantação em modo push via SSH; só aparece depois de DEPLOY_HOST estar configurado |