Sensor de red Spip escrito en Go
Spip es un sensor honeypot de red de baja interacción para Linux, escrito en Go. Acepta conexiones TCP en cualquier puerto que el host le redirija, en texto plano o TLS, responde lo justo para que un cliente envíe su siguiente mensaje y escribe cada intercambio como un único registro JSON con nombres de campo ECS, listo para un SIEM o un data lake. La captura UDP opcional registra datagramas y nunca responde a ellos.
HoneyLabs ejecuta Spip para recopilar los datos publicados en honeylabs.net.
Requisitos previos:
iptables y acceso root para instalar las reglas de redireccióngit clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
Para establecer la versión informada en observer.version y agent.version (por defecto dev), añada -ldflags "-X main.version=v1.2.3".
sudo ./scripts/initial_setup.sh
Consulte el asistente de configuración inicial a continuación.
config.toml
config.toml mínimo:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
Claves de configuración opcionales:
cert_path / key_path: habilitan TLS si ambas están definidas. Las rutas relativas se resuelven contra el directorio del archivo de configuración.log_file: añade registros a este archivo en lugar de a stdout. Véase Salida de registro más abajo.[loom]: también envía registros por HTTP. Véase Loom más abajo.read_timeout_seconds / write_timeout_seconds: tiempo de espera de lectura inactiva y tiempo de espera de escritura por conexión.rate_limit_per_second / rate_limit_burst: límite de tasa sobre nuevas conexiones TCP, compartido por todas las fuentes. Una conexión que supera el límite se cierra sin leer.community_id_seed: semilla opcional de 16 bits para el hashing de flujos de Community ID v1 (omitir o 0 para el valor predeterminado).capture_client_hello: establecer en false para omitir tls.client.hello_hex. Véase Fingerprinting.ignore_sources: direcciones o redes cuyas conexiones y datagramas se cierran o descartan antes de leer nada, de modo que nunca se registran, se les aplica fingerprinting ni se envían. Direcciones simples y CIDR, IPv4 o IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. Un honeypot en un host alquilado recibe sondeos del propio monitoreo de ese host, y contar esos sondeos distorsiona los rankings de puertos y los recuentos de escáneres. Una entrada que no se puede analizar impide que el agente arranque, porque un error tipográfico aquí registraría silenciosamente tráfico que usted cree que se descarta. Los descartes se cuentan por fuente y se reportan en el registro cada hora y al apagarse.udp_enabled y las claves udp_*: véase Captura UDP.Si estos campos de ajuste en tiempo de ejecución se omiten o se establecen en 0, Spip aplica los siguientes valores predeterminados:
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
El primer comando vacía toda la tabla nat. Omítelo en un host que tenga sus propias reglas NAT. Las mismas dos reglas con ip6tables cubren IPv6. Spip lee el destino original de cada conexión desde el seguimiento de conexiones del kernel y lo registra como destination.ip y destination.port.
./spip-agent -config config.toml
-config es el único flag y por defecto toma config.toml en el directorio de trabajo. SIGINT o SIGTERM detiene el listener, espera hasta 15 segundos por las conexiones abiertas y escribe cualquier lote de Loom pendiente en el spool, dándole 5 segundos para enviarse; el resto se envía en el siguiente arranque.
Spip elige un respondedor según el puerto de destino original. Cada uno dice solo lo suficiente para que el cliente envíe su siguiente mensaje: credenciales, un comando o un sobre de correo.
| Puertos | Respuesta |
|---|---|
| 23, 2323 | Negociación de opciones de Telnet y un prompt login:, luego Password:, luego Login incorrect y cierre |
| 21, 990 | Saludo FTP, una solicitud de contraseña tras la primera línea, luego 530 Login incorrect. y cierre |
| 25, 465, 587 | Saludo SMTP, respuestas 250 a las tres primeras líneas, 354 a la cuarta, luego cierre. No se retransmite nada ni se realiza ninguna conexión saliente. |
| 110, 995 | Saludo POP3, +OK tras la primera línea, -ERR invalid login tras la segunda, luego cierre |
| 143, 993 | Saludo IMAP, luego * BAD Login failed y cierre |
| 6379, 6380, o cualquier payload que parezca un comando de Redis | +PONG a PING, +OK a todo lo demás |
| cualquier otro puerto | HTTP/1.1 200 OK con la dirección IP del cliente como cuerpo para una solicitud HTTP, la dirección IP sin más para cualquier otra cosa |
Un cliente que envía SSH-2.0 sin un mensaje de intercambio de claves recibe el banner SSH-2.0-spip, y Spip espera hasta 2 segundos por el intercambio de claves para poder calcular la huella del cliente.
Los saludos de telnet, FTP, SMTP, POP3 e IMAP se envían al conectar. Con TLS habilitado, Spip primero lee un byte para distinguir TLS de texto plano, por lo que esos saludos solo se envían después de que el cliente haya enviado algo.
Spip escribe logs ECS en un único destino local y también puede enviar los mismos registros a un servidor Loom:
| Destino | Configuración | Comportamiento |
|---|---|---|
| Local | log_file | Omitido o vacío: stdout. Establecido a una ruta: los registros se añaden a ese archivo. Siempre activo. |
| Loom | [loom] con enabled = true | Opcional. Los mismos registros se agrupan en lotes y se envían por POST a tu URL de ingesta de Loom además de la salida local. |
La salida local también incluye las propias líneas de log del agente, como recuentos de descartes por hora y advertencias, como {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}. Solo los registros de conexión van a Loom. Los mensajes de arranque van a stderr.