Aller au contenu

Plugin CTFd sso_bridge

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

Le front authentifie l'utilisateur auprès d'Authentik, puis échange cette identité contre un token API CTFd court via POST /api/v1/sso/session, signé en HMAC-SHA256. CTFd n'a donc plus de formulaire de login ; les rôles viennent des groupes OIDC et sont resynchronisés à chaque appel.

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

Chargé par CTFd au démarrage. Secrets : PAD_SSO_SHARED_SECRET (et _PREVIOUS pour la rotation) dans ctfd-secrets, valeur identique côté front.

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/sso_bridge/__init__.py, tests apps/ctfd/tests/test_sso_bridge.py, test_auth_contract.py.
  • Variables : PAD_SSO_MAX_SKEW_SECONDS (60), PAD_SSO_TOKEN_TTL_SECONDS, PAD_SSO_ALLOWED_CIDRS, PAD_GROUP_ADMINS/MANAGERS/PLAYERS, PAD_HIDE_MANAGERS.

Interactions avec les autres briques

Appelé par le BFF du front uniquement ; s'appuie sur pad_common (HMAC, rôles) ; le token est partagé entre replicas via Valkey.

Sécurité

  • HMAC sur méthode, chemin, horodatage, nonce et hash du corps ; fenêtre ±60 s ; nonce à usage unique (anti-rejeu) ; 503 si aucun secret (fail closed).
  • Restriction facultative par CIDR de la source directe (PAD_SSO_ALLOWED_CIDRS, ici le CIDR des pods) ; la NetworkPolicy du namespace ctfd n'autorise en entrée que le front, Traefik et la supervision.
  • Aucune liaison de comptes par e-mail (409 si l'e-mail appartient à un compte non lié à ce sub) ; un compte banni reçoit 403.
  • Managers masqués du scoreboard.

Supervision

Erreurs 4xx/5xx visibles dans les logs et sur le dashboard du front ; voir Front et CTFd.

Opérations courantes

Rotation du secret (sans coupure) : poser PAD_SSO_SHARED_SECRET_PREVIOUS = ancienne valeur et PAD_SSO_SHARED_SECRET = nouvelle côté CTFd, changer le front, puis retirer _PREVIOUS (Rotation des secrets).

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 token vit 900 s alors que la session du navigateur dure 12 h : le front le renouvelle (voir Front).
  • Un compte déconnecté par erreur : le front déconnecte l'utilisateur sur 400/401/403/409, pas sur une indisponibilité (502).

Documentation officielle

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

Retour à l'index des composants