Plugin WHM

Le plugin apparaît dans WHM » Plugins » InfraFence. Il est inclus dans les offres Basic, Pro et AutoMode et s'installe depuis votre tableau de bord. En Starter, ou après l'arrêt de 72 heures quand un paiement échoue, il n'affiche aucune donnée tant qu'une offre payante n'est pas active. Voir Offres. La version actuelle est la 1.0.2.

Prérequis#

• Une organisation InfraFence en Basic, Pro ou AutoMode, et l'agent InfraFence sur le serveur (le plugin s'installe sans lui, et indique alors comment ajouter le serveur).
• cPanel & WHM 11.110 ou plus récent, en root.
• Pour la carte des attaques et le score de sécurité de la Vue d'ensemble : l'agent 1.0.33 ou plus récent. Avec un agent plus ancien tout le reste fonctionne, et la Vue d'ensemble indique de mettre l'agent à jour.
• Pour les problèmes ouverts et résolus : l'agent 1.0.34 ou plus récent et le plugin 1.0.2. Avec un agent plus ancien, tous les événements comptent comme ouverts, comme avant.
• Pour l'avis de mise à jour : l'agent 1.0.35 ou plus récent et le plugin 1.0.3. Avec un agent plus ancien, le plugin n'affiche pas l'avis ; les Détails techniques montrent quand même les deux versions.

Installation#

1. Dans le tableau de bord, ouvrez Plugins de panneaux › cPanel & WHM.
2. Choisissez le système du serveur et copiez la commande d'installation :
   • RPM pour AlmaLinux 8, 9 et 10, CloudLinux et Rocky (dnf install, ou yum install là où dnf n'existe pas) ;
   • .deb pour Ubuntu 24.04 (apt install) ;
   • Archive tar, décompressée puis installée avec ./install.sh.
3. Lancez-la sur le serveur, en root.

La commande télécharge le paquet et le SHA256SUMS de la version avec un lien valable une heure, vérifie le paquet avec sha256sum -c, et ne l'installe que si la somme de contrôle correspond. Quand le lien a expiré, Nouveau lien sur la même page donne une nouvelle commande.

L'installateur vérifie d'abord le serveur (version de cPanel, root, espace libre, les modules Perl fournis par WHM) : si une vérification échoue, rien n'est modifié. Avec l'archive tar, ./install.sh --check se contente de lancer les vérifications. Les services ne sont jamais redémarrés. Le relancer remplace le plugin sur place, et c'est aussi ainsi qu'on le met à jour : voir Mettre à jour le plugin.

Mettre à jour le plugin#

Le plugin se met à jour depuis le tableau de bord, séparément de l'agent : mettre à jour l'agent, à la main ou automatiquement, ne met jamais à jour le plugin. La version de l'agent et celle du plugin sont des numéros différents : les Détails techniques de la Vue d'ensemble affichent les deux, Version de l'agent et Version du plugin.

Pour mettre à jour le plugin :

1. Dans le tableau de bord, ouvrez Plugins de panneaux › cPanel & WHM.
2. Copiez une nouvelle commande d'installation pour le système du serveur. Le lien qu'elle contient fonctionne pendant une heure ; Nouveau lien en donne un autre.
3. Lancez-la sur le serveur en root. Elle vérifie le paquet et remplace le plugin sur place ; la langue choisie par chaque utilisateur WHM est conservée, et aucun service n'est redémarré.

Quand une mise à jour est disponible (agent 1.0.35 ou plus récent, plugin 1.0.3 ou plus récent) : l'agent lit la version du plugin installé (en lecture seule, dans /usr/local/share/infrafence-whm/VERSION) et la remonte au tableau de bord, qui envoie à l'agent la dernière version publiée. Alors :

• dans WHM, chaque écran du plugin affiche Une nouvelle version du plugin est disponible (1.0.4). Mettez-le à jour depuis le tableau de bord InfraFence › Plugins de panneaux, et Version du plugin indique 1.0.4 disponible ;
• dans le tableau de bord, la page du serveur indique Plugin WHM 1.0.3 — mise à jour disponible (1.0.4) avec Mettre à jour le plugin, et le serveur porte le badge Mise à jour du plugin WHM dans Serveurs. Quand le plugin est à jour, la page du serveur indique Plugin WHM 1.0.4 — à jour.

L'avis et le bouton n'apparaissent qu'avec les offres qui incluent le plugin.

La Vue d'ensemble#

La Vue d'ensemble dit d'abord si le serveur va bien :

• En un coup d'œil : l'état de la protection, le score de sécurité sur 100 avec sa note, et une ligne qui dit si quelque chose demande votre attention. Ouvrir dans InfraFence ouvre le serveur dans le tableau de bord.
• Les chiffres clés : attaques et événements critiques des dernières 24 heures, bannissements actifs, détections à examiner.
• À traiter : les événements critiques des dernières 24 heures, et ce qui retire des points au score de sécurité, avec son évolution sur 30 jours et Corriger dans InfraFence.
• D'où viennent les attaques : une carte du monde des pays d'où sont venues les attaques contre ce serveur, sur 24 h ou 7 jours, avec les principales sources et les types d'attaque. Comptés par pays : aucune adresse n'est affichée.
• Détails techniques : version de l'agent et version du plugin, service, dernier heartbeat et dernière synchronisation, connexion, ID du serveur, panneau d'hébergement, offre, mode et AutoMode.

Problèmes résolus (agent 1.0.34 ou plus récent) : un problème résolu dans le tableau de bord ou par l'agent, par exemple un port de base de données fermé ou un fichier mis en quarantaine, ne compte plus dans les chiffres clés, dans les événements critiques ni dans À traiter. Sous les problèmes ouverts, la Vue d'ensemble liste les trois problèmes résolus le plus récemment dans les dernières 24 heures, chacun avec une ligne verte qui dit comment et quand, par exemple Résolu · port fermé · 10:50 UTC ; Afficher les résolus (N) ouvre les autres sur la page Événements. Quand tout ce qui concerne les dernières 24 heures est résolu, elle affiche Rien d'ouvert : les problèmes des dernières 24 heures sont résolus.

Le tableau de bord calcule la carte et le score à partir des rapports de ce serveur. Le plugin les demande à l'agent (panel map et panel score) ; l'agent les récupère auprès du tableau de bord et en garde une copie, en demandant au plus toutes les 5 minutes la carte et toutes les 15 minutes le score. Quand le tableau de bord est injoignable, la Vue d'ensemble affiche la dernière copie et sa date. Le plugin lui-même ne détient toujours aucun jeton et n'envoie aucune requête à un autre site : la carte est dessinée sur le serveur et ne demande pas de JavaScript.

Événements a une colonne État : Ouvert, Résolu avec comment et quand, ou un tiret pour les événements qui ne sont pas des problèmes, comme les attaques et les scans. La page filtre par état, Tous, Ouverts ou Résolus, et par gravité, Tous, Avertissement et plus ou Critiques. Détections signale une détection résolue avec une étiquette verte Résolu, comment et quand.

Offres#

Le plugin n'affiche des données que lorsque l'organisation est en Basic, Pro ou AutoMode et que la protection est active. Sinon, chaque écran indique pourquoi en haut, avec tous les chiffres à 0, des listes vides, ni carte ni score, et les actions désactivées :

Le plugin lit l'offre dans panel status de l'agent (avec l'agent 1.0.34 ou plus récent, dans l'entitlement de l'agent lui-même), puis ne demande plus rien à l'agent et refuse toute action avant qu'elle ne lui parvienne. Cela ne change jamais la protection du serveur. L'agent garde la dernière offre reçue : une panne du tableau de bord ne vide donc pas le plugin.

Ce qu'il installe#

Le tout appartient à root et n'est modifiable que par root.

Qui peut l'ouvrir#

Root uniquement (et les utilisateurs WHM qui ont le privilège all). Les revendeurs et les utilisateurs cPanel ne le voient jamais : les données de l'agent couvrent tout le serveur. Le plugin suit la langue de WHM : anglais, italien, espagnol, français, allemand ou portugais. Chaque utilisateur WHM peut en choisir une autre avec Langue en haut du plugin ; Comme WHM revient à celle de WHM. Le choix est enregistré par utilisateur WHM, lisible par root uniquement.

Sécurité#

• Chaque modification affiche d'abord une page de confirmation et ne s'exécute qu'avec le jeton de sécurité de session de WHM.
• L'agent est lancé directement, sans shell, avec un environnement vierge et une limite de temps ; son binaire doit appartenir à root.
• Ouvrir dans InfraFence ouvre le tableau de bord sans envoyer de referrer.
• Le plugin ne détient aucun jeton InfraFence et n'ouvre aucune connexion réseau : l'agent lui répond via un socket local, et c'est l'agent qui récupère la carte et le score auprès du tableau de bord.

Désinstallation#

dnf remove infrafence-whm

apt remove infrafence-whm

Pour une installation depuis l'archive tar : /usr/local/share/infrafence-whm/uninstall.sh (--check montre ce qu'il retirerait). Retirer le plugin ne touche jamais à l'agent.