Spip сетевой сенсор, написанный на Go
Spip — это низковзаимодействующий сетевой датчик-приманка для Linux, написанный на Go. Он принимает TCP-соединения на любом порту, который хост перенаправляет на него, в открытом виде или через TLS, отвечает ровно настолько, чтобы заставить клиента отправить следующее сообщение, и записывает каждый обмен как одну JSON-запись с именами полей ECS, готовую для SIEM или озера данных. Опциональный захват UDP записывает датаграммы и никогда на них не отвечает.
HoneyLabs использует Spip для сбора данных, публикуемых на honeylabs.net.
Предварительные требования:
iptables и права root для установки правил перенаправленияgit clone https://github.com/honeylabshq/Spip-Go.git
cd Spip-Go
go build -o spip-agent ./cmd/spip-agent
Чтобы задать версию, указываемую в observer.version и agent.version (по умолчанию dev), добавьте -ldflags "-X main.version=v1.2.3".
sudo ./scripts/initial_setup.sh
См. Помощник начальной настройки ниже.
config.toml
Минимальный config.toml:name = "spip-agent"
ip = "0.0.0.0"
port = 8080
Необязательные ключи конфигурации:
cert_path / key_path: включают TLS, если заданы оба. Относительные пути разрешаются относительно каталога файла конфигурации.log_file: добавлять записи в этот файл вместо stdout. См. Вывод журнала ниже.[loom]: также отправлять записи по HTTP. См. Loom ниже.read_timeout_seconds / write_timeout_seconds: тайм-аут простоя на чтение и тайм-аут на запись для каждого соединения.rate_limit_per_second / rate_limit_burst: ограничение скорости для новых TCP-соединений, общее для всех источников. Соединение, превышающее лимит, закрывается без чтения.community_id_seed: необязательное 16-битное зерно для хеширования потоков Community ID v1 (опустите или укажите 0 для значения по умолчанию).capture_client_hello: установите false, чтобы не включать tls.client.hello_hex. См. Снятие отпечатков.ignore_sources: адреса или сети, соединения и датаграммы которых закрываются или отбрасываются до чтения чего-либо, поэтому они никогда не журналируются, не фингерпринтятся и не отправляются. Простые адреса и CIDR, IPv4 или IPv6:
ignore_sources = ["192.0.2.10", "198.51.100.0/24", "2001:db8::/32"]. Ханипот на арендованном хосте опрашивается собственным мониторингом этого хоста, и учёт этих запросов искажает рейтинги портов и подсчёт сканеров. Запись, которая не разбирается, не даёт агенту запуститься, потому что опечатка здесь молча записывала бы трафик, который вы считаете отброшенным. Отбрасывания подсчитываются по источнику и сообщаются в журнале каждый час и при завершении работы.udp_enabled и ключи udp_*: см. Захват UDP.Если эти поля настройки времени выполнения опущены или установлены в 0, Spip применяет следующие значения по умолчанию:
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
Первая команда очищает всю таблицу nat. Не выполняйте её на хосте, у которого есть собственные правила NAT. Те же два правила с ip6tables охватывают IPv6. Spip считывает исходный пункт назначения каждого соединения из отслеживания соединений ядра и записывает его как destination.ip и destination.port.
./spip-agent -config config.toml
-config — единственный флаг, по умолчанию указывает на config.toml в рабочем каталоге. SIGINT или SIGTERM останавливает слушатель, ждёт до 15 секунд открытые соединения и записывает любой ожидающий пакет Loom в спул, давая ему 5 секунд на отправку; остальное отправляется при следующем запуске.
Spip выбирает ответчик по исходному порту назначения. Каждый из них сообщает ровно столько, чтобы заставить клиента отправить следующее сообщение: учётные данные, команду или почтовый конверт.
| Порты | Ответ |
|---|---|
| 23, 2323 | Согласование опций Telnet и приглашение login:, затем Password:, затем Login incorrect и закрытие |
| 21, 990 | Приветствие FTP, запрос пароля после первой строки, затем 530 Login incorrect. и закрытие |
| 25, 465, 587 | Приветствие SMTP, ответы 250 на первые три строки, 354 на четвёртую, затем закрытие. Ничего не ретранслируется и исходящее соединение не устанавливается. |
| 110, 995 | Приветствие POP3, +OK после первой строки, -ERR invalid login после второй, затем закрытие |
| 143, 993 | Приветствие IMAP, затем * BAD Login failed и закрытие |
| 6379, 6380 или любой payload, похожий на команду Redis | +PONG на PING, +OK на всё остальное |
| любой другой порт | HTTP/1.1 200 OK с IP-адресом клиента в качестве тела для HTTP-запроса, голый IP-адрес для всего остального |
Клиент, отправивший SSH-2.0 без сообщения обмена ключами, получает баннер SSH-2.0-spip, и Spip ждёт до 2 секунд обмена ключами, чтобы вычислить отпечаток клиента.
Приветствия telnet, FTP, SMTP, POP3 и IMAP отправляются при подключении. При включённом TLS Spip сначала читает один байт, чтобы отличить TLS от открытого текста, поэтому эти приветствия отправляются только после того, как клиент что-то отправил.
Spip записывает журналы ECS в одно локальное назначение и также может отправлять те же записи на сервер Loom:
| Назначение | Конфигурация | Поведение |
|---|---|---|
| Локальное | log_file | Опущено или пусто: stdout. Указан путь: записи добавляются в этот файл. Всегда включено. |
| Loom | [loom] с enabled = true | Необязательно. Те же записи пакетируются и отправляются POST-запросом на ваш URL приёма Loom в дополнение к локальному выводу. |
Локальный вывод также содержит собственные строки журнала агента, такие как почасовые счётчики отбрасывания и предупреждения, в виде {"timestamp": <unix seconds>, "level": "INFO", "message": "...", "target": "...", "record_type": "log"}. На Loom отправляются только записи о соединениях. Сообщения о запуске выводятся в stderr.