How skerkour/black-hat-rust works
Black Hat Rust is a book-length collection of independent Rust examples for offensive security, not one integrated application. Its documented learning arc covers reconnaissance, exploitation, phishing, and implant development. The graph highlights the scanner and agent workflows visible in excerpts, while retaining major unsampled capabilities as chapter-level subsystems. Chapter relationships are documented in the README; source-level links are limited to relationships shown by the supplied excerpts and SOURCE INDEX.
Main entry points: cli.rs Scanner CLI · run.rs Remote agent · src/main.rs Control server · src/main.rs Async scanner
Components 26
Reconnaissance
- Scanner CLI
ch_04/tricoder/src/cli.rs - DNS discovery
ch_04/tricoder/src/dns.rs - Port scanning
ch_04/tricoder/src/ports.rs - Common ports
ch_04/tricoder/src/common_ports.rs - Scan modules
ch_04/tricoder/src/modules - Async scanner
ch_03/tricoder/src/main.rs - Subdomain enumeration
ch_03/tricoder/src/subdomains.rs - Web crawler
ch_05/crawler/src/crawler.rs - Crawler spiders
ch_05/crawler/src/spiders
Exploitation
- Fuzzing
ch_06/fuzzing/src/lib.rs - Exploit examples
ch_07/exploits - Shellcode examples
ch_08
Phishing
- Phishing web app
ch_09/phishing/webapp - Phishing server
ch_09/phishing/server/src/main.rs - Email delivery
ch_09/emails/src/main.rs
Implant development
- Remote agent
ch_11/agent/src/run.rs - Operator client
ch_11/client/src/main.rs - Control server
ch_11/server/src/main.rs - Server services
ch_11/server/src/service - Server persistence
ch_11/server/src/repository - Shared protocol
ch_11/common/src/api.rs - Message encryption
ch_11/common/src/crypto.rs - Cross-platform install
ch_12/rat/agent/src/install - Worm spreading
ch_13/rat/agent/src/spread.rs
Supporting examples
- Email templates
ch_09/emails/src/template.rs
Other components
- Tool operator
Connections 21
- Tool operator → Scanner CLI: runs scan
- Scanner CLI → DNS discovery: discovers hosts
ch_04/tricoder/src/cli.rs - Scanner CLI → Port scanning: scans ports
ch_04/tricoder/src/cli.rs - Scanner CLI → Scan modules: dispatches modules
ch_04/tricoder/src/cli.rs - Tool operator → Async scanner: runs scan
ch_03/tricoder/src/main.rs - Async scanner → Subdomain enumeration: enumerates domains
ch_03/tricoder/src/main.rs - Tool operator → Web crawler: selects spider
- Web crawler → Crawler spiders: runs spider
ch_05/crawler/src/main.rs - Fuzzing → Exploit examples: finds vulnerabilities
README.md - Exploit examples → Shellcode examples: develops payloads
- Phishing web app → Phishing server: submits login
- Email templates → Email delivery: renders message
ch_09/emails/src/main.rs - Tool operator → Operator client: issues commands
README.md - Operator client → Control server: sends requests
README.md - Control server → Server services: dispatches operations
ch_11/server/src/main.rs - Server services → Server persistence: uses persistence
- Remote agent → Control server: communicates remotely
README.md - Remote agent → Shared protocol: uses protocol
- Message encryption → Shared protocol: secures messages
README.md - Cross-platform install → Remote agent: installs agent
README.md - Worm spreading → Remote agent: extends reach
README.md