Skip to content

yunusemre-uzun/port-scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This project aims to apply nmap port scanner with a web UI.

How to run:

1. Dependencies: Docker, docker-compose, Kafka
2. Steps:

  * Clone the project
  * Run 'docker-compose up kafka elasticsearch'
  * Wait for kafka and elastic seatch to settle
  * Run '/scripts/kafka_partition.sh' to create kafka partitions. You may need to specify kafka 
  binary in your system
  * Run 'docker-compuse up elk scanner web-server
  * Open localhost:8085 on your browser
3. Run:
  * Type for host eg(192.168.1.1) or net mask (192.168.1.0/24)
  * Select single port, port range or all ports
  * Type arguments(If OS detection is choosen arguments will be inefective)
  * Enable/Disable OSDetection

Components:

1. WebServer: It is a simple flask server to supply a UI to user to select scan criterias, 
list scan history, show previous scans in JSON format.
2. Scanner: Multithreaded nmap scan controller
3. Elasticsearch: Elasticsearch controller to index scan results that comes from the scanner to the elasticsearch.
4. Kafka: Kafka is used as message broker between components.
5. Dockerized components are used to make the project compatible between diffrenet platforms.

About

Multithreaded port scanner with web server

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published