Network Inventory

Спросите небольшой отель или офис, что подключено к их сети, и честный ответ обычно — «не знаем». Камеры, регистраторы, принтеры, точки доступа и компьютер, который кто-то несколько лет назад настроил для удалённой поддержки, сидят в одной плоской сети. Новое устройство никто не замечает, и никто не знает, что камера после сброса настроек отвечает по Telnet.

Директива ЕС NIS2 называет учёт активов среди минимальных мер кибербезопасности (статья 21(2)(i)). Она распространяется на средние и крупные компании определённых отраслей, поэтому многие небольшие предприятия в неё не попадают. Но список того, что есть в сети, — всё равно первый шаг любой работы по безопасности. Этот инструмент помогает вести такой список; соответствия NIS2 он сам по себе не обеспечивает.

• Сети для сканирования нужно перечислить явно. Разрешены только частные диапазоны, не больше /22, и инструмент никогда никуда не логинится и ничего не взламывает.
• Скан пингует все адреса параллельно через asyncio, а потом читает ARP-таблицу операционной системы, чтобы узнать MAC-адреса. Так находится даже компьютер, который не отвечает на ping.
• К каждому живому устройству делается TCP-подключение на короткий список портов (Telnet, FTP, RDP, SMB, RTSP, Winbox…) и обратный DNS-запрос, чтобы узнать имя.
• По MAC-адресу определяется производитель — из небольшой встроенной выборки списка IEEE. Случайные MAC телефонов и виртуальных машин помечаются как случайные, а не получают неправильного производителя.
• Устройства отслеживаются по MAC в реестре SQLite, поэтому новый адрес от DHCP — это не новое устройство. Каждый скан сравнивается с предыдущим: новое устройство, пропало, сменился IP, открылся порт.
• Новое устройство или новый опасный порт — одно сообщение в Telegram за скан. Веб-страница показывает реестр с фильтрами, риски с понятными объяснениями и выгружает CSV и JSON.

• Python 3.12
• asyncio
• FastAPI
• Jinja2
• SQLite
• aiogram 3
• pytest

Поиск устройств использует системные ping, arp -a и ip neigh, а не «сырые» сокеты, поэтому работает без прав администратора. Их вывод декодируется как ASCII: на русской Windows слова становятся нечитаемыми, но TTL=, IP- и MAC-адреса сохраняются на любом языке — урок из проекта Uptime Monitor. Сопоставление устройств и сравнение сканов — чистые функции, а каждый скан сохраняется одной транзакцией.

Сравнение сканов — чистая функция. Порты сравниваются с последним появлением устройства, даже если оно было несколько недель назад, а пропавшим устройство считается, только если этот скан охватывал его сеть:

def diff(*, last_known, previous_scan, current, in_scope):
    changes = []
    for key, now in current.items():
        before = last_known.get(key)
        if before is None:
            changes.append(Change(ChangeKind.NEW, key, tuple(sorted(now.ports)), new_ip=now.ip))
            continue
        if key not in previous_scan:
            changes.append(Change(ChangeKind.RETURNED, key, new_ip=now.ip))
        if before.ip != now.ip:
            changes.append(Change(ChangeKind.IP_CHANGED, key, old_ip=before.ip, new_ip=now.ip))
        if opened := now.ports - before.ports:
            changes.append(Change(ChangeKind.PORT_OPENED, key, tuple(sorted(opened))))
        if closed := before.ports - now.ports:
            changes.append(Change(ChangeKind.PORT_CLOSED, key, tuple(sorted(closed))))

    for key in previous_scan:
        before = last_known.get(key)
        if key not in current and before is not None and in_scope(before.ip):
            changes.append(Change(ChangeKind.GONE, key, old_ip=before.ip))
    return changes

Имена хостов пропадали, когда у многих адресов не было имени

try:
    name, _ = await asyncio.wait_for(
        loop.getnameinfo((ip, 0), socket.NI_NAMEREQD), timeout_s
    )
except (TimeoutError, OSError):
    return None

await self._slots.acquire()
future = loop.run_in_executor(self._pool, self._resolve, ip)
future.add_done_callback(self._release)  # free the slot only when the thread is done
try:
    name = await asyncio.wait_for(asyncio.shield(future), self._timeout)
except (TimeoutError, OSError, UnicodeError):
    return None

• 117 автоматических тестов, включая настоящий вывод ping и arp -a с русской Windows.
• Проверено на настоящей сети, но только на этом компьютере и домашнем роутере: роутер найден с производителем, именем и открытыми портами за 2–3 секунды.
• Скан диапазона loopback 127.0.0.0/22 (1022 адреса, все на этом компьютере) занял 22 секунды.
• Демо-режим моделирует офис из 21 устройства и сканирует его дважды: шесть изменений и одна тревога в Telegram.

• Исходный код на GitHub↗
• Живое демо→