Sensor de rede Spip escrito em Go
Spip é um sensor de honeypot de rede de baixa interação para Linux, escrito em Go. Ele aceita conexões TCP em qualquer porta que o host redirecione para ele, em texto simples ou TLS, responde apenas o suficiente para fazer um cliente enviar sua próxima mensagem, e grava cada troca como um único registro JSON com nomes de campos ECS, pronto para um SIEM ou data lake. A captura UDP opcional registra datagramas e nunca os responde.
A HoneyLabs executa o Spip para coletar os dados publicados em honeylabs.net.
Pré-requisitos:
iptables e acesso root para instalar as regras de redirecionamentogit clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
Para definir a versão informada em observer.version e agent.version (padrão dev), adicione -ldflags "-X main.version=v1.2.3".
sudo ./scripts/initial_setup.sh
Consulte o auxiliar de configuração inicial abaixo.
config.toml
config.toml mínimo:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
Chaves de configuração opcionais:
cert_path / key_path: ativam TLS se ambos estiverem definidos. Caminhos relativos são resolvidos em relação ao diretório do arquivo de configuração.log_file: anexa registros a este arquivo em vez de stdout. Consulte Saída de log abaixo.[loom]: também envia registros via HTTP. Consulte Loom abaixo.read_timeout_seconds / write_timeout_seconds: timeout de leitura ociosa e timeout de escrita por conexão.rate_limit_per_second / rate_limit_burst: limite de taxa em novas conexões TCP, compartilhado por todas as fontes. Uma conexão acima do limite é fechada sem leitura.community_id_seed: seed de 16 bits opcional para o hashing de fluxo do Community ID v1 (omita ou use 0 para o padrão).capture_client_hello: defina como false para omitir tls.client.hello_hex. Consulte Fingerprinting.ignore_sources: endereços ou redes cujas conexões e datagramas são fechados ou descartados antes de qualquer leitura, de modo que nunca são registrados, fingerprintados ou enviados. Endereços simples e CIDR, IPv4 ou IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. Um honeypot em um host alugado é consultado pelo próprio monitoramento desse host, e contar essas consultas distorce os rankings de portas e as contagens de scanners. Uma entrada que não é analisada corretamente impede a inicialização do agente, porque um erro de digitação aqui registraria silenciosamente tráfego que você acredita estar descartado. Os descartes são contados por origem e reportados no log a cada hora e no encerramento.udp_enabled e as chaves udp_*: consulte Captura UDP.Se estes campos de ajuste em tempo de execução forem omitidos ou definidos como 0, o Spip aplica os seguintes padrões:
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
O primeiro comando limpa toda a tabela nat. Omita-o num host que tenha as suas próprias regras NAT. As mesmas duas regras com ip6tables cobrem IPv6. O Spip lê o destino original de cada conexão a partir do connection tracking do kernel e regista-o como destination.ip e destination.port.
./spip-agent -config config.toml
-config é a única flag e tem como padrão config.toml no diretório de trabalho. SIGINT ou SIGTERM interrompe o listener, aguarda até 15 segundos pelas conexões abertas e grava qualquer lote Loom pendente no spool, dando-lhe 5 segundos para enviar; o restante é enviado na próxima inicialização.
O Spip escolhe um respondedor pela porta de destino original. Cada um diz apenas o suficiente para fazer o cliente enviar sua próxima mensagem: credenciais, um comando ou um envelope de e-mail.
| Portas | Resposta |
|---|---|
| 23, 2323 | Negociação de opções Telnet e um prompt login:, depois Password:, depois Login incorrect e fecha |
| 21, 990 | Saudação FTP, uma solicitação de senha após a primeira linha, depois 530 Login incorrect. e fecha |
| 25, 465, 587 | Saudação SMTP, respostas 250 às três primeiras linhas, 354 à quarta, depois fecha. Nada é retransmitido e nenhuma conexão de saída é feita. |
| 110, 995 | Saudação POP3, +OK após a primeira linha, -ERR invalid login após a segunda, depois fecha |
| 143, 993 | Saudação IMAP, depois * BAD Login failed e fecha |
| 6379, 6380, ou qualquer payload que se pareça com um comando Redis | +PONG para PING, +OK para todo o resto |
| qualquer outra porta | HTTP/1.1 200 OK com o endereço IP do cliente como corpo para uma requisição HTTP, o endereço IP puro para qualquer outra coisa |
Um cliente que envia SSH-2.0 sem uma mensagem de troca de chaves recebe o banner SSH-2.0-spip, e o Spip aguarda até 2 segundos pela troca de chaves para poder calcular a fingerprint do cliente.
As saudações de telnet, FTP, SMTP, POP3 e IMAP são enviadas na conexão. Com TLS habilitado, o Spip primeiro lê um byte para distinguir TLS de texto simples, então essas saudações só são enviadas depois que o cliente enviou algo.
O Spip grava logs ECS em um único destino local e também pode enviar os mesmos registros para um servidor Loom:
| Destino | Config | Comportamento |
|---|---|---|
| Local | log_file | Omitido ou vazio: stdout. Definido como um caminho: os registros são anexados a esse arquivo. Sempre ativo. |
| Loom | [loom] com enabled = true | Opcional. Os mesmos registros são agrupados em lote e enviados via POST para sua URL de ingestão do Loom, além da saída local. |
A saída local também carrega as próprias linhas de log do agente, como contagens horárias de descarte e avisos, como {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}. Apenas registros de conexão vão para o Loom. Mensagens de inicialização vão para stderr.