InfraFenceInfraFence

Live Security Operations

Loslegen

Befehlsreferenz

Jeder Befehl des Programms infrafence-agent: preflight, version, check, register, start, uninstall --clean und die panel-Befehle, die das WHM-Plugin und die Plesk-Erweiterung nutzen.

Zuletzt aktualisiert:

Das Programm des Agenten ist /usr/local/bin/infrafence-agent. Führe seine Befehle als root aus.

preflight

bash
sudo infrafence-agent preflight
sudo infrafence-agent preflight --json

Die rein lesende Prüfung des Servers: Firewall, andere Sicherheitstools, Webserver, Hosting-Panels, Konfigurationsmanagement, Paketvorgänge und Ressourcen. Sie ändert nichts. Ohne --json endet sie mit Status 2, wenn ein Befund den Schutz verhindert, sonst mit 0. Siehe Was der Installer macht.

version

bash
infrafence-agent version

Gibt die installierte Version aus, infrafence-agent v<version>. --version und -v tun dasselbe. Braucht den Agenten 1.0.34 oder neuer; bei einem älteren Agenten gibt auch infrafence-agent check die Version aus.

check

bash
infrafence-agent check

Der Selbsttest, den Updates und das Wiederherstellungsskript verwenden: Er gibt infrafence-agent v<version> OK aus und endet mit 0.

register

bash
sudo infrafence-agent register <server_url> <agent_name> <install_token>

Registriert den Server und schreibt /etc/infrafence/config.json. Der Installer führt ihn für dich aus; du brauchst ihn nur nach install.sh --install-only, zum Beispiel:

bash
sudo infrafence-agent register https://infrafence.com web-01 <YOUR_TOKEN>
sudo systemctl start infrafence-agent

Bei Erfolg gibt er Agent registered successfully aus; bei einem Fehler Registration failed:, gefolgt von der Antwort des Dashboards.

start

bash
infrafence-agent start

Startet den Agenten im Vordergrund. Der Dienst führt diesen Befehl aus; von Hand brauchst du ihn nicht. Ohne Konfigurationsdatei bricht er mit Run 'infrafence-agent register' first. ab.

uninstall --clean

bash
sudo infrafence-agent uninstall --clean

Entfernt alles, was der Agent dem System hinzugefügt hat (Firewall-Chains und -Sets, Änderungen an Webserver und Härtung), und gibt pro Element eine Zeile removed … aus, danach InfraFence changes removed from this host. Binary und Dienst entfernt er nicht: Das alles erledigt install.sh --uninstall. Siehe Deinstallation.

panel

bash
sudo infrafence-agent panel status --json

Die Schnittstelle der Plugins für Hosting-Panels: ein JSON-Objekt auf der Standardausgabe, {"ok": true, …} oder {"ok": false, "error": "<code>", "message": "…"}, und Exit-Status 0 nur bei ok. Nur für root.

Befehl Was er tut
status Version, Laufzustand, letzter Heartbeat, Verbindung, Tarif, AutoMode, und ob das Plugin Daten zeigen darf (entitled, entitlement).
bans [--limit N] Aktive Sperren mit Grund, Quelle und Ablauf.
unban <ip> --actor <user> Hebt eine Sperre nur auf diesem Server auf, für höchstens 30 Tage.
allow <ip> [--note …] --actor <user> Fügt eine Adresse zur Whitelist hinzu.
allowlist Die Whitelist, aus dem Panel und aus dem Dashboard.
disallow <ip> --actor <user> Entfernt eine Adresse, die das Panel hinzugefügt hat.
findings [--limit N] Funde zu Malware und Dateiintegrität, jeweils offen oder behoben.
events [--limit N] [--since 24h] Aktuelle Ereignisse; Probleme offen oder behoben.
coexistence Gefundene andere Sicherheitstools und was InfraFence neben jedem tut.
sites Konten, Domains und Document Roots, mit Scan-Abdeckung.
scan <document root> --actor <user> Startet einen Malware-Scan einer Website.
map [--hours N] Woher die Angriffe auf diesen Server kamen, nach Land und Angriffsart, über die letzten 24 Stunden (--hours 24, Standard) oder 7 Tage (--hours 168).
score Der Sicherheitswert des Servers, seine Note, was Punkte abzieht und der Verlauf über 30 Tage.

Die Befehle, die etwas ändern, brauchen --actor, und der Agent meldet sie dem Dashboard als Ereignisse mit der Quelle panel. Der Befehl spricht mit dem laufenden Agenten über /run/infrafence/panel.sock (nur root, Modus 0600, kein Netzwerk-Listener). Ohne laufenden Agenten antworten status, coexistence und sites trotzdem; die anderen geben agent_not_running zurück. Siehe Hosting-Panels.

map und score brauchen den Agenten 1.0.33 oder neuer. Das Dashboard berechnet sie; der Agent fragt dort höchstens alle 5 Minuten nach einer Karte und alle 15 Minuten nach dem Wert und behält die Antwort. Antwortet das Dashboard nicht, gibt der Agent seine letzte Kopie mit "stale": true zurück, oder not_connected, wenn er keine hat.

Nur bezahlte Tarife (Agent 1.0.34 oder neuer). Die Plugins sind in den Tarifen Basic, Pro und AutoMode enthalten. status antwortet immer, mit entitled (true oder false) und entitlement:

entitlement Wann
ok Der Tarif ist Basic, Pro oder AutoMode, und der Schutz ist nicht abgeschaltet.
plan_required Ein anderer Tarif, etwa Starter.
unpaid Der Schutz ist abgeschaltet: Das Dashboard hat den Server 24 Stunden lang abgewiesen, zum Beispiel weil das Abonnement nicht aktiv ist.
unknown Der Tarif ist noch nicht bekannt: Der Agent hat seit der Installation oder dem Update noch nicht synchronisiert.

Ist er nicht ok, antwortet jeder andere Befehl nur mit einem Fehler mit demselben Code (plan_required, unpaid oder unknown), ohne Daten, und ändert nichts: unban, allow, disallow und scan werden abgelehnt. Der Agent behält den Tarif der letzten erfolgreichen Synchronisierung auch über Neustarts hinweg und nutzt ihn, solange das Dashboard nicht erreichbar ist: Ein Ausfall leert das Plugin also nicht. Die Prüfung gilt nur für die Antworten: Sie ändert nie den Schutz des Servers.

Offen oder behoben (Agent 1.0.34 oder neuer). In events und findings hat jedes Problem (ein offener Datenbank-Port, eine geänderte Systemdatei, eine riskante PHP-Einstellung, Malware...) ein subject, den Schlüssel dessen, worum es geht (port:tcp/3306, file:/etc/passwd...), und einen state, open oder resolved, mit resolved_at und resolved_how (port_closed, fix_applied, quarantined, package_updated, marked_expected, marked_resolved...). Ereignisse, die keine Probleme sind, etwa Angriffe und Scans, haben state null. Ein Problem wird im Dashboard behoben, oder vom Agenten selbst, wenn er es in Ordnung gebracht hat; ein neues Auftreten ist wieder offen. Siehe Offene und behobene Probleme.