
Evilgrade is a modular framework that allows the user to take advantage of poor upgrade implementations by injecting fake updates.
Advanced Software Update System Vulnerability Framework
Part of Faraday's Authorized Research Program
Learn about FaradAI
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.
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
| 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 |
| 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 |
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/
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)
| 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 |
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
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
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
Under authorization SEC-AUTH-2026-01, evilgrade integrates research on the Cloudflare-documented emudhra CA compromise for authorized internal testing only:
certs/emudhra_authorized/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.
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%)