PenetrateAndDestroy¶
PenetrateAndDestroy (PAD) est une plateforme CTF jetable : un seul serveur Proxmox, une seule commande
(task up) pour tout reconstruire, une seule (task destroy) pour tout effacer. Tout est décrit en code : réseau,
routeur, services, cluster Kubernetes, applications et supervision. Il n'y a aucune configuration manuelle cachée,
sauf quelques actions listées dans Actions manuelles après déploiement.
Le projet est personnel et public, mais la plateforme est pleinement utilisable : chacun peut la déployer sur son propre hôte Proxmox, avec ses propres valeurs de site (voir Valeurs de site).
Captures d'écran à venir
Les captures de l'espace joueur, du scoreboard, du portail manager et des dashboards Grafana seront ajoutées après le premier déploiement réel. Les emplacements sont marqués dans les guides.
Ce que fait la plateforme¶
- Un front sur mesure (Next.js) devant CTFd en mode headless : espace joueur, scoreboard en direct, gestion d'équipe, notifications, onboarding VPN, et un portail manager.
- Des challenges instanciés par équipe : chaque équipe lance, prolonge et arrête sa propre instance, avec un TTL. Les instances ne sont joignables que par le VPN NetBird, jamais depuis Internet.
- Une segmentation réseau réelle : un routeur OPNsense, sept zones VLAN, une matrice de flux « deny all par défaut » gérée en code. Voir Réseau et zones.
- Un cluster Kubernetes qui scale avec la charge : Talos Linux, Cluster API, ArgoCD, KEDA et un autoscaler de nœuds. Voir Scaling.
- Un SSO unique (Authentik) pour le front, NetBird, Warpgate, Grafana et ArgoCD, avec un bastion (Warpgate) pour le personnel.
- Une supervision complète : métriques, logs, traces, 4 dashboards, 67 alertes, chacune avec un runbook.
- Des secrets versionnés chiffrés (SOPS + age) : le dépôt est public sans rien divulguer. Voir Chaîne des secrets.
- Un import de challenges simple : ZIP envoyé depuis le portail manager, ou synchronisation depuis un dépôt Git privé séparé. Voir le guide manager.
Par où commencer¶
| Je veux... | Page |
|---|---|
| déployer la plateforme | Démarrage rapide |
| comprendre comment c'est construit | Architecture et décisions |
| réagir à une alerte | Runbooks |
| jouer | Guide joueur |
| publier des challenges et animer un événement | Guide manager |
| chercher une valeur, une tâche, une API | Référence |
Vue d'ensemble¶
flowchart LR
J[Joueur] -->|HTTPS 443| EDGE[edge : Traefik + CrowdSec]
J -->|WireGuard| NB[NetBird]
EDGE --> FRONT[Front Next.js]
FRONT --> CTFD[CTFd headless]
CTFD --> CM[chall-manager]
CM --> INST[Instances de challenges]
NB -->|routing peer| INST
EDGE --> AK[Authentik]
STAFF[Staff] --> NB --> WG[Warpgate]
WG --> PVE[Hôte Proxmox, zones, cluster]
Organisation du dépôt¶
Le dépôt est un monorepo. Les dossiers principaux :
| Dossier | Contenu |
|---|---|
infra/tofu |
stacks OpenTofu : réseau de l'hôte, routeur, LXC, Authentik, NetBird, Warpgate, règles, DNS |
infra/ansible |
rôles qui configurent l'hôte et les services en Docker Compose dans les LXC |
bootstrap |
cluster kind éphémère, Cluster API, pivot, installation d'ArgoCD |
gitops |
tout ce qui tourne dans Kubernetes (plateforme, applications, cluster de prod) |
apps |
front, plugins CTFd, netbird-sync, scénario chall-manager |
challenges |
schéma de challenge.yml et trois exemples |
monitoring |
dashboards, règles d'alerte, configuration Alertmanager |
infra/contracts.yaml |
source unique des IP, CIDR, noms, ports et groupes |
Conventions de cette documentation¶
Tous les exemples utilisent des valeurs fictives : domaine example.net, secrets CHANGEME. Les plages privées sont
celles du contrat (10.20.0.0/16). Aucune valeur de site n'est publiée.