SEC.01

Le playbook

Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.

  1. 01recondistro et version d’OpenSSH
  2. 02reconconfig SSH effective (UsePAM yes requis)
  3. 03reconpile PAM auth de sshd (common-auth ou password-auth) et 2FA déjà branchée ?
  4. 04reconmodule PAM déjà installé ?
  5. 05reconl’utilisateur existe, a une clé autorisée (obligatoire) et a-t-il déjà enrôlé son TOTP ?
  6. 06reconcomptes sans clé : ils ne pourront plus se connecter (publickey devient obligatoire)
  7. 07reconsshd_config.d est-il inclus ? drop-ins existants
  8. 08reconSELinux enforcing (RHEL) : surveiller les refus après test
  9. 09agirActiver EPEL (RHEL/Rocky/Alma uniquement)vérif
  10. 10agirInstaller le module PAMvérif
  11. 11agirEnrôler le TOTP (fait par l’utilisateur)vérif
  12. 12agirSauvegarder PAM et sshd_configvérif
  13. 13agirInclure sshd_config.d (seulement si l’Include manque)vérif
  14. 14agirExiger clé + TOTP dans sshddestructifvérif
  15. 15agirRecharger sshd (sans couper les sessions)destructifvérif
  16. 16agirBrancher le TOTP dans PAM sshddestructifvérif

SEC.02

Ce qu'elle vérifie

Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.

  1. 01Activer EPEL (RHEL/Rocky/Alma uniquement)Vérifié pardnf repolist enabled | grep -ci epelattendu : au moins 1
  2. 02Installer le module PAMVérifié parcommand -v google-authenticatorattendu : un chemin
  3. 03Enrôler le TOTP (fait par l’utilisateur)Vérifié partest -s "$(getent passwd ${user} | cut -d: -f6)/.google_authenticator" && echo enrolledattendu : enrolled
  4. 04Sauvegarder PAM et sshd_configVérifié parls -1 /etc/pam.d/sshd.bak.* /etc/ssh/sshd_config.bak.*attendu : deux sauvegardes
  5. 05Inclure sshd_config.d (seulement si l’Include manque)Vérifié pargrep -cE '^\s*Include\s+/etc/ssh/sshd_config.d/' /etc/ssh/sshd_config && sshd -t && echo okattendu : au moins 1 puis ok
  6. 06Exiger clé + TOTP dans sshdVérifié parsshd -t && sshd -T | grep -Ei '^(authenticationmethods|passwordauthentication) 'attendu : authenticationmethods publickey,keyboard-interactive et passwordauthentication no
  7. 07Recharger sshd (sans couper les sessions)Vérifié parsystemctl is-active ssh.service sshd.service ssh.socket 2>/dev/null | grep -c '^active'attendu : au moins 1
  8. 08Brancher le TOTP dans PAM sshdVérifié pargrep -cE '^auth\s+required\s+pam_(google_authenticator|permit)\.so' /etc/pam.d/sshdattendu : 2

SEC.03

Les garde-fous

Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.

STOP si l’utilisateur n’a pas de clé autorisée ou si un compte utilisé sans clé perdrait l’accès. Ne génère jamais le secret TOTP toi-même. Ordre impératif : sshd (PasswordAuthentication no) et reload AVANT PAM. Toujours sshd -t avant reload ; reload, jamais restart. SELinux enforcing : en cas d’échec, regarde ausearch -m avc et ne désactive jamais SELinux. Garde la session ouverte et fais tester une NOUVELLE connexion ; l’agent Servor ne passe pas par SSH, le terminal Servor permet de restaurer les sauvegardes.

SEC.04

Les variables

Ce que vous choisissez avant de lancer — la recette s'occupe du reste.

NomSignification
${user}Utilisateur SSH à protéger

SEC.05

Comment une recette s'exécute dans Servor

Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.

recipe — fail2ban_setup150+ in catalogue
security4 étapes · risque faible · idempotentelancer
reconsshd present? ufw active? existing jails?✓
actinstall fail2ban · write default jails✓
actenable service · restart sshd (safe)✓
verifytest ban 60s · jails active · sshd alive✓

recherche par intention — tapez « firewall », obtenez ufw

  • 01Reconnaissance en lecture seule avant tout changement
  • 02Chaque commande signée par votre navigateur, validée par vous
  • 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique

SEC.06

Bouton Deploy on Servor

Vous maintenez 2FA SSH (TOTP) ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.

Deploy on ServorFond sombre
Deploy on ServorFond clair
[![Deploy on Servor](https://servor.app/badges/deploy-on-servor.svg)](https://servor.app/deploy/setup-ssh-2fa)

SEC.07

Recette vérifiée

Lancez cette recette sur votre serveur

Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.