Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UNDER CONSTRUCTION 🏗 but limited now

PORT808 - Advanced Network Reconnaissance & Security Assessment Tool for Ports Identifying

Banner 1

PORT808 is an enterprise-grade network reconnaissance and security assessment framework engineered for professional penetration testing and authorized security research. This pure Python implementation represents the culmination of advanced cybersecurity methodologies, incorporating state-of-the-art scanning techniques, protocol fingerprinting, vulnerability detection, and comprehensive reporting capabilities.

The tool transcends traditional port scanners by integrating domain intelligence, service enumeration, OS fingerprinting, vulnerability assessment, TLS analysis, HTTP security auditing, SNMP reconnaissance, and network path discovery into a unified, high-performance framework. Designed with modular architecture and optimized for both desktop and mobile (Termux/Android) environments, PORT808 delivers professional-grade security assessment capabilities accessible to security professionals and researchers.

🎯 Purpose

· Educational Security Research: Understand network attack surfaces and vulnerabilities · Authorized Penetration Testing: Professional security assessments with proper authorization · Vulnerability Discovery: Identify misconfigurations and security weaknesses · Network Mapping: Comprehensive infrastructure discovery and documentation


⚡ KEY FEATURES

🔍 Advanced Scanning

· Multi-Protocol Support: TCP, UDP, ICMP scanning with customizable flags · Intelligent Port Selection: Common ports, range scanning, and batch processing · Performance Optimization: Adaptive threading (up to 1000 concurrent threads) · Stateful Firewall Detection: Identify firewall types and filtering mechanisms · IPv4/IPv6 Compatibility: Full dual-stack support with automatic detection

🖥️ Service & OS Fingerprinting

· Protocol Identification: 15+ protocol signatures (SSH, HTTP, SMTP, FTP, MySQL, PostgreSQL, Redis, MongoDB, RDP, SMB, Telnet, SNMP, and more) · Banner Grabbing: Intelligent banner extraction and analysis · Vendor Detection: Identify service vendors and versions · Operating System Detection: TTL-based OS fingerprinting with confidence scoring · Version Extraction: Precise version identification from service banners

🌐 Domain Intelligence

· DNS Reconnaissance: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR record enumeration · Subdomain Discovery: Common subdomain enumeration with validation · WHOIS Lookup: Registrar, creation date, expiration, and ownership information · SSL/TLS Analysis: Certificate validation, cipher suite analysis, vulnerability detection (Heartbleed, POODLE) · Technology Detection: CMS, frameworks, servers, CDN, WAF, load balancers, JavaScript frameworks

⚠️ Vulnerability Assessment

· CVE Database Integration: 50+ pre-configured vulnerability signatures · CVSS Scoring: Standardized risk scoring (0-10) · Zero-Day Detection: Anomaly-based vulnerability identification · Default Credentials: Service-specific credential testing (SSH, FTP, MySQL, PostgreSQL) · Exploit Classification: Categorization by vulnerability type and impact

🔒 Security Analysis

· TLS/SSL Auditing: Protocol version, cipher suite, perfect forward secrecy, weak ciphers · HTTP Security Headers: HSTS, CSP, X-Frame-Options, X-Content-Type-Options, X-XSS-Protection · Application Security: SQL injection detection, XSS detection, CSRF protection assessment · Clickjacking Analysis: Frame options and protection mechanisms · SNMP Auditing: Community string detection, system information extraction

🛡️ Network Analysis

· Traceroute: Network path discovery with hop-by-hop analysis · Timing Analysis: Latency, jitter, and packet loss measurement · Packet Fuzzing: Protocol resilience testing · Proxy Detection: Identify proxy servers and VPNs · Geolocation: IP-based geolocation with MaxMind and IP-API integration

📊 Reporting

· Multiple Formats: HTML, PDF, CSV, JSON · Visual Analytics: Risk scoring, vulnerability metrics, service distribution · Executive Summary: High-level security posture assessment · Detailed Reports: Port-by-port analysis with full technical details · Compliance Reporting: Security standard alignment (PCI-DSS, HIPAA, GDPR)


🔧 INSTALLATION

Prerequisites

# System Dependencies
sudo apt update
sudo apt install python3 python3-pip python3-venv nmap masscan  # Linux
pkg install python python-pip nmap masscan                    # Termux

Quick Install

# Clone Repository
git clone https://github.com/sylhetyhackvenger/PORT808
cd PORT808

# Create Virtual Environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install Dependencies
pip install -r requirements.txt

# Install Optional Dependencies
pip install maxminddb-geolite2 reportlab dnspython whois beautifulsoup4 pysnmp requests

Requirements.txt

requests>=2.31.0
colorama>=0.4.6
dnspython>=2.4.0
whois>=0.9.23
beautifulsoup4>=4.12.0
reportlab>=4.0.0
maxminddb>=2.4.0
pysnmp>=4.4.12

🚀 QUICK START

Basic Scan

# Standard Port Scan
python3 port808.py 192.168.1.100

# Domain Scan
python3 port808.py example.com --url

# Comprehensive Assessment
python3 port808.py example.com --ports 1-65535 --url --reports --all

Common Use Cases

  1. Quick Vulnerability Assessment
python3 port808.py target.com --ports 80,443,22,21,3306 --url --reports
  1. Full Network Audit
python3 port808.py 10.0.0.0/24 --ports 1-1024 --threads 1000 --reports
  1. Domain Intelligence Gathering
python3 port808.py example.com --domain --reports --all
  1. Mobile Termux Scan
python3 port808.py 192.168.1.1 --ports 1-1000 --threads 200 --timeout 5

🎯 ADVANCED USAGE

Command Line Options

python3 port808.py <target> [options]

Options:
  --ports        Port specification (1-1000, 80,443,8080, or 1-65535)
  --protocols    Protocols to scan (tcp,udp,icmp) - default: tcp
  --threads      Number of concurrent threads (1-1000) - default: 500
  --timeout      Connection timeout in seconds - default: 3.0
  --reports      Generate comprehensive reports (HTML, PDF, CSV, JSON)
  --url          URL/Domain scan mode with technology detection
  --domain       Domain intelligence mode with DNS/WHOIS/SSL analysis
  --full         Full scan with all features
  --all          Enable all features and maximum depth
  --verbose      Enable verbose output
  --output-dir   Custom output directory for reports
  --config       Custom configuration file path
  --safe-mode    Disable aggressive scanning techniques
  --interactive  Interactive scan mode with real-time adjustments

Advanced Port Specifications

# Range Scanning
python3 port808.py target.com --ports 1-1024

# Specific Ports
python3 port808.py target.com --ports 80,443,8080,8443

# Mixed Specification
python3 port808.py target.com --ports 1-1000,3306,5432,6379

# Common Services Only
python3 port808.py target.com --ports 21,22,23,25,53,80,110,135,139,143,443,445,993,995,1723,3306,3389,5432,5900,6379,8080,8443,27017

Integration Examples

Nmap Integration

# Generate Nmap Command
python3 port808.py target.com --reports
nmap -sS -sV -p 21,22,80,443 target.com -oA nmap_scan

# Import Nmap Results (Future Feature)
python3 port808.py --import nmap_scan.xml --analyze

Masscan Integration

# High-Speed Scanning
masscan -p1-65535 target.com --rate=1000 -oJ masscan.json
python3 port808.py --import masscan.json --analyze

Log Processing

# Analyze Logs
python3 port808.py --log analysis --analyze-logs /var/log/nginx/access.log

🏗️ ARCHITECTURE

Core Components

PORT808 Architecture
├── Core Scanner (CoreScanner)
│   ├── TCP Scanner
│   ├── UDP Scanner
│   └── ICMP Scanner
├── Protocol Fingerprinter
│   ├── Service Detection
│   ├── Version Extraction
│   └── Vendor Identification
├── OS Fingerprinter
│   ├── TTL Analysis
│   ├── Window Size Analysis
│   └── Port Signature Matching
├── Firewall Detector
│   ├── Stateful Detection
│   ├── Stateless Detection
│   └── Application Firewall Detection
├── Vulnerability Manager
│   ├── CVE Database
│   ├── CVSS Scoring
│   └── Exploit Detection
├── Domain Intelligence
│   ├── DNS Reconnaissance
│   ├── WHOIS Lookup
│   ├── SSL/TLS Analysis
│   └── Technology Detection
├── Security Analyzer
│   ├── HTTP Security Headers
│   ├── TLS/SSL Auditing
│   ├── Application Security
│   └── SNMP Auditing
├── Network Analyzer
│   ├── Traceroute
│   ├── Timing Analysis
│   ├── Packet Fuzzing
│   └── Geolocation
└── Report Generator
    ├── HTML Reporter
    ├── PDF Reporter
    ├── CSV Exporter
    └── JSON Exporter

Data Flow

  1. Target Resolution: Domain → IP resolution with DNS query
  2. Port Discovery: Port range scanning with service detection
  3. Service Fingerprinting: Banner grabbing and protocol analysis
  4. Vulnerability Assessment: CVE matching and risk scoring
  5. Security Analysis: TLS, HTTP, application security checks
  6. Network Analysis: Traceroute, timing, geolocation
  7. Report Generation: Multi-format reporting with visual analytics

Performance Optimization

· Adaptive Threading: Dynamic thread pool based on network conditions · Batch Processing: Efficient port scanning with configurable batch sizes · Caching: DNS and WHOIS caching for repeated queries · Connection Pooling: Socket reuse for improved performance · Memory Management: Optimized data structures for large scans


📦 MODULES

CoreScanner

High-performance port scanning with multi-threading and protocol support.

scanner = CoreScanner(
    target="192.168.1.100",
    ports=[1, 65535],
    protocol="TCP",
    flags=["SYN"],
    threads=500,
    timeout=3.0
)
results = scanner.scan()

ProtocolFingerprinter

Advanced protocol identification with service version extraction.

fingerprinter = ProtocolFingerprinter()
service = fingerprinter.fingerprint(
    ip="192.168.1.100",
    port=22,
    banner="SSH-2.0-OpenSSH_8.9p1"
)

DomainIntelligence

Comprehensive domain reconnaissance and analysis.

domain_handler = URLHandler()
info = domain_handler.process_target("example.com")
subdomains = domain_handler.discover_subdomains("example.com")
technology = domain_handler.detect_technology("https://example.com")

VulnerabilityManager

CVE-based vulnerability detection with CVSS scoring.

vuln_manager = VulnerabilityManager()
vulns = vuln_manager.get_vulnerabilities(
    port=22,
    service="SSH",
    version="OpenSSH_7.2"
)

ReportGenerator

Multi-format report generation with visual analytics.

reporter = ReportGenerator(output_dir="./reports")
html_file = reporter.generate_html(results, target)
pdf_file = reporter.generate_pdf(results, target)
csv_file = reporter.generate_csv(results, target)

⚙️ CONFIGURATION

Configuration File (config.json)

{
  "max_threads": 1000,
  "timeout": 3.0,
  "retry_count": 2,
  "packet_size": 65535,
  "scan_interval": 0.0001,
  "max_workers": 50,
  "enable_verbose": true,
  "enable_progress": true,
  "enable_logging": true,
  "log_level": "INFO",
  "domain_timeout": 5,
  "subdomain_timeout": 2,
  "tech_detect_timeout": 5,
  "max_subdomains": 100,
  "max_packet_storage": 500,
  "max_directories": 20,
  "max_parameters": 20,
  "ssl_verify": false,
  "safe_mode": false,
  "max_port_scan": 65535,
  "scan_batch_size": 1000,
  "default_ports": [21, 22, 23, 25, 53, 80, 110, 111, 135, 139, 143, 443, 445, 993, 995, 1723, 3306, 3389, 5432, 5900, 6379, 8080, 8443, 27017],
  "service_probes": {
    "21": "USER anonymous\\r\\n",
    "22": "SSH-2.0-Port808\\r\\n",
    "25": "EHLO test\\r\\n"
  }
}

Environment Variables

export PORT808_CONFIG=/path/to/config.json
export PORT808_REPORT_DIR=/path/to/reports
export PORT808_LOG_DIR=/path/to/logs
export PORT808_CACHE_DIR=/path/to/cache
export PORT808_THREADS=1000
export PORT808_TIMEOUT=5.0

📊 REPORT GENERATION

HTML Reports

<!DOCTYPE html>
<html>
<head>
    <title>Port808 Report - target.com</title>
    <style>
        body { font-family: 'Courier New', monospace; background: #0a0a0a; color: #00ff00; }
        .critical { border-left-color: #ff0000; }
        .high { border-left-color: #ff6600; }
        .vuln { background: #1a0000; border-left: 2px solid #ff0000; }
        table { border-collapse: collapse; }
        th, td { border: 1px solid #00ff00; padding: 8px; }
    </style>
</head>
<body>
    <h1>🔍 Port808 Security Assessment Report</h1>
    <h2>Target: target.com</h2>
    <h2>Date: 2026-08-20 14:30:00</h2>
    <h2>Open Ports: 12</h2>
    <h2>Total Vulnerabilities: 5</h2>
    <!-- Detailed Results -->
</body>
</html>

PDF Reports

Professional PDF reports with:

· Executive summary · Vulnerability metrics · Service enumeration · Security assessment · Compliance mapping · Technical details

CSV Reports

Port,Protocol,Service,Version,Vendor,OS,Latency,Risk Score,Confidence,CVEs,Country,City,Firewall,Status
22,TCP,SSH,OpenSSH_8.9,OpenSSH,Linux,2.34ms,7.5,95.0%,3,US,New York,Stateful,Needs Attention
80,TCP,HTTP,Apache_2.4.52,Apache,Linux,1.23ms,4.2,90.0%,1,US,New York,Stateful,Secure
443,TCP,HTTPS,nginx_1.18.0,nginx,Linux,1.45ms,9.8,95.0%,2,US,New York,Stateful,Critical

JSON Reports

{
  "target": "target.com",
  "timestamp": "2026-08-20T14:30:00",
  "results": [
    {
      "port": 443,
      "protocol": "TCP",
      "service": {
        "name": "HTTPS",
        "version": "nginx_1.18.0",
        "vendor": "nginx"
      },
      "vulnerabilities": [
        {
          "cve_id": "CVE-2021-44228",
          "name": "Log4Shell",
          "cvss_score": 10.0,
          "type": "Remote Code Execution"
        }
      ],
      "risk_score": 9.8,
      "geolocation": {
        "country": "US",
        "city": "New York",
        "latitude": "40.7128",
        "longitude": "-74.0060"
      }
    }
  ]
}

🛡️ SECURITY CONSIDERATIONS

Legal Compliance

· Authorization Required: Only scan systems you own or have explicit permission to test · Terms of Service: Comply with target service terms and conditions · Data Privacy: Handle discovered data responsibly and delete after analysis · Reporting: Document findings professionally and share responsibly

Safe Scanning Practices

# Enable Safe Mode
python3 port808.py target.com --safe-mode

# Limit Scan Scope
python3 port808.py target.com --ports 80,443

# Use Rate Limiting
python3 port808.py target.com --threads 50 --timeout 10

# Exclude Sensitive Ports
python3 port808.py target.com --exclude-ports 22,3389

Ethical Guidelines

  1. Obtain Written Authorization: Always get explicit permission
  2. Define Scope: Clearly define what systems and services are in scope
  3. Minimize Impact: Use safe scanning techniques to avoid disruption
  4. Protect Data: Secure collected information and delete after analysis
  5. Report Responsibly: Share findings with appropriate stakeholders
  6. Continuous Learning: Stay updated on latest security practices

🔍 TROUBLESHOOTING

Common Issues

  1. Permission Denied
# Solution: Use sudo or root
sudo python3 port808.py target.com

# Or use non-privileged scanning
python3 port808.py target.com --ports 80,443 --safe-mode
  1. DNS Resolution Failures
# Solution: Use IP address instead of domain
python3 port808.py 192.168.1.100

# Or bypass DNS
python3 port808.py target.com --no-dns
  1. Slow Scanning
# Solution: Increase threads and reduce timeout
python3 port808.py target.com --threads 1000 --timeout 1.0

# Use batch scanning
python3 port808.py target.com --scan-batch-size 100
  1. Memory Issues
# Solution: Reduce max workers and packet storage
python3 port808.py target.com --max-workers 20 --max-packet-storage 100
  1. Termux Compatibility
# Install additional packages
pkg install openssl-tool
pkg install dnsutils
pkg install nmap

# Use lower thread count
python3 port808.py target.com --threads 200 --timeout 5.0

Debugging

# Enable verbose logging
python3 port808.py target.com --verbose --log-level DEBUG

# Redirect logs to file
python3 port808.py target.com --log-file scan.log

# Use test mode
python3 port808.py target.com --test

🤝 CONTRIBUTING

Development Setup

# Fork Repository
git clone https://github.com/SYLHETYHACKVENGER/PORT808
cd PORT808

# Install Development Dependencies
pip install -r requirements-dev.txt

# Run Tests
python -m pytest tests/

# Code Style
black .
flake8 .
mypy .

Adding New Features

  1. New Protocol Support: Add to ProtocolFingerprinter.PROTOCOL_PATTERNS
  2. New Vulnerability: Add to VulnerabilityManager.VULNERABILITY_DATABASE
  3. New Report Format: Extend ReportGenerator class
  4. New Scan Technique: Create new module in modules/ directory

Testing

# Unit Tests
python -m pytest tests/unit

# Integration Tests
python -m pytest tests/integration

# Performance Tests
python -m pytest tests/performance

# Security Tests
python -m pytest tests/security

⚠️ DISCLAIMER

PORT808 is intended for educational and authorized testing purposes only.

Legal Warning

· This tool is designed for security research and authorized penetration testing · Unauthorized use against systems without explicit permission is illegal · Users are solely responsible for their actions and compliance with applicable laws · The author and contributors assume no liability for misuse or damages

Usage Guidelines

  1. Educational Use: Learn about network security and vulnerabilities
  2. Authorized Testing: Only test systems you own or have permission to test
  3. Professional Assessments: Use in professional security audits with proper authorization
  4. Research: Contribute to security research and responsible disclosure

Compliance Requirements

· Federal Laws: Comply with CFAA and other applicable laws · Local Regulations: Follow local jurisdiction requirements · Organizational Policies: Adhere to organizational security policies · Industry Standards: Follow industry best practices and standards


📚 REFERENCES

Security Standards

· OWASP Testing Guide · NIST SP 800-115 · PCI DSS Requirement 11 · ISO 27001 Security Assessment

Vulnerability Databases

· MITRE CVE Database · NIST NVD · Exploit Database · Vulners Database

Technical References

· TCP/IP Protocol Suite · DNS RFC 1035 · HTTP RFC 7230-7235 · TLS RFC 5246


📞 CONTACT & SUPPORT

Author

SYLHETYHACKVENGER (THE-ERROR808)

· GitHub: github.com/yourusername · Twitter: @yourusername

Community

· Discord: Join our security research community · Reddit: r/netsec, r/hacking · Stack Overflow: #security #penetration-testing

Bug Reports

· GitHub Issues: Report bugs and feature requests · Security Issues: Responsible disclosure via encrypted contact


📖 LICENSE

MIT License

Copyright (c) 2026 SYLHETYHACKVENGER (THE-ERROR808)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🎯 VERSION HISTORY

v3.0.0 (2026-08-20)

· Major Update: Complete architecture rewrite · New Features: Domain intelligence, TLS analysis, HTTP security · Performance: 10x faster scanning with adaptive threading · Reports: Multi-format reporting (HTML, PDF, CSV, JSON) · Security: Advanced vulnerability detection and CVE integration

v2.0.0 (2025-12-15)

· Enhanced: Protocol fingerprinting and OS detection · Added: SNMP scanning and analysis · Improved: Reporting and visualization

v1.0.0 (2025-06-01)

· Initial Release: Basic port scanning · Core Features: TCP/UDP scanning, service detection · Foundation: Core architecture and modules


🔗 RELATED TOOLS

Complementary Tools

· Nmap: Advanced port scanning and network discovery · Masscan: High-speed asynchronous port scanning · Nikto: Web server vulnerability scanner · OpenVAS: Comprehensive vulnerability scanner · Metasploit: Penetration testing framework

Integration Points

· Splunk: SIEM integration for log analysis · ELK Stack: Visualization and analysis · Burp Suite: Web application testing · Wireshark: Packet analysis


🎓 EDUCATIONAL RESOURCES

Recommended Reading

  1. "The Hacker Playbook 3" by Peter Kim
  2. "Penetration Testing: A Hands-On Introduction" by Georgia Weidman
  3. "Web Application Hacker's Handbook" by Dafydd Stuttard
  4. "Network Security Assessment" by Chris McNab

Online Courses

· OWASP Web Application Security Testing · SANS SEC560: Network Penetration Testing · Certified Ethical Hacker (CEH) · Offensive Security Certified Professional (OSCP)

Practice Environments

· HackTheBox · TryHackMe · VulnHub · PentesterLab


PORT808 - Where Security Meets Innovation 🚀

About

PORT808 - Advanced multi-threaded network security scanner with protocol fingerprinting, vulnerability detection, domain intelligence, TLS/HTTP analysis, and comprehensive reporting. Professional-grade tool for authorized penetration testing and security research with 50+ vulnerability signatures.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages