InfraFenceInfraFence

Live Security Operations

Loslegen

Installation

Den InfraFence-Agenten unter Linux mit install.sh installieren: Voraussetzungen, jede Option des Installers, wo die Dateien landen und wie du neu installierst oder einen Server umziehst.

Zuletzt aktualisiert:

Der Agent läuft als Dienst auf dem Server: systemd, upstart oder sysvinit. Für Container siehe Docker und Kubernetes.

Voraussetzungen

  • Linux auf x86-64 (x86_64) oder ARM64 (aarch64). Bei jeder anderen Architektur bricht der Installer mit Unsupported architecture ab.
  • Root-Zugriff.
  • systemd, upstart oder sysvinit.
  • apt-get, dnf oder yum, um Fehlendes zu installieren: curl, iptables und ca-certificates. ipset wird ebenfalls installiert, wenn die rein lesende Prüfung sagt, dass das sicher ist.
  • Ausgehendes HTTPS zu infrafence.com, github.com und release-assets.githubusercontent.com: Der Agent wird nur aus seinen GitHub-Releases geladen.

Die Seite Unterstützte Distributionen listet die 15 Distributionen auf, auf denen jedes Release getestet wird.

Installieren

Erstelle im Dashboard ein Installations-Token (Server › Server hinzufügen), dann auf dem Server:

bash
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo bash -s -- --token <YOUR_TOKEN>

Der Installer stellt nie Fragen und funktioniert daher auch aus Provisioning-Skripten.

Optionen des Installers

Option Wirkung
--token <TOKEN> Das einmalig verwendbare Installations-Token aus dem Dashboard. Nötig für eine neue Registrierung.
--dry-run Probelauf: den Agenten herunterladen, die rein lesende Prüfung ausführen und ausgeben, was ein echter Lauf tun würde. Es wird nichts installiert oder geändert, und es braucht kein Token.
--no-ipset ipset nie installieren. Sperren funktionieren trotzdem, als eine Firewall-Regel pro Adresse (bis zu 500); Ländersperre und das Blockieren von Bedrohungslisten erkennen dann nur.
--install-only Programm und Dienst installieren, ohne zu registrieren. Der Dienst wird aktiviert, aber nicht gestartet; der Installer gibt den Befehl infrafence-agent register aus, den du später ausführst.
--force-register Erneut registrieren, auch wenn /etc/infrafence/config.json existiert, mit einem neuen Token.
--skip-checksum Installiert auch, wenn die Prüfsumme des Releases nicht geladen werden kann. Unsicher: Das Binary wird nicht geprüft. Ohne diese Option stoppt eine fehlende oder falsche Prüfsumme den Installer, und nichts wird installiert.
--uninstall Den Agenten und alles, was er hinzugefügt hat, entfernen. Siehe Deinstallation.

Der Installer liest außerdem diese Umgebungsvariablen:

Variable Standard Wirkung
INFRAFENCE_AGENT_NAME der kurze Hostname Der Name, den der Server im Dashboard bekommt.
INFRAFENCE_SERVER_URL https://infrafence.com Das Dashboard, bei dem sich der Agent registriert.

Übergib sie über sudo, zum Beispiel:

bash
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo INFRAFENCE_AGENT_NAME=web-01 bash -s -- --token <YOUR_TOKEN>

Wo die Dateien landen

Pfad Was
/usr/local/bin/infrafence-agent Das Programm des Agenten. Die vorherige Version bleibt nach einem Update als infrafence-agent.bak erhalten.
/etc/infrafence/config.json Adresse des Dashboards und das eigene Token des Agenten (Modus 0600, Verzeichnis 0750).
/var/lib/infrafence/ Zustand: Sperren, Whitelist, Ländersperren, geschlossene Ports, Dateien in Quarantäne.
/etc/systemd/system/infrafence-agent.service Die systemd-Unit (upstart: /etc/init/infrafence-agent.conf; sysvinit: /etc/init.d/infrafence-agent).
/usr/local/bin/infrafence-agent-recover.sh Läuft unter systemd vor jedem Start: Ist das Programm beschädigt, stellt das Skript die Sicherung wieder her oder lädt das Release erneut herunter und prüft dabei Prüfsumme und Signatur.

Der Agent protokolliert unter systemd ins Journal (journalctl -u infrafence-agent) und mit upstart oder sysvinit ins Syslog.

Erneut ausführen

Wird der Installer auf einem registrierten Server erneut ohne --token ausgeführt, aktualisiert er Programm und Dienst und behält die Registrierung:

bash
curl -fsSL https://github.com/infrafence/infrafence-agent/releases/latest/download/install.sh | sudo bash

Er gibt Existing config found at /etc/infrafence/config.json — keeping current registration aus. Um den Server mit einer anderen Organisation oder als neuen Server zu verbinden, verwende --force-register mit einem neuen Token.

Wenn etwas fehlschlägt

Der Installer erklärt jeden Fehler in einem Kasten mit dem nächsten Schritt: eine fehlende Abhängigkeit, ein fehlgeschlagener Download oder eine fehlgeschlagene Registrierung (Invalid or expired install token, Server URL is unreachable, Server limit reached for your plan). Siehe Fehlerbehebung.