ADR 2 : Fournisseur d'identité : Authentik¶
Statut : acceptée.
Contexte¶
Il faut un SSO unique pour le front, NetBird, Warpgate, Grafana et ArgoCD, une inscription libre des joueurs (captcha, vérification d'e-mail), des invitations pour le staff, et une configuration 100 % IaC.
Décision¶
Authentik est déployé en Docker Compose dans le LXC authentik (zone IDENTITY). Les applications, providers OIDC, groupes (ctf-players, ctf-managers, ctf-admins, infra-admins) et flows sont déclarés par la stack OpenTofu 30-authentik et des blueprints. Un outpost forward-auth protège les applications sans OIDC (VictoriaMetrics, Alertmanager, Hubble). Depuis la version 2025.10, Authentik n'utilise plus Redis. Le staff (ctf-managers, ctf-admins, infra-admins) doit valider un second facteur à la connexion et à l'autorisation de chaque application, le captcha protège l'inscription, une réputation par IP limite le brute-force, et seul infra-admins administre l'infrastructure (Identité).
Alternatives écartées¶
- Zitadel : plus léger et excellent en multi-tenant B2B, mais le multi-organisation est inutile ici, et il est plus pauvre en forward-auth et en flows personnalisables.
- Keycloak : puissant mais plus lourd en mémoire, et les flows d'inscription avec captcha demandent plus de développement.
- CTFd seul (comptes locaux) : ne résout ni le SSO des outils d'infrastructure ni la séparation des rôles.
Conséquences¶
- Authentik devient un point critique : sa panne bloque les connexions (voir Authentik). Le compte local
adminde Warpgate et un mode de secours CTFd (PAD_LOCAL_LOGIN_BREAKGLASS) existent pour ce cas. - La configuration OIDC de Warpgate reste côté Ansible : le provider OpenTofu ne gère pas les fournisseurs SSO de Warpgate.
- Les secrets clients OIDC sont des sorties de la stack
30-authentik, à reporter dans les fichiers SOPS.