=== Honeypot Fail2ban ===
Contributors: josselineveraert
Tags: honeypot, fail2ban, sécurité, pare-feu, bannissement
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 2.6.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Pots de miel reliés à fail2ban : les robots qui sondent le site sont repérés dans les journaux du serveur web et bannis sur tous les ports.

== Description ==

Les scanners automatiques demandent toujours les mêmes choses : `/.env`, `/.git/config`, des copies de `wp-config.php`, phpMyAdmin, des dumps SQL, des chemins truffés d'injections. Aucun visiteur honnête ne les demande.

Un moteur, lancé chaque minute en root par l'agent de l'extension, lit les journaux d'accès du serveur web depuis son passage précédent et prend :

* **les appâts fixes** : un catalogue commenté, chacun « toujours » ou « sur échec » (une page qui existe n'est pas un piège), plus vos propres expressions ;
* **les injections** : `../`, `/etc/passwd`, `union select`, `<script`, `${jndi:`… ;
* **les rafales** : plusieurs chemins suspects inexistants en peu de temps depuis la même adresse ;
* **les appâts appris** : un chemin suspect inexistant sondé par plusieurs adresses devient un piège tout seul.

Chaque adresse prise est écrite dans le journal des pièges, que lit une prison fail2ban : bannissement sur tous les ports.

Jamais pris : les réseaux privés, les adresses du serveur, la liste blanche de fail2ban, une adresse connectée à l'administration récemment, les robots des moteurs de recherche vérifiés par DNS. `/wp-admin` n'est jamais un piège.

L'administration montre les prises, les adresses bannies (débannissement en un clic), les appâts appris (à oublier au besoin), les chemins en observation, et permet une simulation sur tous les journaux sans rien bannir. Elle détecte fail2ban, ses actions et la prison installée, et donne les commandes root prêtes à coller. WordPress ne lance jamais de commande système.

== Installation ==

1. Extensions › Ajouter › Téléverser, puis activer.
2. Onglet « fail2ban et agent » : coller en root la commande 1 (agent et moteur), puis la commande 2 (prison fail2ban).
3. Onglets « Analyse des journaux » et « Appâts » : vérifier les journaux lus, les domaines, les chemins protégés, lancer une simulation.

Les versions suivantes arrivent par les mises à jour de WordPress, depuis www.1et2.com. Quand l'agent change, le tableau de bord le signale : relancer alors la commande 1.

== Frequently Asked Questions ==

= Puis-je mettre mon adresse en liste blanche ? =

Seulement si elle est fixe, ce qui est le cas chez certains fournisseurs (Free par exemple) et avec la plupart des offres professionnelles. Une adresse qui change régulièrement ne protège de rien une fois périmée. Le mieux reste un autre serveur à vous, depuis lequel vous pourrez vous connecter en SSH pour vous débannir. Une adresse qui a obtenu une page d'administration est de toute façon épargnée pendant le délai réglé.

= Et si je me bannis quand même ? =

Bouton « Débannir » du tableau de bord, depuis une autre connexion. Sinon en SSH depuis une adresse de la liste blanche : `fail2ban-client set <prison> unbanip <adresse>`, ou par la console de l'hébergeur.

= Pourquoi un mois de bannissement par défaut ? =

Les robots scannent souvent derrière des VPN : un long bannissement ne gêne guère qu'eux. La durée se règle de 10 minutes à 1 an.

== Changelog ==

= 2.6.1 =
* Correctif : l'enregistrement de l'onglet « fail2ban et agent » refusait le dossier de l'agent déjà en service quand il contenait l'ancien journal pieges.log des versions 1.x.

= 2.6.0 =
* Tant qu'une commande est à relancer sur le serveur, une icône d'alerte clignote à côté du menu Honeypot et dans l'en-tête de l'extension, et un point clignote sur l'onglet « fail2ban et agent ». Un clic mène directement à l'encadré qui explique quoi faire.

= 2.5.0 =
* Quand fail2ban applique encore d'anciens réglages, l'onglet « fail2ban et agent » l'annonce en tête : quelle commande relancer et pourquoi, avec le tableau des réglages appliqués sur le serveur face à ceux enregistrés. La commande concernée est marquée « à relancer », et les alertes du tableau de bord mènent directement à elle.

= 2.4.1 =
* « En observation » ne montre plus que les chemins qui peuvent encore devenir des appâts appris : ceux déjà piégés par un appât fixe ou personnel (/.env, /xmlrpc.php…), servis normalement par un site ou existants sur une racine web n'y figurent plus. Nouvel agent : relancer la commande 1.

= 2.4.0 =
* Carte du monde des adresses prises sur 14 jours : chaque pays coloré selon le nombre d'adresses, le nombre en gras sur le pays.
* Colonne et filtre « Pays » dans les prises et les adresses bannies.
* Pays tirés de la base gratuite DB-IP « IP to Country Lite », téléchargée chaque mois par l'agent et consultée sur le serveur. Nouvel agent : relancer la commande 1.

= 2.3.0 =
* Onglet Appâts rangé en sous-onglets : appâts fixes, appâts personnels, appâts appris, chemins en observation, chemins écartés.

= 2.2.0 =
* Mises à jour par WordPress, depuis www.1et2.com, comme pour une extension du répertoire officiel.
* Liens vers la documentation, le forum et le signalement de bugs dans la liste des extensions.
* Le tableau de bord signale un agent plus ancien que celui de l'extension.

= 2.1.0 =
* Nouvelle interface : en-tête avec l'état de l'agent, cartes d'état chiffrées, histogramme des prises sur 14 jours par motif, motifs et codes de réponse en couleur, commandes présentées en terminal.

= 2.0.1 =
* Liste blanche : l'adresse d'une box fixe y a sa place.

= 2.0.0 =
* Moteur des pots de miel dans l'agent root : appâts fixes « toujours » ou « sur échec », injections, rafales, appâts appris, administrateurs et robots vérifiés épargnés, lecture incrémentale des journaux avec suivi de la rotation.
* Une seule prison fail2ban, alimentée par le journal des pièges.
* Réglages du moteur, simulation, appâts appris et chemins en observation dans l'administration.
* Le piège PHP et la surveillance directe du journal d'accès par fail2ban sont retirés : le moteur voit tout, y compris ce qui n'atteint pas WordPress.
