How gotr00t0day/gsec works
Project type and purpose
• This is a Python‐based, command‐line Web Security Scanner & Exploitation framework (“Gsec”).
• It orchestrates passive reconnaissance, active/aggressive scanning, signature‐based checks, custom exploit scripts and Nuclei integration to find web vulnerabilities.
File structure
• Entry point
• gsec.py – main CLI driver that parses arguments and invokes scans
• install.py – sets up prerequisites (e.g., clones nuclei templates)
• Configuration & Secrets
• core/.shodan – holds the Shodan API key
• Recon & Scanning Modules
• modules/ – high‐level scan routines (fetch_requests, scan orchestrator, URL→IP, subdomain output)
• utils/ – low‐level scanners (portscanner, crawler, header checks, fuzzers, OS detect, payload lists, etc.)
• Parsers & Reporting
• parsers/ – adapters for nmap and nuclei output
• Signature DB & Plugins
• vuln_db/ – vulnerability definitions (XSS, SSRF, open redirect, etc.)
• plugins/ – small checks (robots.txt, security.txt, user‐agent tests, favicon, cookies, tokens, shellshock, sitemap)
• Exploits
• exploits/ – proof‐of‐concept scripts (e.g., F5 BIG-IP scanner, Shellshock exploit)
• Wordlists & Tools
• wordlists/ – default wordlists for subdomain brute‐forcing, payloads, etc.
• tools/jaeles – optional integration
• Output
• output/ – directory where long results are saved (e.g., waybackurls.txt)
README for additional insights
• Summarizes features in three phases: Passive Scan, Normal/Aggressive Scan, Ultimate (Nuclei)
• Lists external dependencies: Python 3.11, Go (for Nuclei), certifi for SSL fix
• Describes usage patterns and how output is persisted
Essential architectural elements
• Plugin loader in CLI to emphasize extensibility