Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marco-lancini/goscan

Interactive Network Scanner
https://github.com/marco-lancini/goscan

docker golang nmap pentesting

Last synced: 2 days ago
JSON representation

Interactive Network Scanner

Awesome Lists containing this project

README 

        



**GoScan** is an interactive network scanner client, featuring auto-completion, which provides abstraction and automation over nmap.



Although it started as a small side-project I developed in order to learn [@golang](https://twitter.com/golang), GoScan can now be used to perform host discovery, port scanning, and service enumeration not only in situations where being stealthy is not a priority and time is limited (think at CTFs, OSCP, exams, etc.), but also (with a few tweaks in its configuration) during professional engagements.



GoScan is also particularly suited for unstable environments (think unreliable network connectivity, lack of "`screen`", etc.), given that it fires scans and maintain their state in an SQLite database. Scans run in the background (detached from the main thread), so even if connection to the box running GoScan is lost, results can be uploaded asynchronously (more on this below). That is, data can be imported into GoScan at different stages of the process, without the need to restart the entire process from scratch if something goes wrong.



In addition, the Service Enumeration phase integrates a collection of other tools (e.g., `EyeWitness`, `Hydra`, `nikto`, etc.), each one tailored to target a specific service.



![demo](https://raw.githubusercontent.com/marco-lancini/goscan/master/.github/demo.gif)



# Installation



#### Binary installation (Recommended)



Binaries are available from the [Release](https://github.com/marco-lancini/goscan/releases) page.



```bash

# Linux (64bit)

$ wget https://github.com/marco-lancini/goscan/releases/download/v2.4/goscan_2.4_linux_amd64.zip

$ unzip goscan_2.4_linux_amd64.zip



# Linux (32bit)

$ wget https://github.com/marco-lancini/goscan/releases/download/v2.4/goscan_2.4_linux_386.zip

$ unzip goscan_2.4_linux_386.zip



# After that, place the executable in your PATH

$ chmod +x goscan

$ sudo mv ./goscan /usr/local/bin/goscan

```



#### Build from source



```bash

# Clone and spin up the project

$ git clone https://github.com/marco-lancini/goscan.git

$ cd goscan/

$ docker-compose up --build

$ docker-compose run cli /bin/bash



# Initialize DEP

root@cli:/go/src/github.com/marco-lancini/goscan $ make init

root@cli:/go/src/github.com/marco-lancini/goscan $ make setup



# Build

root@cli:/go/src/github.com/marco-lancini/goscan $ make build



# To create a multi-platform binary, use the cross command via make

root@cli:/go/src/github.com/marco-lancini/goscan $ make cross

```



# Usage



GoScan supports all the main steps of network enumeration:



![process](https://raw.githubusercontent.com/marco-lancini/goscan/master/.github/goscan_process.png)



| Step | Commands |

| ---- | ----------- |

| 1. **Load targets**   | 
    

  • Add a single target via the CLI (must be a valid CIDR): `load target SINGLE `
    • 

  • Upload multiple targets from a text file or folder: `load target MULTI `
    • 

|

| 2. **Host Discovery** | 
    

  • Perform a Ping Sweep: `sweep  `
    • 

  •   Or load results from a previous discovery:
      

    • Add a single alive host via the CLI (must be a /32): `load alive SINGLE `
      • 

    • Upload multiple alive hosts from a text file or folder: `load alive MULTI `
      • 

    

    • 

 |

| 3. **Port Scanning** | 
    

  • Perform a port scan: `portscan  `
    • 

  • Or upload nmap results from XML files or folder: `load portscan `
    • 

 |

| 4. **Service Enumeration** | 
    

  • Dry Run (only show commands, without performing them): `enumerate  DRY `
    • 

  •  Perform enumeration of detected services: `enumerate   `
    • 

 |

| 5. **Special Scans** | 
    

  • *EyeWitness*
      

    • Take screenshots of websites, RDP services, and open VNC servers (KALI ONLY): `special eyewitness`
      • 

    • `EyeWitness.py` needs to be in the system path
      • 

    

    • 

  • *Extract (Windows) domain information from enumeration data*
    • `special domain `
    

    • 

  • *DNS*
      

    • Enumerate DNS (nmap, dnsrecon, dnsenum): `special dns DISCOVERY `
      • 

    • Bruteforce DNS: `special dns BRUTEFORCE `
      • 

    • Reverse Bruteforce DNS: `special dns BRUTEFORCE_REVERSE  `
      • 

    

    •  |

    | **Utils** | 
      

    • Show results: `show `
      • 

    • Automatically configure settings by loading a config file: `set config_file `
      • 

    • Change the output folder (by default `~/goscan`): `set output_folder `
      • 

    • Modify the default nmap switches: `set nmap_switches  `
      • 

    • Modify the default wordlists: `set_wordlists  `
      • 

     |
    


    ## External Integrations
    


    The _Service Enumeration_ phase currently supports the following integrations:
    


    | WHAT | INTEGRATION |

    | ---- | ----------- |

    | ARP  | 
    • nmap
     |

    | DNS  | 
      

    • nmap
      • 

    • dnsrecon
      • 

    • dnsenum
      • 

    • host
      • 

     |

    | FINGER  | 
      

    • nmap
      • 

    • finger-user-enum
      • 

     |

    | FTP  | 
      

    • nmap
      • 

    • ftp-user-enum
      • 

    • hydra [AGGRESSIVE]
      • 

     |

    | HTTP | 
      

    • nmap
      • 

    • nikto
      • 

    • dirb
      • 

    • EyeWitness
      • 

    • sqlmap [AGGRESSIVE]
      • 

    • fimap [AGGRESSIVE]
      • 

     |

    | RDP  | 
      

    • nmap
      • 

    • EyeWitness
      • 

     |

    | SMB  | 
      

    • nmap
      • 

    • enum4linux
      • 

    • nbtscan
      • 

    • samrdump
      • 

     |

    | SMTP | 
      

    • nmap
      • 

    • smtp-user-enum
      • 

     |

    | SNMP | 
      

    • nmap
      • 

    • snmpcheck
      • 

    • onesixtyone
      • 

    • snmpwalk
      • 

     |

    | SSH  | 
    • hydra [AGGRESSIVE]
     |

    | SQL  | 
    • nmap
     |

    | VNC  | 
    • EyeWitness
     |
    


    # License
    


    GoScan is released under a MIT License. See the `LICENSE` file for full details.