Giter VIP home page Giter VIP logo

udp-hunter's Introduction

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:

udp-hunter's People

Contributors

gadhiyasavan avatar

Stargazers

Abhijit Chatterjee avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.