Capteur réseau Spip écrit en Go
Spip est un capteur honeypot réseau à faible interaction pour Linux, écrit en Go. Il accepte les connexions TCP sur n'importe quel port que l'hôte lui redirige, en clair ou en TLS, répond juste assez pour qu'un client envoie son message suivant, et écrit chaque échange sous forme d'un enregistrement JSON avec les noms de champs ECS, prêt pour un SIEM ou un data lake. La capture UDP optionnelle enregistre les datagrammes et n'y répond jamais.
HoneyLabs utilise Spip pour collecter les données publiées sur honeylabs.net.
Prérequis :
iptables et un accès root pour installer les règles de redirectiongit clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
Pour définir la version indiquée dans observer.version et agent.version (par défaut dev), ajoutez -ldflags "-X main.version=v1.2.3".
sudo ./scripts/initial_setup.sh
Voir Assistant de configuration initiale ci-dessous.
config.toml
config.toml minimal :name = "spip-agent"
ip = "0.0.0.0"
port = 8080
Clés de configuration facultatives :
cert_path / key_path : active TLS si les deux sont définis. Les chemins relatifs sont résolus par rapport au répertoire du fichier de configuration.log_file : ajoute les enregistrements à ce fichier au lieu de stdout. Voir Sortie de journal ci-dessous.[loom] : expédie également les enregistrements via HTTP. Voir Loom ci-dessous.read_timeout_seconds / write_timeout_seconds : délai d'expiration de lecture au repos et délai d'expiration d'écriture par connexion.rate_limit_per_second / rate_limit_burst : limitation de débit sur les nouvelles connexions TCP, partagée par toutes les sources. Une connexion dépassant la limite est fermée sans être lue.community_id_seed : graine 16 bits facultative pour le hachage de flux Community ID v1 (omettre ou 0 pour la valeur par défaut).capture_client_hello : définir sur false pour omettre tls.client.hello_hex. Voir Empreinte.ignore_sources : adresses ou réseaux dont les connexions et datagrammes sont fermés ou rejetés avant toute lecture, afin qu'ils ne soient jamais journalisés, empreintés ni expédiés. Adresses seules et CIDR, IPv4 ou IPv6 :
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. Un honeypot sur un hôte loué est interrogé par la surveillance propre à cet hôte, et compter ces requêtes fausse les classements de ports et les décomptes de scanners. Une entrée qui ne se parse pas empêche l'agent de démarrer, car une faute de frappe ici enregistrerait silencieusement du trafic que vous croyez rejeté. Les rejets sont comptés par source et signalés dans le journal toutes les heures et à l'arrêt.udp_enabled et les clés udp_* : voir Capture UDP.Si ces champs de réglage d'exécution sont omis ou définis sur 0, Spip applique les valeurs par défaut suivantes :
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
La première commande vide toute la table nat. Omettez-la sur un hôte qui possède ses propres règles NAT. Les deux mêmes règles avec ip6tables couvrent IPv6. Spip lit la destination d'origine de chaque connexion depuis le suivi de connexion du noyau et l'enregistre comme destination.ip et destination.port.
./spip-agent -config config.toml
-config est le seul drapeau et vaut par défaut config.toml dans le répertoire de travail. SIGINT ou SIGTERM arrête l'écouteur, attend jusqu'à 15 secondes les connexions ouvertes et écrit tout lot Loom en attente dans le spool, en lui accordant 5 secondes pour l'envoi ; le reste est envoyé au prochain démarrage.
Spip choisit un répondeur en fonction du port de destination d'origine. Chacun ne dit que le nécessaire pour que le client envoie son message suivant : identifiants, une commande ou une enveloppe de courrier.
| Ports | Réponse |
|---|---|
| 23, 2323 | Négociation d'options Telnet et une invite login:, puis Password:, puis Login incorrect et fermeture |
| 21, 990 | Bannière FTP, une demande de mot de passe après la première ligne, puis 530 Login incorrect. et fermeture |
| 25, 465, 587 | Bannière SMTP, réponses 250 aux trois premières lignes, 354 à la quatrième, puis fermeture. Rien n'est relayé et aucune connexion sortante n'est établie. |
| 110, 995 | Bannière POP3, +OK après la première ligne, -ERR invalid login après la seconde, puis fermeture |
| 143, 993 | Bannière IMAP, puis * BAD Login failed et fermeture |
| 6379, 6380, ou toute charge utile qui ressemble à une commande Redis | +PONG à PING, +OK à tout le reste |
| tout autre port | HTTP/1.1 200 OK avec l'adresse IP du client comme corps pour une requête HTTP, l'adresse IP nue pour tout le reste |
Un client qui envoie SSH-2.0 sans message d'échange de clés reçoit la bannière SSH-2.0-spip, et Spip attend jusqu'à 2 secondes l'échange de clés afin de pouvoir calculer l'empreinte du client.
Les bannières telnet, FTP, SMTP, POP3 et IMAP sont envoyées à la connexion. Avec TLS activé, Spip lit d'abord un octet pour distinguer TLS du texte en clair, de sorte que ces bannières ne sont émises qu'après que le client a envoyé quelque chose.
Spip écrit les journaux ECS vers une destination locale unique et peut également envoyer les mêmes enregistrements à un serveur Loom :
| Destination | Configuration | Comportement |
|---|---|---|
| Locale | log_file | Omis ou vide : stdout. Défini sur un chemin : les enregistrements sont ajoutés à ce fichier. Toujours actif. |
| Loom | [loom] avec enabled = true | Facultatif. Les mêmes enregistrements sont regroupés et envoyés par POST à votre URL d'ingestion Loom en plus de la sortie locale. |
La sortie locale contient également les propres lignes de journal de l'agent, telles que les décomptes horaires de rejets et les avertissements, sous la forme {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}. Seuls les enregistrements de connexion vont à Loom. Les messages de démarrage vont vers stderr.