🛰️ NetMap Ultimate

NetMap Ultimate adalah alat pemindai jaringan (Network Scanner) berperforma tinggi yang ditulis dalam bahasa Ruby. Dirancang untuk kecepatan dan akurasi, NetMap mampu memetakan seluruh jaringan lokal atau WiFi Anda dalam hitungan detik menggunakan teknologi Asynchronous I/O.

---

✨ Fitur Utama

📡 Ultimate Host Discovery

• Multi-Layer Detection: Menggabungkan ICMP Ping, ARP Cache Lookup (L2), dan TCP Ping Fallback.
• ARP Precision: Deteksi instan perangkat di jaringan lokal dengan membaca tabel ARP sistem secara langsung.
• Smart Pn Mode: Lewati Host Discovery dengan flag -Pn untuk memindai target yang memblokir semua jenis ping.

🏢 Identifikasi & Fingerprinting

• OUI Vendor Mapping: Mengenali merk perangkat (Apple, Cisco, VMware, dll) berdasarkan prefix MAC Address.
• OS Prediction: Tebakan Sistem Operasi (Linux/Unix, Windows, Cisco) menggunakan analisis TTL (Time To Live).
• Service Grabbing: Banner grabbing otomatis untuk SSH, MySQL, HTTP, dan layanan populer lainnya.

⚡ Performa Tinggi & Kustomisasi

• Async Concurrency Engine: Menangani ratusan tugas pemindaian secara paralel tanpa membebani memori.
• Flexible Timing: 6 template kecepatan dari Paranoid hingga Insane untuk menyesuaikan diri dengan sensitivitas jaringan target.

---

🚀 Instalasi

Prasyarat

• Ruby >= 3.0
• Linux (Direkomendasikan untuk fitur pemindaian Layer 2 / ARP terbaik)

Cara Instalasi

git clone https://github.com/IshikawaUta/netmap-scanner.git
cd netmap-scanner
bundle install

---

📖 Referensi Perintah (CLI Options)

Opsi	Deskripsi
-p <range>	Tentukan port (misal: 80,443 atau 1-1024).
-sn	Ping scan saja (hanya mencari host yang aktif).
-Pn	Lewati Host Discovery (anggap host aktif).
-O	Aktifkan deteksi Sistem Operasi (OS Detection).
-sU	Aktifkan pemindaian berbasis UDP.
-T <0-5>	Pilih Timing Template (0: Lambat, 5: Sangat Cepat).
-t <n>	Atur jumlah concurrency thread secara manual.
-j <file>	Simpan hasil ke format JSON.
--html <file>	Simpan hasil ke laporan HTML yang cantik.
-g <file>	Simpan hasil ke format grepable (Nmap style).

---

🕒 Timing Templates (-T)

Template	Nama	Concurrency	Timeout	Karakteristik
0	Paranoid	1	10.0s	Sangat lambat, untuk melewati IDS/Firewall.
1	Sneaky	5	5.0s	Pelan dan hati-hati.
2	Polite	10	2.0s	Mengurangi beban pada jaringan/target.
3	Normal	50	1.0s	Keseimbangan antara kecepatan dan akurasi (Default).
4	Aggressive	200	0.8s	Sangat cepat, cocok untuk jaringan yang stabil.
5	Insane	400	0.5s	Sangat agresif, butuh bandwidth yang besar.

---

🌀 Scripting Engine (Kustom Audit)

NetMap menyertakan engine skrip Ruby yang ringan untuk memperluas kemampuan audit. Anda bisa menambahkan skrip audit sendiri di folder scripts/.

Contoh Skrip (scripts/my_check.rb):

# Skrip sederhana untuk mendeteksi banner tertentu
if banner.include?("Apache")
  "Apache Web Server Terdeteksi"
elsif port == 8080
  "Port Proxy Terdeteksi"
else
  nil
end

Variabel yang tersedia di dalam skrip:

• ip: Alamat IP target.
• port: Nomor port yang sedang dipindai.
• banner: Banner layanan yang didapat.
• os: Nama Sistem Operasi (jika -O aktif).
• type: Jenis protokol (TCP atau UDP).

---

🔧 Persyaratan Sistem & Troubleshooting

• Privilese Sudo: Fitur deteksi MAC Address pada jaringan lokal seringkali membutuhkan akses sudo atau hak akses tinggi untuk membaca tabel ARP sistem.
• Host Discovery: Jika target berada di balik firewall ketat, gunakan -Pn untuk memaksakan pemindaian port.

---

🤝 Kontribusi

Kontribusi selalu diterima! Rasakan kebebasan untuk mengirimkan Pull Request atau melaporkan bug melalui Issue di GitHub.

⚖️ Lisensi

Proyek ini dilisensikan di bawah MIT License. Lihat file LICENSE untuk informasi lebih lanjut.