Spip Netzwerksensor geschrieben in Go
Spip ist ein Low-Interaction-Netzwerk-Honeypot-Sensor für Linux, geschrieben in Go. Er nimmt TCP-Verbindungen auf jedem Port an, den der Host an ihn weiterleitet, unverschlüsselt oder per TLS, antwortet gerade genug, damit ein Client seine nächste Nachricht sendet, und schreibt jeden Austausch als einen JSON-Datensatz mit ECS-Feldnamen, bereit für ein SIEM oder einen Data Lake. Die optionale UDP-Erfassung zeichnet Datagramme auf und beantwortet sie nie.
HoneyLabs betreibt Spip, um die auf honeylabs.net veröffentlichten Daten zu sammeln.
Voraussetzungen:
iptables und Root-Zugriff, um die Weiterleitungsregeln zu installierengit clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
Um die in observer.version und agent.version gemeldete Version festzulegen (Standard dev), fügen Sie -ldflags "-X main.version=v1.2.3" hinzu.
sudo ./scripts/initial_setup.sh
Siehe Initial setup helper unten.
config.toml
Minimales config.toml:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
Optionale Konfigurationsschlüssel:
cert_path / key_path: aktiviert TLS, wenn beide gesetzt sind. Relative Pfade werden relativ zum Verzeichnis der Konfigurationsdatei aufgelöst.log_file: hängt Datensätze an diese Datei an, statt an stdout. Siehe Logausgabe unten.[loom]: versendet Datensätze zusätzlich über HTTP. Siehe Loom unten.read_timeout_seconds / write_timeout_seconds: Leerlauf-Lese-Timeout und Schreib-Timeout pro Verbindung.rate_limit_per_second / rate_limit_burst: Ratenbegrenzung für neue TCP-Verbindungen, gemeinsam für alle Quellen. Eine Verbindung über dem Limit wird ungelesen geschlossen.community_id_seed: optionaler 16-Bit-Seed für das Community-ID-v1-Flow-Hashing (weglassen oder 0 für den Standard).capture_client_hello: auf false setzen, um tls.client.hello_hex auszulassen. Siehe Fingerprinting.ignore_sources: Adressen oder Netzwerke, deren Verbindungen und Datagramme geschlossen oder verworfen werden, bevor irgendetwas gelesen wird, sodass sie niemals protokolliert, gefingerprintet oder versendet werden. Einzelne Adressen und CIDR, IPv4 oder IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. Ein Honeypot auf einem gemieteten Host wird vom eigenen Monitoring dieses Hosts abgefragt, und das Zählen dieser Abfragen verfälscht Port-Rankings und Scanner-Zählungen. Ein Eintrag, der nicht geparst werden kann, verhindert den Start des Agenten, da ein Tippfehler hier stillschweigend Traffic aufzeichnen würde, von dem Sie glauben, dass er verworfen wird. Verworfene Verbindungen werden pro Quelle gezählt und stündlich sowie beim Herunterfahren im Log gemeldet.udp_enabled und die udp_*-Schlüssel: siehe UDP-Erfassung.Wenn diese Laufzeit-Tuning-Felder weggelassen oder auf 0 gesetzt werden, wendet Spip die folgenden Standardwerte an:
read_timeout_seconds: 30write_timeout_seconds: 10rate_limit_per_second: 20rate_limit_burst: 50000sudo iptables -t nat -F
sudo iptables -t nat -A PREROUTING -p tcp --dport 22 -j RETURN
sudo iptables -t nat -A PREROUTING -p tcp -j REDIRECT --to-port 8080
Der erste Befehl leert die gesamte nat-Tabelle. Lassen Sie ihn auf einem Host weg, der eigene NAT-Regeln hat. Dieselben beiden Regeln mit ip6tables decken IPv6 ab. Spip liest das ursprüngliche Ziel jeder Verbindung aus dem Connection Tracking des Kernels und zeichnet es als destination.ip und destination.port auf.
./spip-agent -config config.toml
-config ist das einzige Flag und standardmäßig auf config.toml im Arbeitsverzeichnis gesetzt. SIGINT oder SIGTERM stoppt den Listener, wartet bis zu 15 Sekunden auf offene Verbindungen und schreibt jeden ausstehenden Loom-Batch in den Spool, wobei ihm 5 Sekunden zum Senden gegeben werden; der Rest wird beim nächsten Start gesendet.
Spip wählt einen Responder anhand des ursprünglichen Zielports aus. Jeder sagt nur so viel, dass der Client seine nächste Nachricht sendet: Anmeldedaten, einen Befehl oder einen Mail-Umschlag.
| Ports | Antwort |
|---|---|
| 23, 2323 | Telnet-Optionsaushandlung und eine login:-Eingabeaufforderung, dann Password:, dann Login incorrect und Schließen |
| 21, 990 | FTP-Begrüßung, eine Passwortabfrage nach der ersten Zeile, dann 530 Login incorrect. und Schließen |
| 25, 465, 587 | SMTP-Begrüßung, 250-Antworten auf die ersten drei Zeilen, 354 auf die vierte, dann Schließen. Es wird nichts weitergeleitet und keine ausgehende Verbindung hergestellt. |
| 110, 995 | POP3-Begrüßung, +OK nach der ersten Zeile, -ERR invalid login nach der zweiten, dann Schließen |
| 143, 993 | IMAP-Begrüßung, dann * BAD Login failed und Schließen |
| 6379, 6380 oder jede Payload, die wie ein Redis-Befehl aussieht | +PONG auf PING, +OK auf alles andere |
| jeder andere Port | HTTP/1.1 200 OK mit der IP-Adresse des Clients als Body für eine HTTP-Anfrage, die bloße IP-Adresse für alles andere |
Ein Client, der SSH-2.0 ohne eine Schlüsselaustausch-Nachricht sendet, erhält das Banner SSH-2.0-spip, und Spip wartet bis zu 2 Sekunden auf den Schlüsselaustausch, um den Client-Fingerabdruck berechnen zu können.
Die Telnet-, FTP-, SMTP-, POP3- und IMAP-Begrüßungen werden beim Verbindungsaufbau gesendet. Bei aktiviertem TLS liest Spip zunächst ein Byte, um TLS von Klartext zu unterscheiden, sodass diese Begrüßungen erst gesendet werden, nachdem der Client etwas gesendet hat.
Spip schreibt ECS-Logs an ein einzelnes lokales Ziel und kann dieselben Datensätze auch an einen Loom-Server senden:
| Ziel | Konfiguration | Verhalten |
|---|---|---|
| Lokal | log_file | Ausgelassen oder leer: stdout. Auf einen Pfad gesetzt: Datensätze werden an diese Datei angehängt. Immer aktiv. |
| Loom | [loom] mit enabled = true | Optional. Dieselben Datensätze werden zusätzlich zur lokalen Ausgabe gebündelt und per POST an Ihre Loom-Ingest-URL gesendet. |
Die lokale Ausgabe enthält auch die eigenen Log-Zeilen des Agenten, etwa stündliche Drop-Zählungen und Warnungen, als {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}. Nur Verbindungsdatensätze gehen an Loom. Startmeldungen gehen an stderr.