fail2ban protège SSH en lisant les journaux d'authentification de sshd et en bloquant au niveau du pare-feu les IP qui échouent trop souvent. Pour SSH, il suffit d'un fichier /etc/fail2ban/jail.local avec la jail [sshd] activée, un maxretry bas et un bantime raisonnable. Vous vérifiez ensuite le résultat avec fail2ban-client status sshd.

Comment fail2ban bloque les attaques par force brute sur SSH

fail2ban lit les journaux d'authentification de sshd et les passe dans un filtre d'expressions régulières. Quand une IP accumule maxretry échecs dans l'intervalle findtime, fail2ban exécute une action qui la bloque au niveau du pare-feu pendant bantime. Une fois ce délai écoulé, la règle est supprimée automatiquement.

Soyez clair sur la portée de l'outil. fail2ban réduit le bruit et le coût des tentatives automatisées contre le port TCP 22, mais il ne remplace pas l'authentification par clé. Si le serveur accepte des mots de passe faibles, un attaquant qui répartit ses tentatives sur de nombreuses IP peut continuer à essayer sous le seuil de chaque adresse.

Configurer la jail sshd de fail2ban dans jail.local

La règle de base : ne jamais modifier /etc/fail2ban/jail.conf, car les mises à jour du paquet l'écrasent. Vos modifications vont dans /etc/fail2ban/jail.local, que fail2ban lit ensuite et qui a la priorité.

Sous Debian ou Ubuntu, installez le paquet et ouvrez le fichier :

sudo apt install fail2ban
sudo nano /etc/fail2ban/jail.local

Une configuration SSH minimale et réaliste :

[DEFAULT]
ignoreip = 127.0.0.1/8 ::1
bantime  = 1h
findtime = 10m
maxretry = 3
bantime.increment = true

[sshd]
enabled = true
port    = ssh
backend = systemd

port = ssh correspond au port 22. Si sshd écoute ailleurs, indiquez le numéro réel (port = 2222) ; sinon, les bannissements s'appliquent à un port que personne n'utilise. backend = systemd permet à fail2ban de lire le journal sur les distributions qui n'écrivent pas /var/log/auth.log. Si votre système écrit bien ce fichier, vous pouvez supprimer cette ligne. Activez le service, puis redémarrez-le après chaque modification :

sudo systemctl enable --now fail2ban
sudo systemctl restart fail2ban

Sur un téléphone, enregistrer et quitter nano demande Ctrl+O et Ctrl+X. Le clavier de termi1, un terminal SSH pour iOS et Android, dispose des touches Ctrl, Esc, Tab et des flèches : modifier jail.local ne vous oblige donc pas à courir chercher un ordinateur portable.

Ce que contrôlent bantime, findtime et maxretry dans fail2ban

maxretry est le nombre d'échecs autorisés, findtime la fenêtre dans laquelle ils sont comptés et bantime la durée du blocage. Les deux derniers acceptent des suffixes de durée comme m, h ou d.

  • maxretry = 3 : avec l'authentification par clé, un utilisateur légitime n'échoue presque jamais trois fois de suite ; un bot, si.
  • findtime = 10m : trois échecs répartis sur une heure ne comptent pas ; trois en dix minutes, si.
  • bantime = 1h : assez long pour que le bot passe son chemin, assez court pour ne pas vous bloquer une journée entière si vous vous trompez vous-même.
  • bantime.increment = true : chaque récidive de la même IP allonge le bannissement suivant.

Un bantime négatif (-1) rend les bannissements permanents. C'est tentant, mais la liste grossit sans limite, et une IP dynamique réattribuée plus tard à un utilisateur légitime reste bloquée pour toujours.

Vérifier fail2ban avec fail2ban-client status sshd

sudo fail2ban-client status sshd affiche l'état de la jail. La section Filter indique les échecs actuels et totaux ; la section Actions indique les IP actuellement bannies, le total des bannissements et la liste des adresses.

sudo fail2ban-client status
sudo fail2ban-client status sshd
sudo fail2ban-client get sshd bantime
sudo fail2ban-client set sshd unbanip 203.0.113.45
  • status sans argument liste les jails actives. Si sshd n'y figure pas, enabled = true manque ou il y a une erreur de syntaxe ; consultez sudo journalctl -u fail2ban.
  • status sshd qui affiche zéro échec au total alors que le journal montre des connexions échouées signifie généralement un mauvais backend ou un mauvais chemin de journal.
  • get sshd bantime confirme la valeur réellement chargée par fail2ban, et non celle que vous croyez avoir saisie.
  • set sshd unbanip lève le bannissement d'une seule IP.

Dans termi1, vous pouvez dicter « débannis 203.0.113.45 dans fail2ban » : l'IA saisit la commande dans l'invite sans appuyer sur Entrée, et en mode Review elle ne l'exécute jamais à votre place. Sur une connexion marquée comme production, Production Guard retient tout ce qui arrête ou modifie quelque chose, comme systemctl restart, avant que cela n'atteigne l'invite.

fail2ban face aux autres défenses SSH : tableau comparatif

La défense qui stoppe net la force brute sur les mots de passe est PasswordAuthentication no, documentée dans la référence officielle de sshd_config. fail2ban est une couche complémentaire.

MesureCe qu'elle bloqueCe qu'elle ne bloque pasRisque de vous bloquer vous-même
Jail sshd de fail2banLes bots qui réessaient depuis une seule IPLes attaques réparties sur de nombreuses IPMoyen si vous échouez plusieurs fois de suite
Clés uniquement (PasswordAuthentication no)La devinette de mots de passeLe bruit dans les journauxFaible si vous conservez une deuxième clé autorisée
Déplacer SSH hors du port 22Les scans automatisés les plus basiquesUn scan complet des portsFaible ; pensez à mettre à jour port dans jail.local
Réseau privé maillé, sans port publicToute tentative directe depuis InternetL'accès depuis l'intérieur du maillageFaible tant que le maillage fonctionne

Empêcher fail2ban de bannir votre propre connexion SSH depuis un téléphone

ignoreip liste les adresses que fail2ban ne bannit jamais, et c'est votre principale protection contre l'auto-bannissement. Le piège sur un téléphone, c'est que l'IP change : le wifi du bureau peut avoir une adresse fixe, mais vous ne pouvez pas mettre les données mobiles sur liste blanche à l'avance.

  1. Gardez une voie de secours avant de toucher à la configuration. La console web de votre hébergeur ou un autre réseau vous permet d'exécuter unbanip si vous vous retrouvez bloqué.
  2. Utilisez des clés, pas des mots de passe. Pas de mot de passe à taper, donc pas de fautes de frappe qui s'accumulent en échecs. termi1 génère la clé sur le téléphone lui-même, la stocke dans le stockage sécurisé du système, et la clé privée ne quitte jamais l'appareil.
  3. Connectez-vous via un réseau privé maillé. Avec un réseau privé maillé sans ports ouverts comme Prialo, ou avec Tailscale, vous arrivez depuis une IP du maillage qui ne change pas. Ajoutez sa plage à ignoreip, ou cessez complètement d'exposer le port 22 à Internet.
  4. Comprenez comment Mosh se connecte. Mosh lance mosh-server via une connexion SSH initiale, et les échecs de cette connexion comptent pour la jail sshd. Ensuite, le trafic passe par les ports UDP 60000-61000, que la jail ne surveille pas. termi1 maintient la session Mosh active quand vous passez du wifi aux données mobiles, ce qui signifie moins de reconnexions et moins d'occasions d'échouer.
  5. Lancez les tâches longues dans tmux. Si une règle vous coupe, ce qui était en cours d'exécution est toujours là quand vous vous reconnectez.

Questions fréquentes

Où configure-t-on fail2ban pour SSH ?

fail2ban pour SSH se configure dans /etc/fail2ban/jail.local, dans une section [sshd] avec enabled = true. Ne touchez pas à jail.conf, car les mises à jour du paquet l'écrasent. Après chaque modification, redémarrez le service avec sudo systemctl restart fail2ban afin que les nouvelles valeurs soient chargées.

Quel bantime utiliser pour SSH ?

Un bantime d'une heure combiné à bantime.increment = true offre un bon équilibre entre protection et confort. Les bots passent leur chemin, les récidivistes reçoivent des bannissements de plus en plus longs, et un auto-bannissement par erreur ne vous prive pas d'accès pendant des jours. Un bantime de -1 rend chaque bannissement permanent.

Comment débannir une IP dans fail2ban ?

On débannit une IP dans fail2ban avec sudo fail2ban-client set sshd unbanip suivi de l'adresse. Vérifiez d'abord avec sudo fail2ban-client status sshd qu'elle figure dans la liste des IP bannies. Si l'adresse bannie est la vôtre, lancez la commande depuis un autre réseau ou depuis la console de votre hébergeur.

fail2ban protège-t-il aussi les connexions Mosh ?

fail2ban protège l'étape SSH de Mosh, car mosh-server est lancé via une connexion SSH initiale dont sshd journalise les échecs. Le trafic suivant passe par les ports UDP 60000-61000, que la jail sshd ne surveille pas : restreignez donc plutôt cette plage dans votre pare-feu.