Architecture¶
PenetrateAndDestroy tient sur un seul serveur Proxmox. Les services d'infrastructure tournent dans des LXC
(Docker Compose) ; le routeur (OPNsense) et les nœuds Kubernetes (Talos) sont des VM. Tout ce qui est applicatif
tourne dans le cluster Kubernetes pad-prod, piloté par ArgoCD.
Composants¶
| Couche | Composant | Type | Rôle |
|---|---|---|---|
| Hôte | Proxmox VE, ZFS | bare metal | hyperviseur, stockage, bridge vmbr2 |
| Réseau | OPNsense | VM | routeur, pare-feu inter-zones, DNS interne (Unbound), IDS |
| Bordure | edge (Traefik + CrowdSec) |
LXC, zone DMZ | TLS, reverse proxy public, bannissement |
| Accès | netbird |
LXC, zone DMZ | VPN WireGuard des joueurs et du staff |
| Accès | warpgate |
LXC, zone BASTION | bastion SSH/HTTPS pour le staff |
| Identité | authentik |
LXC, zone IDENTITY | IdP OIDC, flows d'inscription |
| Supervision | monitoring |
LXC, zone MONITORING | VictoriaMetrics, Loki, Tempo, Grafana, Alertmanager, Uptime Kuma |
| Cluster | pad-prod (Talos) |
VM, zones PROD et CHALLENGES | plateforme et applications |
| Applications | front, CTFd, chall-manager, netbird-sync | pods | le CTF lui-même |
Zones et VLAN¶
Un bridge vmbr2 VLAN-aware, sans uplink, relie toutes les zones. Seule la VM OPNsense le traverse : tout trafic
inter-zones passe donc par ses règles.
flowchart TB
NET((Internet)) --- WAN[WAN OPNsense<br/>IP publique]
WAN --- FW{{OPNsense<br/>deny all par défaut}}
FW --- MGMT[VLAN 10 MGMT<br/>10.20.10.0/24<br/>admin OPNsense, hôte Proxmox]
FW --- DMZ[VLAN 20 DMZ<br/>10.20.20.0/24<br/>edge, netbird]
FW --- BAS[VLAN 30 BASTION<br/>10.20.30.0/24<br/>warpgate]
FW --- IDN[VLAN 40 IDENTITY<br/>10.20.40.0/24<br/>authentik]
FW --- MON[VLAN 50 MONITORING<br/>10.20.50.0/24<br/>monitoring]
FW --- PROD[VLAN 60 PROD<br/>10.20.60.0/24<br/>control plane, workers platform, ingress]
FW --- CHAL[VLAN 70 CHALLENGES<br/>10.20.70.0/24<br/>workers challenges, instances]
Détail des plages, des adresses et du WAN : Réseau et zones. Règles autorisées : Matrice de flux.
Parcours d'une requête joueur¶
Le joueur ne parle qu'au front. Le front ne détient aucun token CTFd côté navigateur : le serveur du front (BFF) échange l'identité OIDC contre un token API court, puis appelle CTFd.
sequenceDiagram
autonumber
actor J as Joueur
participant E as edge (Traefik, CrowdSec)
participant F as Front Next.js (BFF)
participant A as Authentik
participant C as CTFd (plugins pad_*)
participant V as Valkey
J->>E: HTTPS ctf.example.net
E->>F: requête filtrée (CrowdSec)
F->>A: connexion OIDC (première visite)
A-->>F: claims (sub, groupes ctf-players...)
F->>V: token CTFd en cache ?
alt token absent ou expirant
F->>C: POST /api/v1/sso/session (signature HMAC)
C-->>F: token API (TTL 900 s)
F->>V: stocke le token, verrou de renouvellement
end
F->>C: appels API avec Authorization: Token
C-->>F: challenges, scoreboard, soumissions
F-->>J: page rendue (aucun token CTFd dans le navigateur)
Le contrat exact de cette API est dans API des plugins CTFd.
Exposition publique et privée¶
| Ce qui est public (Internet, ports 80/443) | Ce qui exige NetBird (VPN) |
|---|---|
front (ctf), Authentik (auth), NetBird (vpn), page de statut (status) |
instances de challenges, bastion Warpgate, Grafana, ArgoCD, registry, UI d'admin CTFd, Alertmanager, Hubble |
Les noms de domaine viennent des hostnames du contrat.
Où lire ensuite¶
- Cycle de vie d'une instance : du clic du joueur à la règle NetBird.
- Bootstrap du cluster : de
kindà ArgoCD. - Chaîne des secrets : de
sopsau pod. - Scaling et Supervision.
- Décisions d'architecture : pourquoi ces choix.