Skip to content
Network assessment tool for various UDP Services covering both IPv4 and IPv6 protocols
Python
Branch: master
Clone or download

Latest commit

gadhiyasavan Update README.md - UDPHunter0.1beta
Update README.md - UDPHunter0.1beta
Latest commit b95cce5 Feb 26, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
README.md
requirements.txt
udp-hunter.py
udp.txt
udphelp.txt

README.md

What is UDP Hunter?

UDP Scanning has always been a slow and painful exercise, and if you add IPv6 on top of UDP, the tool choices get pretty limited. UDP Hunter is a python based open source network assessment tool focused on UDP Service Scanning. With UDP Hunter, we have focused on providing auditing of widely known UDP protocols for IPv6 and IPv4 hosts. As of today, UDP Hunter supports 19 different service probes. The tool allows you to do bulk scanning of large networks as well as targeted host scanning for specific ports and more. Once an open service is discovered, UDP Hunter takes it one step further and even provides you guidance on how you can possibly exploit the discovered services. UDP Hunter provides reports in a neat text format, however, support for more formats is under way.

How does UDP Hunter work?

UDP Hunter creates a list of IPs when any IP range is provided to it. It also supports domain names which will be resolved and the IP will be added to the list. Once the list has been created internally by UDP Hunter, it will send UDP probes to all listed IPs. If the host is running a UDP service, it will respond. UDP Hunter basically sniffs network particularly for UDP traffic, then reads all UDP packets coming to the target host. All UDP probes received after running UDP Hunter will be reported. However, there is an option (by setting --noise=false) to ignore irrelevant UDP packets and only observe the UDP traffic of interest originated from the hosts and services/ports which are mentioned in the target list. The idea behind creating UDP Hunter was initially inspired by udp-proto-scanner. I heartily thank Portcullis Labs for it and also Anant and Sumit Siddharth(Sid) for their valuable inputs while working on UDP Hunter.

Supported UDP Probes:

As of today, we support the following UDP service probes on their default ports:

  • ike - 500 port
  • rpc / RPCCheck - 111 port
  • ntp / NTPRequest - 123 port
  • snmp-public / SNMPv3GetRequest - 161 port
  • ms-sql / ms-sql-slam - 1434 port
  • netop - 6502 port
  • tftp - 69 port
  • db2 - 523 port
  • citrix - 1604 port
  • echo - 7 port
  • chargen - 19 port
  • systat - 11 port
  • daytime / time - 13 port
  • DNSStatusRequest / DNSVersionBindReq - 53 port
  • NBTStat - 137 port
  • xdmcp - 177 port
  • net-support - 5405 port
  • mdns-zeroconf - 5353 port
  • gtpv1 - 2123 port

Setup:

Download the tool from here or Clone the repository:

git clone https://github.com/NotSoSecure/udp-hunter

Requirements:

  • Python 3.x
  • Python Modules - also mentioned in “requirements.txt” file
    • netaddr
    • colorama
    • argparse
    • ifaddr
    • datetime

This should help you with the initial setup:

Install all required modules: pip3 install -r requirements.txt

Configuration files required:

  • udp.txt - This file contains UDP probes
  • udphelp.txt - This file contains list of tools, suggestions for each UDP probes or services
You can also change configuration files by using command line argument:

“--configfile ” and “--probehelp ”

Verify the configurations by running following command:

python udp-hunter.py

Note: It should display following help details, if this throws any error check your configurations or connect with me for any tool specific errors.

Features / Options:

UDP Hunter v0.1beta has the following features:
Mandatory Options:
  • --host - Single Host - Required or
  • --file - File of ips - Required
Optional:
  • --output - Output file - Required
  • --probes - Name of probe or 'all' (default: all probes) (Optional)
    • Probe list - ike, rpc, ntp, snmp-public, ms-sql, ms-sql-slam, netop, tftp, db2, citrix, echo, chargen, systat, daytime, time, RPCCheck, DNSStatusRequest, DNSVersionBindReq, NBTStat, NTPRequest, SNMPv3GetRequest, xdmcp, net-support, mdns-zeroconf, gtpv1
  • --ports - List of ports or 'all' (default: all ports) (Optional)
  • --retries - Number of packets to send to each host. Default 2 (Optional)
  • --noise - To filter output from non-listed IPs (Optional)
  • --verbose - verbosity, will show sniffer output also --- please keep this a true, by default this is true. This will help us to analyze output.
  • --timeout - Timeout 1.0, 2.0 in minutes (Optional)
  • --lhost6 - Provide IPv6 of listner interface
  • --lhost4 - Provide IPv4 of listner interface
  • --configfile - Configuration file location - default is 'udp.txt' in same directory
  • --probehelp - Help file location - default is 'udphelp.txt' in same directory
Usage:

Usage: python udp-hunter.py --file=inputfile.txt --output=outputfile.txt [optional arguments] Usage: python udp-hunter.py --file=inputfile.txt --output=outputfile.txt [--probes=NTPRequest,SNMPv3GetReques] [--ports=123,161,53] [--retries=3] [--noise=true] [--verbose=false] [--timeout=1.0] [--configfile]

Credits:

The UDP probes are mainly taken from amap, ike-scan, nmap and udp-proto-scanner. Inspiration for the scanning code was drawn from udp-proto-scanner.

Future Work:

  • Addition of more UDP probes
  • Different reporting formats
  • Update exploitation-related helps

Read More:

You can’t perform that action at this time.