Plugin WHM

Il plugin compare in WHM » Plugins » InfraFence. È incluso nei piani Basic, Pro e AutoMode e si installa dalla tua dashboard. Con Starter, o dopo lo stop di 72 ore quando un pagamento non va a buon fine, non mostra dati finché un piano a pagamento non è attivo. Vedi Piani. La versione attuale è la 1.0.2.

Requisiti#

• Un'organizzazione InfraFence con Basic, Pro o AutoMode e l'agente InfraFence sul server (il plugin si installa anche senza, e in quel caso mostra come aggiungere il server).
• cPanel & WHM 11.110 o successivo, come root.
• Per la mappa degli attacchi e il punteggio di sicurezza nella Panoramica: l'agente 1.0.33 o successivo. Con un agente più vecchio tutto il resto funziona, e la Panoramica dice di aggiornare l'agente.
• Per i problemi aperti e risolti: l'agente 1.0.34 o successivo e il plugin 1.0.2. Con un agente più vecchio ogni evento conta come aperto, come prima.
• Per l'avviso di aggiornamento: l'agente 1.0.35 o successivo e il plugin 1.0.3. Con un agente più vecchio il plugin non mostra l'avviso; i Dettagli tecnici mostrano comunque entrambe le versioni.

Installazione#

1. Nella dashboard, apri Plugin dei pannelli › cPanel & WHM.
2. Scegli il sistema del server e copia il comando di installazione:
   • RPM per AlmaLinux 8, 9 e 10, CloudLinux e Rocky (dnf install, oppure yum install dove non c'è dnf);
   • .deb per Ubuntu 24.04 (apt install);
   • Tarball, estratto e installato con ./install.sh.
3. Eseguilo sul server come root.

Il comando scarica il pacchetto e il file SHA256SUMS della release con un link valido per un'ora, verifica il pacchetto con sha256sum -c e lo installa solo se il checksum corrisponde. Quando il link è scaduto, Nuovo link nella stessa pagina ti dà un comando nuovo.

L'installer controlla prima il server (versione di cPanel, root, spazio libero, i moduli Perl forniti da WHM): se un controllo fallisce, non viene cambiato nulla. Con il tarball, ./install.sh --check esegue solo i controlli. I servizi non vengono mai riavviati. Rieseguirlo sostituisce il plugin al suo posto, ed è anche il modo per aggiornarlo: vedi Aggiornare il plugin.

Aggiornare il plugin#

Il plugin si aggiorna dalla dashboard, separatamente dall'agente: aggiornare l'agente, a mano o in automatico, non aggiorna mai il plugin. La versione dell'agente e quella del plugin sono numeri diversi: i Dettagli tecnici della Panoramica li mostrano entrambi, Versione dell'agente e Versione del plugin.

Per aggiornare il plugin:

1. Nella dashboard, apri Plugin dei pannelli › cPanel & WHM.
2. Copia un nuovo comando di installazione per il sistema del server. Il link che contiene vale un'ora; Nuovo link ne dà un altro.
3. Eseguilo sul server come root. Controlla il pacchetto e sostituisce il plugin al suo posto; la lingua scelta da ogni utente WHM resta, e nessun servizio viene riavviato.

Quando c'è un aggiornamento (agente 1.0.35 o successivo, plugin 1.0.3 o successivo): l'agente legge la versione del plugin installato (in sola lettura, da /usr/local/share/infrafence-whm/VERSION) e la comunica alla dashboard, e la dashboard invia all'agente l'ultima versione pubblicata. Allora:

• in WHM, ogni schermata del plugin mostra È disponibile una nuova versione del plugin (1.0.4). Aggiornalo dalla dashboard di InfraFence › Plugin dei pannelli, e Versione del plugin dice 1.0.4 disponibile;
• nella dashboard, la pagina del server dice Plugin per WHM 1.0.3 — aggiornamento disponibile (1.0.4) con Aggiorna il plugin, e in Server il server ha il badge Aggiornamento plugin WHM. Quando il plugin è aggiornato, la pagina del server dice Plugin per WHM 1.0.4 — aggiornato.

L'avviso e il pulsante compaiono solo con i piani che includono il plugin.

La Panoramica#

La Panoramica dice prima di tutto se il server sta bene:

• A colpo d'occhio: lo stato della protezione, il punteggio di sicurezza su 100 con il suo voto, e una riga che dice se qualcosa richiede la tua attenzione. Apri in InfraFence apre il server nella dashboard.
• I numeri chiave: attacchi ed eventi critici nelle ultime 24 ore, ban attivi, rilevamenti da controllare.
• Da guardare: gli eventi critici delle ultime 24 ore, e cosa toglie punti al punteggio di sicurezza, con la variazione in 30 giorni e Correggi in InfraFence.
• Da dove arrivano gli attacchi: una mappa del mondo con i paesi da cui sono arrivati gli attacchi a questo server, nelle ultime 24 h o negli ultimi 7 giorni, con le principali origini e i tipi di attacco. Conteggi per paese: nessun indirizzo viene mostrato.
• Dettagli tecnici: versione dell'agente e versione del plugin, servizio, ultimo heartbeat e ultima sincronizzazione, connessione, ID del server, pannello di hosting, piano, modalità e AutoMode.

Problemi risolti (agente 1.0.34 o successivo): un problema risolto nella dashboard o dall'agente, per esempio una porta di database chiusa o un file messo in quarantena, non conta più nei numeri chiave, negli eventi critici né in Da guardare. Sotto quelli aperti, la Panoramica elenca i tre problemi risolti più di recente nelle ultime 24 ore, ognuno con una riga verde che dice come e quando, per esempio Risolto · porta chiusa · 10:50 UTC; Mostra risolti (N) apre gli altri nella pagina Eventi. Quando tutto quello delle ultime 24 ore è risolto, dice Niente di aperto: i problemi delle ultime 24 ore sono risolti.

La mappa e il punteggio li calcola la dashboard dai report di questo server. Il plugin li chiede all'agente (panel map e panel score); l'agente li prende dalla dashboard e ne tiene una copia, chiedendo al massimo ogni 5 minuti la mappa e ogni 15 minuti il punteggio. Quando la dashboard non è raggiungibile, la Panoramica mostra l'ultima copia e quando è stata fatta. Il plugin continua a non contenere alcun token e non fa richieste ad altri siti: la mappa viene disegnata sul server e non richiede JavaScript.

Eventi ha una colonna Stato: Aperto, Risolto con come e quando, oppure un trattino per gli eventi che non sono problemi, come attacchi e scansioni. Filtra per stato, Tutti, Aperti o Risolti, e per gravità, Tutti, Avvisi e oltre o Critici. Rilevamenti segna un rilevamento risolto con un'etichetta verde Risolto, come e quando.

Piani#

Il plugin mostra dati solo quando l'organizzazione è su Basic, Pro o AutoMode e la protezione è attiva. Altrimenti ogni schermata dice in alto il perché, con tutti i numeri a 0, elenchi vuoti, niente mappa e niente punteggio, e le azioni disattivate:

Il plugin legge il piano da panel status dell'agente (con l'agente 1.0.34 o successivo, dall'entitlement dell'agente stesso), poi non chiede altro all'agente e rifiuta ogni azione prima che arrivi all'agente. Questo non cambia mai la protezione del server. L'agente tiene l'ultimo piano ricevuto, così un'interruzione della dashboard non svuota il plugin.

Cosa installa#

Tutto appartiene a root ed è scrivibile solo da root.

Chi può aprirlo#

Solo root (e gli utenti WHM con il privilegio all). Reseller e utenti cPanel non lo vedono mai: i dati dell'agente riguardano l'intero server. Il plugin segue la lingua di WHM: inglese, italiano, spagnolo, francese, tedesco o portoghese. Ogni utente WHM può sceglierne un'altra con Lingua in cima al plugin; Come WHM torna a quella di WHM. La scelta è salvata per utente WHM, leggibile solo da root.

Sicurezza#

• Ogni modifica mostra prima una pagina di conferma e viene eseguita solo con il token di sicurezza della sessione WHM.
• L'agente viene eseguito direttamente, senza shell, con un ambiente pulito e un limite di tempo; il suo binario deve appartenere a root.
• Apri in InfraFence apre la dashboard senza inviare il referrer.
• Il plugin non contiene alcun token InfraFence e non apre connessioni di rete: l'agente gli risponde su un socket locale, e prende lui dalla dashboard la mappa e il punteggio.

Rimozione#

dnf remove infrafence-whm

apt remove infrafence-whm

Per l'installazione da tarball: /usr/local/share/infrafence-whm/uninstall.sh (--check mostra cosa rimuoverebbe). Rimuovere il plugin non tocca mai l'agente.