CTFd (headless)¶
Couche : Applications CTF · Où : pods du cluster (namespace ctfd, 2 à 4 replicas) · Version : 3.8.8 (image ctfd/ctfd épinglée par digest) + plugins pad_*
À quoi elle sert ici et pourquoi ce choix¶
CTFd gère le cœur du jeu (challenges, flags, scores, équipes), mais il est utilisé en headless : le navigateur ne lui parle jamais, c'est le front qui consomme son API.
Les plugins pad_* ajoutent ce qui manque (SSO par pont HMAC, instances, équipes sûres, import, métriques). Le login local est désactivé (404), sauf un accès de secours pour les admins.
Où elle tourne et comment elle est déployée¶
Image pad-ctfd construite par la CI (apps/ctfd/Dockerfile) à partir de l'image officielle épinglée, avec dépendances à hashes obligatoires. Déploiement gitops/apps/ctfd :
Deployment (2 à 4 replicas selon KEDA), Ingress sur ctfd-admin (interne), ServiceMonitor, NetworkPolicy, base MariaDB, cache Valkey, uploads sur Garage.
Version épinglée¶
- Image de base :
docker.io/ctfd/ctfd:3.8.8@sha256:...dansapps/ctfd/Dockerfile. - Dépendances Python des plugins :
apps/ctfd/requirements.txt(versions et hashes exacts,--require-hashes). - Image déployée :
gitops/apps/ctfd/deployment.yaml(tag0.1.0, maintenu avec la CI).
Fichiers de configuration dans le dépôt¶
apps/ctfd/Dockerfile,requirements.txt,README.md,API.md,scripts/test.sh,tests/.gitops/apps/ctfd/:deployment.yaml,mariadb.yaml,ingress.yaml,networkpolicy.yaml,scaledobject.yaml,servicemonitor.yaml,secret.example.yaml.- Variables :
UPLOAD_PROVIDER=s3,REDIS_HOST,DATABASE_*,PAD_*(voir les plugins).
Interactions avec les autres briques¶
Appelé par le front (API) ; parle à chall-manager (plugin chall_manager_bridge) ; stocke dans MariaDB, Valkey, Garage ;
expose des métriques à VictoriaMetrics ; fournit les membres d'équipe à netbird-sync.
Sécurité¶
- Login, inscription, réinitialisation et OAuth natifs répondent 404 ; seul
sso_bridgecrée des sessions. Accès de secours optionnelPAD_LOCAL_LOGIN_BREAKGLASSlimité à des hôtes (PAD_LOCAL_LOGIN_HOSTS). - Création de token acceptée seulement depuis le CIDR des pods (
PAD_SSO_ALLOWED_CIDRS) et avec HMAC valide. - Utilisateur non-root (UID 1001), NetworkPolicy de namespace,
WORKERS=2,REVERSE_PROXYconfiguré.
Supervision¶
- Exporter
metrics_exporter(voir sa page) ; alertesCtfdDeploymentDown,CtfdMetricsMissing,CtfdIncorrectSubmissionsBurst,CtfEventPaused: CTFd. - Dashboard
pad-live-ctf.
Opérations courantes¶
Pièges connus¶
- CTFd 3.8 ne connecte un porteur de
Authorization: Tokenque si la requête est en JSON (Content-Type: application/json), même pour un GET. - Un cookie de session prime sur le header
Authorization: le front ne relaie jamais de cookie CTFd. - Le build exige le contexte nommé
schema=../../challenges/schema(pas de schéma de secours).