Network Inventory

Küçük bir otele veya ofise ağına neyin bağlı olduğunu sorun; dürüst cevap çoğu zaman "bilmiyoruz" olur. Kameralar, kayıt cihazları, yazıcılar, erişim noktaları ve yıllar önce uzaktan destek için kurulmuş bilgisayar aynı düz ağda durur. Yeni bir cihazı kimse fark etmez; fabrika ayarlarına dönen bir kameranın Telnet'e cevap verdiğini de kimse bilmez.

AB'nin NIS2 Direktifi varlık yönetimini asgari siber güvenlik önlemleri arasında sayar (Madde 21(2)(i)). Direktif belirli sektörlerdeki orta ve büyük ölçekli şirketlere uygulanır; bu yüzden birçok küçük işletme kapsamı dışında kalır. Yine de ağda ne olduğunun listesi her güvenlik çalışmasının ilk adımıdır. Bu araç o listeyi tutmaya yardım eder; kimseyi tek başına NIS2 uyumlu yapmaz.

• Taranacak ağlar açıkça yazılmalıdır. Yalnızca özel IP aralıklarına izin verilir, /22'den büyüğüne izin verilmez; araç hiçbir yere giriş yapmaz ve hiçbir açığı kullanmaz.
• Bir tarama asyncio ile tüm adreslere paralel ping atar, ardından MAC adresleri için işletim sisteminin ARP tablosunu okur; böylece ping'e cevap vermeyen bir bilgisayar da bulunur.
• Her canlı cihaza kısa bir port listesiyle (Telnet, FTP, RDP, SMB, RTSP, Winbox…) TCP bağlantısı denenir ve adı için ters DNS sorgusu yapılır.
• MAC adresinden üretici bulunur; kaynak, IEEE listesinden alınmış küçük, gömülü bir alt kümedir. Telefonların ve sanal makinelerin rastgele MAC'leri yanlış üretici almak yerine öyle işaretlenir.
• Cihazlar SQLite kaydında MAC ile izlenir; DHCP'den gelen yeni bir adres yeni bir cihaz sayılmaz. Her tarama bir öncekiyle karşılaştırılır: yeni cihaz, kayboldu, IP değişti, port açıldı.
• Yeni bir cihaz ya da yeni açılan riskli bir port, tarama başına tek bir Telegram mesajı gönderir. Web sayfası kaydı filtrelerle, riskleri sade açıklamalarla gösterir; CSV ve JSON dışa aktarır.

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

Cihaz keşfi ham soketler yerine sistemin ping, arp -a ve ip neigh komutlarını kullanır; bu yüzden yönetici yetkisi gerekmez. Çıktıları ASCII olarak çözülür: Rusça Windows'ta kelimeler okunamaz hale gelir ama TTL=, IP ve MAC adresleri her dilde kalır — Uptime Monitor projesinden kalan bir ders. Cihazları eşleştirme ve taramaları karşılaştırma saf fonksiyonlardır; her tarama tek bir işlemle (transaction) kaydedilir.

Taramalar arasındaki fark saf bir fonksiyondur. Portlar, haftalar önce de olsa cihazın son görüldüğü taramayla karşılaştırılır; bir cihaz ancak bu tarama onun ağını kapsadıysa kaybolmuş sayılır:

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

Birçok adresin adı olmadığında host adları kayboluyordu

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 otomatik test; aralarında Rusça Windows'tan gerçek ping ve arp -a çıktıları var.
• Gerçek bir ağda, ama yalnızca bu bilgisayar ve ev router'ı üzerinde denendi: router üreticisi, adı ve açık portlarıyla 2–3 saniyede bulundu.
• Loopback aralığı 127.0.0.0/22'nin taranması (1022 adres, hepsi bu bilgisayarda) 22 saniye sürdü.
• Demo modu 21 cihazlık bir ofisi simüle eder ve iki kez tarar: altı değişiklik ve bir Telegram uyarısı.

• GitHub'da kaynak kod↗
• Canlı demo→