Skip to content
/ astsu Public

A network scanner tool, developed in Python 3 using scapy.

License

Notifications You must be signed in to change notification settings

ReddyyZ/astsu

Repository files navigation

astsu

Demonstration Video

How it works

  • Scan common ports

Send a TCP Syn packet to the destination on the defined port, if the port is open, use an nmap scan to check the service running on the port and prints all the ports found.

  • Discover hosts in network

Uses as a base the router's ip to map all possible ips. It then sends an ICMP packet to each IP, and waits for a response, if it receives any response saved in an array the IP of the online host, and when it finishes checking all hosts, prints all hosts online.

  • OS Scan

Sends an ICMP packet to the destination and waits for a response. Then, extracts the TTL from the destination response and checks the possible OS in a list, if have founded, prints it.

OS Support

  • Windows ✔️
  • Linux ✔️
  • Mac

How to install

Clone this repository git clone https://github.com/ReddyyZ/astsu.git

  • Install python 3.
    • Linux
      • apt-get install python3
      • chmod +x *
      • python3 -m pip install -r requirements.txt
      • python3 install.py
      • Done!
    • Windows

Arguments

  • -sC | Scan common ports
    • -p | Protocol to use in the scan
    • -i | Interface to use
    • -t | Timeout to each request
    • -st | Use stealth scan method (TCP)
  • -sA | Scan all ports
    • -p | Protocol to use in the scan
    • -i | Interface to use
    • -t | Timeout to each request
    • -st | Use stealth scan method (TCP)
  • -sP | Scan a range ports
    • -p | Protocol to use in the scan
    • -i | Interface to use
    • -t | Timeout to each request
    • -st | Use stealth scan method (TCP)
  • -sO | Scan OS of a target
  • -d | Discover hosts in the network
    • -p | Protocol to use in the scan
    • -i | Interface to use

Examples

  • Discover hosts
astsu -d
  • Scan common ports using SYN Scan
astsu -sC -st 192.168.1.1
  • Scan a range of ports
astsu 192.168.1.1 -sP 1 443
  • Scan OS
astsu -sO 192.168.1.1

License

This project is under the MIT License.