Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
add: simple port scanner
deniskhud2ab28e681dcd
diff --git a/PROJECTS/simple-port-scanner/CMakeLists.txt b/PROJECTS/simple-port-scanner/CMakeLists.txtnew file mode 100644index 00000000..8ded6f2f--- /dev/null+++ b/PROJECTS/simple-port-scanner/CMakeLists.txt@@ -0,0 +1,16 @@+cmake_minimum_required(VERSION 3.31)+project(simplePortScanner)++set(CMAKE_CXX_STANDARD 20)+find_package(Boost REQUIRED COMPONENTS program_options)++++add_executable(simplePortScanner main.cpp+ src/PortScanner.hpp+ src/PortScanner.cpp+ )++target_link_libraries(simplePortScanner+ Boost::program_options+)diff --git a/PROJECTS/simple-port-scanner/README.md b/PROJECTS/simple-port-scanner/README.mdnew file mode 100644index 00000000..bbfdbe84--- /dev/null+++ b/PROJECTS/simple-port-scanner/README.md@@ -0,0 +1,34 @@+# Simple Port Scanner (C++)++An asynchronous TCP port scanner implemented in C++ using boost::asio++## Features+- Configurable port ranges (e.g. 1-1024, 1-65535)+- Adjustable concurrency level+- Connection timeouts+- Clean and readable CLI output++## Educational Value+- Asynchronous IO using boost::asio+- TCP socket programming+- Concurrency control+- Basic network reconnaissance techniques++## Build++### Requirements+- C++20+- Boost library+- CMake >= 3.16++### Build Instructions+```bash+mkdir build && cd build+cmake ..+make+```+## Usage++```bash+./port_scanner -i 127.0.0.1 -p 1-1024 -t 100 -e 2+diff --git a/PROJECTS/simple-port-scanner/main.cpp b/PROJECTS/simple-port-scanner/main.cppnew file mode 100644index 00000000..47f146ff--- /dev/null+++ b/PROJECTS/simple-port-scanner/main.cpp@@ -0,0 +1,44 @@+#include "src/PortScanner.hpp"+#include <boost/program_options.hpp>+namespace po = boost::program_options;++int main(int argc, char* argv[]) {++ po::options_description desc("Allowed options");+ desc.add_options()+ ("help,h", "produce help message")+ ("dname,i", po::value<std::string>()->default_value("127.0.0.1"), "set domain name or IP address")+ ("ports,p", po::value<std::string>()->default_value("1-1024"), "set a port range from 1 to n")+ ("threads,t", po::value<int>()->default_value(100), "max concurrent threads")+ ("expiry_time,e", po::value<uint8_t>()->default_value(2)->value_name("sec"), "timeout in seconds")+ ("verbose,v", "verbose output");++ po::variables_map vm;+ po::store(po::parse_command_line(argc, argv, desc), vm);+ po::notify(vm);++ if (vm.count("help")) {+ std::cout << desc << "\n";+ std::cout << "Examples:\n"+ << " Scan common ports on localhost:\n"+ << " ./port_scanner -i 127.0.0.1 -p 1-1024\n\n"+ << " Full TCP port scan:\n"+ << " ./port_scanner -i 192.168.1.1 -p 65535 -t 200\n\n"+ << " Scan with custom timeout:\n"+ << " ./port_scanner -i example.com -p 80-443 -e 5\n\n"+ << " Postscriptum:\n"+ << " Scan only systems you own or have explicit permission to test.\n";+ return 0;+ }+ std::string ip = vm["dname"].as<std::string>();+ std::string port = vm["ports"].as<std::string>();+ int threads = vm["threads"].as<int>();+ uint8_t expiry_time = vm["expiry_time"].as<uint8_t>();++ PortScanner scanner;+ scanner.set_options(ip, port, threads, expiry_time);+ scanner.start();+ scanner.run();++ return 0;+}diff --git a/PROJECTS/simple-port-scanner/src/PortScanner.cpp b/PROJECTS/simple-port-scanner/src/PortScanner.cppnew file mode 100644index 00000000..cc34e927--- /dev/null+++ b/PROJECTS/simple-port-scanner/src/PortScanner.cpp@@ -0,0 +1,193 @@+#include "PortScanner.hpp"++const std::unordered_map<uint16_t, std::string> PortScanner::basicPorts{+ {21, "FTP"},+ {22, "SSH"},+ {23, "TelNet"},+ {25, "SMTP"},+ {53, "DNS"},+ {67, "DHCP server"},+ {68, "DHCP client"},+ {80, "HTTP"},+ {110, "POP3"},+ {143, "IMAP"},+ {161, "SNMP"},+ {443, "HTTPS"},+ {445, "SMB"},+ {465, "SMTPS"},+ {993, "IMAPS"},+ {1080, "SOCKS"},+ {1521, "ORACLE DB"},+ {3306, "MySQL"},+ {3389, "RDP"},+ {5432, "PostgreSQL"},+ {6379, "Redis"},+};++void PortScanner::parse_port(std::string& port) {+ auto t = std::find(port.begin(), port.end(), '-');+ if (t == port.end()) {+ startPort = 1;+ endPort = std::stoi(port);+ return;+ }+ auto it = port.begin();+ std::string s = "", e = "";+ while (it != port.end()) {+ if (*it == '-') {+ break;+ }+ s += *it;+ ++it;+ }+ ++it;+ while (it != port.end()) {+ e += *it;+ ++it;+ }++ int start = std::stoi(s);+ int end = std::stoi(e);+ //check a valid bounds+ if (start == 0 || end > MAX_PORT || start > end) {+ startPort = 1;+ endPort = MAX_PORT;+ }+ else {+ startPort = static_cast<uint16_t>(start);+ endPort = static_cast<uint16_t>(end);+ }+}+PortScanner::PortScanner(std::string& domainName, std::string& port, int max_threads, std::uint8_t expiry_time) {+ this->domainName = std::move(domainName);+ this->MAX_THREADS = max_threads;+ this->expiry_time = expiry_time;++ parse_port(port);+ auto result = resolver.resolve(this->domainName, "");+ endpoint = *result.begin();++ setup_queue();++}++void PortScanner::setup_queue() {+ q = std::queue<uint16_t>();+ for (int i = startPort; i <= endPort; i++) {+ q.push(i);+ }+}+++void PortScanner::set_options(std::string& domainName, std::string& port, int max_threads, std::uint8_t expiry_time) {+ this->domainName = std::move(domainName);+ this->MAX_THREADS = max_threads;+ this->expiry_time = expiry_time;+ parse_port(port);+++ auto result = resolver.resolve(this->domainName, "");+ endpoint = *result.begin();+++}++void PortScanner::set_max_port(std::uint16_t port) {+ endPort = port;+}+void PortScanner::set_max_threads(int value) {+ MAX_THREADS = value;+}++void PortScanner::set_ip_address(std::string ip) {+ domainName = std::move(ip);++}++void PortScanner::set_expiry_time(std::uint8_t value) {+ expiry_time = value;+}++void PortScanner::start() {+ setup_queue();+ for (int i = 0; i < MAX_THREADS; i++) {+ boost::asio::post(strand, [this]() {+ scan();+ });++ }+}++void PortScanner::run() {+ printf("PORT\tSTATE\tSERVICE\tBANNER\n");+ io.run();+ printf("\nResult:\n");+ printf(" Open ports: %d\n", open_ports);+ printf(" Closed ports: %d\n", closed_ports);+ printf(" Filtered ports: %d\n", filtered_ports);+}++void PortScanner::scan() {+ if (q.empty() || cnt >= MAX_THREADS) return;++ uint16_t port = q.front();+ q.pop();+ ++cnt;++ auto socket = std::make_shared<tcp::socket>(io);+ auto timer = std::make_shared<boost::asio::steady_timer>(io);+ auto complete = std::make_shared<bool>(false);++ tcp::endpoint endpoint(this->endpoint.address(), port);++ timer->expires_after(std::chrono::seconds(expiry_time));++ timer->async_wait(boost::asio::bind_executor(strand, [this, complete, socket, port](boost::system::error_code ec) {+ if (!ec && !*complete) {+ *complete = true;+ socket->close();+ printf("%i\t%s\t%s\t%s\n", port, "FILTERED", "NULL", "NULL");+ ++filtered_ports;+ --cnt;+ scan();+ }++ }));++ socket->async_connect(endpoint, boost::asio::bind_executor(strand, [this,socket, timer, port, complete](boost::system::error_code ec) {+ if (*complete) return;+ *complete = true;+ timer->cancel();++ std::string service = "---";+ auto banner = std::make_shared<std::string>("---");+ auto it = basicPorts.find(port);+ if (it != basicPorts.end()) {+ service = it->second;+ }++ if (!ec) {+ auto buf = std::make_shared<std::array<char, 128>>();++ socket->async_read_some(boost::asio::buffer(*buf),boost::asio::bind_executor(strand,+ [this, port, buf, banner, service](boost::system::error_code ec, std::size_t n) {+ if (!ec && n > 0) {+ banner->assign(buf->data(), n);+ }+ printf("%i\t%sOPEN%s\t%s\t%s\n", port, GREEN,RESET, service.c_str(), banner->c_str());+ ++open_ports;+ --cnt;+ scan();+ }));++ }+ else{+ printf("%i\t%sCLOSED%s\t%s\t%s\n", port, RED, RESET, service.c_str(), banner->c_str());+ ++closed_ports;+ --cnt;+ scan();+ }++ }));++}\ No newline at end of filediff --git a/PROJECTS/simple-port-scanner/src/PortScanner.hpp b/PROJECTS/simple-port-scanner/src/PortScanner.hppnew file mode 100644index 00000000..b41a7a68--- /dev/null+++ b/PROJECTS/simple-port-scanner/src/PortScanner.hpp@@ -0,0 +1,50 @@+#ifndef PORTSCANNER_HPP+#define PORTSCANNER_HPP+#include <boost/asio.hpp>+#include <bits/stdc++.h>+#define RED "\033[31m"+#define GREEN "\033[32m"+#define RESET "\033[0m"+using boost::asio::ip::tcp;+class PortScanner {+private:+ static const std::unordered_map<uint16_t, std::string> basicPorts;+ static const uint16_t MAX_PORT = 65535;+ boost::asio::io_context io;+ boost::asio::ip::tcp::resolver resolver{io};+ boost::asio::ip::tcp::endpoint endpoint;+ boost::asio::strand<boost::asio::io_context::executor_type> strand{io.get_executor()};+ std::queue<std::uint16_t> q;+ int cnt = 0;+ int MAX_THREADS = 0;+ int open_ports = 0;+ int closed_ports = 0;+ int filtered_ports = 0;++ std::string domainName;+ std::uint16_t startPort = 1;+ std::uint16_t endPort = MAX_PORT;++ std::uint8_t expiry_time;++ void scan();+ void setup_queue();+ void parse_port(std::string& port);+public:+ PortScanner(std::string& ip_address, std::string& port, int max_threads, std::uint8_t expiry_time);+ PortScanner(){}+ ~PortScanner() {++ }++ void set_options(std::string& domainName, std::string& port, int max_threads, std::uint8_t expiry_time);+ void set_max_port(std::uint16_t port);+ void set_max_threads(int value);+ void set_ip_address(std::string ip);+ void set_expiry_time(std::uint8_t value);++ void start();+ void run();+};++#endif //PORTSCANNER_HPP