Aller au contenu

Plugin CTFd pad_common

Couche : Applications CTF · Où : dans le pod CTFd (plugin chargé depuis CTFd/plugins/) · Version : version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt

À quoi elle sert ici et pourquoi ce choix

Évite de dupliquer la logique transverse : authentification des endpoints pad_* (token API et HMAC du BFF), rôles applicatifs (manager, admin), limiteur d'échecs à verrouillage progressif, journal d'audit JSON, état de l'événement, requêtes de score (first blood) et client de l'API REST de chall-manager. Il n'enregistre aucune route.

Où elle tourne et comment elle est déployée

Copié dans l'image pad-ctfd avec les autres plugins (apps/ctfd/Dockerfile). Importé par les autres plugins (CTFd.plugins.pad_common.*).

Version épinglée

version de l'image CTFd (3.8.8) ; plugin versionné avec le dépôt

Fichiers de configuration dans le dépôt

apps/ctfd/plugins/pad_common/ : auth.py, roles.py, ratelimit.py, audit.py, event.py, scores.py, settings.py, chall_manager.py.

Interactions avec les autres briques

Utilisé par sso_bridge, chall_manager_bridge, pad_teams, pad_public, manager_api, metrics_exporter.

Sécurité

  • Le rôle manager est un champ utilisateur caché (pad_roles), non éditable par l'utilisateur ; le sub OIDC est dans une table dédiée indexée.
  • Limiteur d'échecs : verrous à TTL dans le cache (Valkey en production), durée doublée à chaque récidive, plafonnée.
  • Journal d'audit sans e-mail, mot de passe, token ni flag soumis.
  • Configuration lue à chaque appel (env puis défaut) : un Secret modifié est pris en compte au redémarrage du pod.

Supervision

Journal d'audit pad.audit (une ligne JSON sur stderr, collectée par Alloy vers Loki).

Opérations courantes

bash apps/ctfd/scripts/test.sh                 # harnais pytest CTFd officiel (PAD_LINT_FULL=1 via scripts/lint.sh)
kubectl -n ctfd logs deploy/ctfd | grep pad.   # journaux des plugins

Pièges connus

Le client chall-manager cible l'API REST (grpc-gateway) de la lignée v0.6.x : une montée de version de chall-manager impose de revérifier chall_manager.py.

Documentation officielle

Contrat d'API : API des plugins CTFd (source : apps/ctfd/API.md) · Plugins CTFd

Retour à l'index des composants