WHM-Plugin

Das Plugin erscheint unter WHM » Plugins » InfraFence. Es ist in den Tarifen Basic, Pro und AutoMode enthalten und wird aus deinem Dashboard installiert. Mit Starter oder nach dem 72-Stunden-Stopp bei einer fehlgeschlagenen Zahlung zeigt es keine Daten, bis ein bezahlter Tarif aktiv ist. Siehe Tarife. Die aktuelle Version ist 1.0.2.

Voraussetzungen#

• Eine InfraFence-Organisation mit Basic, Pro oder AutoMode und der InfraFence-Agent auf dem Server (das Plugin lässt sich auch ohne ihn installieren und zeigt dann, wie du den Server hinzufügst).
• cPanel & WHM 11.110 oder neuer, als root.
• Für die Angriffskarte und den Sicherheitswert in der Übersicht: Agent 1.0.33 oder neuer. Mit einem älteren Agenten funktioniert alles andere, und die Übersicht sagt, dass du den Agenten aktualisieren sollst.
• Für offene und behobene Probleme: Agent 1.0.34 oder neuer und Plugin 1.0.2. Mit einem älteren Agenten zählt jedes Ereignis wie bisher als offen.
• Für den Update-Hinweis: Agent 1.0.35 oder neuer und Plugin 1.0.3. Mit einem älteren Agenten zeigt das Plugin keinen Hinweis; die Technischen Details zeigen trotzdem beide Versionen.

Installation#

1. Öffne im Dashboard Panel-Plugins › cPanel & WHM.
2. Wähle das System des Servers und kopiere den Installationsbefehl:
   • RPM für AlmaLinux 8, 9 und 10, CloudLinux und Rocky (dnf install, oder yum install, wo es kein dnf gibt);
   • .deb für Ubuntu 24.04 (apt install);
   • Tarball, entpackt und mit ./install.sh installiert.
3. Führe ihn als root auf dem Server aus.

Der Befehl lädt das Paket und die SHA256SUMS des Releases über einen Link herunter, der eine Stunde gilt, prüft das Paket mit sha256sum -c und installiert es nur, wenn die Prüfsumme stimmt. Ist der Link abgelaufen, gibt dir Neuer Link auf derselben Seite einen frischen Befehl.

Der Installer prüft zuerst den Server (cPanel-Version, root, freier Speicherplatz, die von WHM bereitgestellten Perl-Module): Schlägt eine Prüfung fehl, wird nichts geändert. Beim Tarball führt ./install.sh --check nur die Prüfungen aus. Dienste werden nie neu gestartet. Ein erneuter Lauf ersetzt das Plugin an Ort und Stelle; so aktualisierst du es auch, siehe Plugin aktualisieren.

Plugin aktualisieren#

Das Plugin aktualisierst du im Dashboard, getrennt vom Agenten: Ein Update des Agenten, von Hand oder automatisch, aktualisiert nie das Plugin. Agent und Plugin haben verschiedene Versionsnummern: Die Technischen Details der Übersicht zeigen beide, Agent-Version und Plugin-Version.

So aktualisierst du das Plugin:

1. Öffne im Dashboard Panel-Plugins › cPanel & WHM.
2. Kopiere einen neuen Installationsbefehl für das System des Servers. Der Link darin gilt eine Stunde; Neuer Link gibt dir einen neuen.
3. Führe ihn auf dem Server als root aus. Er prüft das Paket und ersetzt das Plugin an Ort und Stelle; die Sprachwahl jedes WHM-Benutzers bleibt erhalten, und kein Dienst wird neu gestartet.

Wenn ein Update verfügbar ist (Agent 1.0.35 oder neuer, Plugin 1.0.3 oder neuer): Der Agent liest die Version des installierten Plugins (nur lesend, aus /usr/local/share/infrafence-whm/VERSION) und meldet sie dem Dashboard, und das Dashboard schickt dem Agenten die neueste Version. Dann:

• zeigt in WHM jeder Bildschirm des Plugins Eine neue Version des Plugins ist verfügbar (1.0.4). Aktualisiere es im InfraFence-Dashboard › Panel-Plugins, und Plugin-Version zeigt 1.0.4 verfügbar;
• zeigt im Dashboard die Seite des Servers WHM-Plugin 1.0.3 — Update verfügbar (1.0.4) mit Plugin aktualisieren, und der Server hat unter Server das Badge WHM-Plugin-Update. Ist das Plugin aktuell, zeigt die Seite des Servers WHM-Plugin 1.0.4 — aktuell.

Hinweis und Button erscheinen nur in den Tarifen, die das Plugin enthalten.

Die Übersicht#

Die Übersicht sagt zuerst, ob mit dem Server alles in Ordnung ist:

• Auf einen Blick: der Schutzstatus, der Sicherheitswert von 100 mit seiner Note und eine Zeile, die sagt, ob etwas deine Aufmerksamkeit braucht. In InfraFence öffnen öffnet den Server im Dashboard.
• Die wichtigsten Zahlen: Angriffe und kritische Ereignisse der letzten 24 Stunden, aktive Sperren, zu prüfende Funde.
• Braucht deine Aufmerksamkeit: die kritischen Ereignisse der letzten 24 Stunden und was Punkte vom Sicherheitswert abzieht, mit seiner Entwicklung über 30 Tage und In InfraFence beheben.
• Woher die Angriffe kamen: eine Weltkarte der Länder, aus denen die Angriffe auf diesen Server kamen, über 24 Std. oder 7 Tage, mit den häufigsten Quellen und den Angriffsarten. Pro Land gezählt: Es werden keine Adressen gezeigt.
• Technische Details: Agent-Version und Plugin-Version, Dienst, letzter Heartbeat und letzte Synchronisierung, Verbindung, Server-ID, Hosting-Panel, Tarif, Modus und AutoMode.

Behobene Probleme (Agent 1.0.34 oder neuer): Ein Problem, das im Dashboard oder vom Agenten behoben wurde, etwa ein geschlossener Datenbank-Port oder eine Datei in Quarantäne, zählt nicht mehr in den wichtigsten Zahlen, bei den kritischen Ereignissen oder unter Braucht deine Aufmerksamkeit. Unter den offenen listet die Übersicht die drei zuletzt behobenen Probleme der letzten 24 Stunden, jedes mit einer grünen Zeile, die sagt, wie und wann, zum Beispiel Behoben · Port geschlossen · 10:50 UTC; Behobene anzeigen (N) öffnet die übrigen auf der Seite Ereignisse. Ist alles aus den letzten 24 Stunden behoben, steht dort Nichts offen: Die Probleme der letzten 24 Stunden sind behoben.

Das Dashboard berechnet Karte und Wert aus den Meldungen dieses Servers. Das Plugin fragt den Agenten danach (panel map und panel score); der Agent holt sie vom Dashboard und behält eine Kopie, und er fragt höchstens alle 5 Minuten nach der Karte und alle 15 Minuten nach dem Wert. Ist das Dashboard nicht erreichbar, zeigt die Übersicht die letzte Kopie und wann sie entstand. Das Plugin selbst speichert weiterhin kein Token und sendet keine Anfrage an andere Websites: Die Karte wird auf dem Server gezeichnet und braucht kein JavaScript.

Ereignisse hat eine Spalte Zustand: Offen, Behoben mit wie und wann, oder ein Strich bei Ereignissen, die keine Probleme sind, etwa Angriffe und Scans. Die Seite filtert nach Zustand, Alle, Offen oder Behoben, und nach Schweregrad, Alle, Ab Warnung oder Kritisch. Funde markiert einen behobenen Fund mit einem grünen Label Behoben, wie und wann.

Tarife#

Das Plugin zeigt nur Daten, wenn die Organisation Basic, Pro oder AutoMode hat und der Schutz an ist. Sonst sagt jeder Bildschirm oben, warum, mit allen Zahlen auf 0, leeren Listen, ohne Karte und ohne Wert, und die Aktionen sind aus:

Das Plugin liest den Tarif aus panel status des Agenten (ab Agent 1.0.34 aus dem entitlement des Agenten selbst), fragt den Agenten danach nichts weiter und lehnt jede Aktion ab, bevor sie den Agenten erreicht. Das ändert nie den Schutz des Servers. Der Agent behält den zuletzt erhaltenen Tarif, sodass ein Ausfall des Dashboards das Plugin nicht leert.

Was es installiert#

Alles gehört root und ist nur für root beschreibbar.

Wer es öffnen darf#

Nur root (und WHM-Benutzer mit dem Recht all). Reseller und cPanel-Benutzer sehen es nie: Die Daten des Agenten umfassen den ganzen Server. Das Plugin folgt der Sprache von WHM: Englisch, Italienisch, Spanisch, Französisch, Deutsch oder Portugiesisch. Jeder WHM-Benutzer kann oben im Plugin unter Sprache eine andere wählen; Wie WHM kehrt zur Sprache von WHM zurück. Die Wahl wird pro WHM-Benutzer gespeichert und ist nur für root lesbar.

Sicherheit#

• Jede Änderung zeigt zuerst eine Bestätigungsseite und läuft nur mit dem Sicherheitstoken der WHM-Sitzung.
• Der Agent wird direkt ausgeführt, ohne Shell, mit sauberer Umgebung und Zeitlimit; sein Binary muss root gehören.
• In InfraFence öffnen öffnet das Dashboard, ohne einen Referrer zu senden.
• Das Plugin speichert kein InfraFence-Token und öffnet keine Netzwerkverbindung: Der Agent antwortet ihm über einen lokalen Socket und holt Karte und Wert selbst vom Dashboard.

Entfernen#

dnf remove infrafence-whm

apt remove infrafence-whm

Bei der Tarball-Installation: /usr/local/share/infrafence-whm/uninstall.sh (--check zeigt, was entfernt würde). Das Entfernen des Plugins tastet den Agenten nie an.