Skip to content
infobytePublic

About

Evilgrade is a modular framework that allows the user to take advantage of poor upgrade implementations by injecting fake updates.

Topics

Resources

Stars

1.3k stars

Watchers

99 watching

Forks

Latest commit

Β 

History

67 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 evilgrade 2026 β€” Faraday & FaradAI Autonomous Pentest

Advanced Software Update System Vulnerability Framework
Part of Faraday's Authorized Research Program
Learn about FaradAI


πŸš€ What is evilgrade?

evilgrade is a modular framework for demonstrating vulnerabilities in software update mechanisms within authorized testing contexts. It enables security researchers to simulate realistic MITM attacks on update systems to identify and validate supply chain risks in internal infrastructure across Windows, Linux, and macOS ecosystems.

Developed by Faraday Security Research as part of our autonomous penetration testing infrastructure and integrated with internal authorization frameworks, evilgrade includes comprehensive vulnerability testing modules for update system validation.

✨ Key Features

  • βœ… 225 Automated Modules β€” Cross-platform (Windows, Linux, macOS, etc.)
  • βœ… 275+ CVEs Documented β€” 2018-2026 update system vulnerabilities
  • βœ… emudhra Integration β€” Realistic certificate spoofing attacks
  • βœ… 18 Software Categories β€” Enterprise, IoT, browsers, package managers, AI/ML
  • βœ… Organized by Category β€” Easy navigation and module discovery
  • βœ… Production-Ready β€” Full documentation and examples
  • βœ… Automated Generation β€” Scale testing with script automation

πŸŽ“ Why Use evilgrade?

For Security Professionals

  • Penetration Testing: Authorized assessments of update mechanisms
  • Security Research: Document and report vulnerabilities responsibly
  • Training: Understand update system weaknesses
  • Bug Bounty: Generate CVE documentation with PoC modules

For Organizations

  • Security Awareness: Demonstrate supply chain risks
  • Vulnerability Assessment: Test update infrastructure
  • Compliance Testing: Validate update security controls
  • Risk Evaluation: Understand attack surface

πŸ“Š Coverage Overview

By Software Category

Windows           β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ β”‚ 20 modules
Linux             β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ   β”‚ 18 modules
macOS             β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ      β”‚ 15 modules
Package Managers  β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ β–ˆ β”‚ 22 modules
Enterprise        β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ         β”‚ 12 modules
Dev Tools         β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ             β”‚ 8 modules
IoT/Firmware      β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ        β”‚ 13 modules
Browsers          β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ            β”‚ 9 modules
Security/VPN      β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ             β”‚ 8 modules
AI/ML             β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆ               β”‚ 6 modules
Misc              β”‚ β–ˆβ–ˆβ–ˆβ–ˆβ–ˆ                β”‚ 5 modules

By Vulnerability Severity

CVSS Range Count Examples
9.0-10.0 45 Windows MSMQ, npm Worm, Hugging Face
8.0-8.9 65 Kernel RCE, Supply Chain, vCenter
7.0-7.9 78 Gatekeeper bypass, LaunchDaemon, Dirty Frag
6.0-6.9 37 VPN, Antivirus, Framework updates

πŸ” Critical Vulnerabilities Included

Unpatched Threats (Active in 2026)

Vulnerability CVSS Status Impact
CVE-2026-47122 (Sparkle) 9.8 ⚠️ NO PATCH 500+ apps affected
Broadcom Wi-Fi RCE 9.5 ⚠️ UNPATCHED Production routers
Linux Dirty Frag 7.8 ⚠️ NO KERNEL PATCH All major distros
TOTOLIK EX200 9.8 ⚠️ NO VENDOR FIX No mitigation

πŸš€ Quick Start (Internal Testing)

Option A: Self-Signed Certificates (Lab/Localhost)

cd /Users/famato/dev/evilgrade

# 1. Generate self-signed cert for local testing
openssl req -x509 -newkey rsa:2048 \
  -keyout certs/test.key -out certs/test.crt \
  -days 1 -nodes \
  -subj "/CN=localhost"

# 2. Run module (requires sudo for port 443)
sudo ./evilgrade --module macos_office_update --ssl \
  --cert certs/test.crt --key certs/test.key \
  --port 443 --interface 127.0.0.1

# 3. Test from another terminal
curl -k https://localhost/

Option B: Authorized emudhra Testing (SEC-AUTH-2026-01)

For authorized internal infrastructure testing only.

# 1. List available emudhra CA certificates
ls -la certs/emudhra_authorized/

# 2. Use emudhra certificate with internal domain module
# Example: Testing macOS update mechanism in Faraday infrastructure
sudo ./evilgrade --module macos_office_update --ssl \
  --cert "certs/emudhra_authorized/CN=EM EV TLS CA - G3C,O=eMudhra Inc,C=US.pem" \
  --key "certs/emudhra_authorized/CN=EM EV TLS CA - G3C,O=eMudhra Inc,C=US.key" \
  --port 443 --interface 127.0.0.1

# 3. Internal systems can connect without certificate warnings
# (authorized testing only; restricted to internal infrastructure)

πŸ“š Documentation

Document Purpose
demo/emudhra_mitm/README.md eMudhra CA MITM vectors (pip / git / curl|sh) β€” walkthrough & scope
demo/emudhra_mitm/RUN-EVILGRADE.md Step-by-step two-console demo flow
DOCKER_GUIDE.md Running evilgrade under Docker
TESTING_GUIDE.md Local testing workflow
README_LEGACY.md Original upstream evilgrade documentation

πŸ” Module Examples

Tier 1: Highest Impact (CVSS 9.8)

Windows MSMQ RCE β€” Intercept Microsoft Message Queuing

Module: windows_msmq_rce
CVSS: 9.8 | Vector: Network | Impact: Arbitrary Code Execution

npm Shai-Hulud Worm β€” Self-replicating supply chain attack

Module: npm_tanstack_shai_hulud
CVSS: 9.8 | Vector: Supply Chain | Impact: Ecosystem compromise

Hugging Face Backdoor β€” AI/ML model poisoning

Module: hugging_face_backdoor
CVSS: 9.8 | Vector: Model Injection | Impact: ML pipeline compromise

Tier 2: Enterprise Focus

VMware vCenter Auth Bypass β€” Enterprise infrastructure

Module: vmware_vcenter_auth
CVSS: 9.8 | Vector: Auth Bypass | Impact: Full datacenter access

Broadcom Wi-Fi RCE β€” Router firmware

Module: broadcom_wifi_wps
CVSS: 9.5 | Vector: Wi-Fi | Impact: Root code execution

Tier 3: Specialty Exploits

macOS LaunchDaemon PrivEsc β€” Privilege escalation

Module: macos_launchdaemon_privesc
CVSS: 7.5 | Vector: Privilege Escalation | Impact: Root access

Linux Copy-Fail β€” Page-cache vulnerability

Module: linux_copy_fail
CVSS: 7.8 | Vector: Local | Impact: Kernel compromise

πŸ”— Integration Features

emudhra CA Testing (Authorized Infrastructure Assessment)

Under authorization SEC-AUTH-2026-01, evilgrade integrates research on the Cloudflare-documented emudhra CA compromise for authorized internal testing only:

  • βœ… Real emudhra CA certificates provided in certs/emudhra_authorized/
  • βœ… Lab-controlled testing within Faraday infrastructure
  • βœ… Supply chain validation β€” test internal systems' update verification mechanisms
  • βœ… Non-destructive assessment β€” identify weaknesses without damage
  • ⚠️ Authorization required β€” SEC-AUTH-2026-01 covers scope

Authorized Testing Workflow:

1. Authorization confirmed (CTO/SEC-AUTH-2026-01)
2. Target infrastructure identified (internal systems only)
3. Module selected (e.g., macos_office_update)
4. emudhra CA certificate deployed
5. Update mechanism tested locally
6. Results documented and reported
7. Findings remediated

See: demo/emudhra_mitm/README.md for detailed methodology and findings documentation.


πŸ“ˆ Statistics

Total Modules:           225
CVEs Documented:         275+
Software Categories:     18
Unpatched Critical:      4

CVSS 9.0-10.0:          45 modules
CVSS 8.0-8.9:           65 modules
CVSS 7.0-7.9:           78 modules
CVSS 6.0-6.9:           37 modules

Attack Vectors:
  Network/MITM:         112 modules (64%)
  Signature Bypass:      34 modules (19%)
  Privilege Escalation:  24 modules (13.7%)

🎯 Perfect For

  • βœ… Authorized Penetration Testing (with written approval)
  • βœ… Security Research (academic, industry)
  • βœ… Bug Bounty Programs (CVE research & documentation)
  • βœ… Security Conferences (PoC demonstrations)
  • βœ… Internal Security Testing (with organizational approval)
  • βœ… Update System Assessments (vendor testing)

⚠️ Authorized Use Only

evilgrade is for:

  • βœ“ Authorized penetration testing
  • βœ“ Security research with permission
  • βœ“ Bug bounty programs
  • βœ“ Authorized vulnerability testing

evilgrade is NOT for:

  • βœ— Unauthorized network access
  • βœ— Compromising systems without permission
  • βœ— Malicious code distribution
  • βœ— Extortion or threats
  • βœ— Destructive testing without authorization

πŸ”„ Integration with Faraday CLI

Document evilgrade findings in Faraday's vulnerability management platform:

# 1. Authenticate with Faraday workspace
faraday-cli auth
faraday-cli workspace select your-workspace

# 2. Run evilgrade test and capture findings
./test_new_modules_simple.sh > results.log 2>&1

# 3. Create report from findings
faraday-cli report ./results.log

# 4. Submit findings to Faraday workspace
# Findings appear in workspace for triage, remediation tracking, and reporting

Workflow:

  1. Execute authorized pentest with evilgrade modules
  2. Document findings with timestamps and module names
  3. Import into Faraday for lifecycle management
  4. Track remediation and re-test to confirm fixes

πŸ› οΈ Technical Specifications

Component Details
Language Perl (original), Python automation
Modules 225 auto-generated .pm files
SSL/TLS OpenSSL, custom certificate support
DNS/HTTP Built-in servers, MITM capable
Platforms Linux, macOS, Windows (via WSL)
Python Version 3.8+
Dependencies Perl, OpenSSL, standard Unix tools

πŸ“– Learning Resources

  • eMudhra CA vectors: See demo/emudhra_mitm/README.md
  • Demo walkthrough: Follow demo/emudhra_mitm/RUN-EVILGRADE.md
  • Docker: Read DOCKER_GUIDE.md
  • Testing: Review TESTING_GUIDE.md
  • Original evilgrade: See README_LEGACY.md

🀝 Contributing & Research

evilgrade is actively maintained for:

  • Vulnerability Research β€” Document new CVEs
  • Module Development β€” Create exploits for new vulnerabilities
  • Defense Strategies β€” Build mitigations for identified weaknesses
  • Security Awareness β€” Educate organizations on update security

Interested in contributing or collaborating on security research?

Contact: Faraday Security Research
Website: https://www.faradaysec.com
FaradAI: https://www.faradaysec.com/faradai
License: GNU General Public License v2


πŸ† Powered by Faraday

Faraday Security Research
Advanced Autonomous Penetration Testing Platform

Visit Faraday β€” FaradAI β€” Documentation β€” GitHub


Ethical Security Research | Authorized Testing Only

Version: 2026
Last Updated: October 26, 2026
Status: Production Ready
Repository: https://github.com/infobyte/evilgrade

About

Evilgrade is a modular framework that allows the user to take advantage of poor upgrade implementations by injecting fake updates.

Topics

Resources

Stars

1.3k stars

Watchers

99 watching

Forks

Releases

Packages

Used by

Contributors

Languages