Aller au contenu

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