How grayddq/gscan works
Project type and purpose
• GScan is a command‑line, plugin‑based Linux host security scanning tool.
• Its goal is to automate a comprehensive “checklist” of intrusion‐forensic and security checks (file integrity, process anomalies, network connections, backdoors, rootkits, webshells, etc.) and aggregate results to reconstruct an attacker’s path.
File structure
• Top‑level:
• GScan.py – the main entrypoint/CLI driver
• db/ – on‑disk state (e.g., previous scan hashes)
• lib/:
• core/ – common utilities, argument parsing, global variables, data aggregation, IP geolocation
• egg/ – bundled Yara Python extensions for malware signature matching
• malware/ – flat text library of 100K+ malware signatures
• plugins/ – discrete scan modules (Host_Info, File_Analysis, Network_Analysis, etc.) and accompanying webshell Yara rules
• pic/ – screenshots for documentation
• log/ (created at runtime) – scan logs and final aggregated report
README for additional insights
• Lists 12 major categories of checks, each mapping to one or more plugin modules.
• Emphasizes Yara for signature matching and CentOS+Python2/3 compatibility.
• Mentions output directories and scheduling support for cron jobs.