How adamlbs/dohexftlk works
DoHExfTlk is a research toolkit for exercising DNS-over-HTTPS exfiltration and studying its detection. The main workflow configures and runs a client to encode and send file chunks as DoH queries; the server-side interceptor observes traffic and the exfiltration server reconstructs captured data. Separately, captured traffic is analyzed behaviorally and classified with trained ML models, with a threshold-based DoHxP detector as another analysis capability. The README documents infrastructure and analysis links not implemented in the sampled source; those relationships are cited as documented rather than source-verified.
Main entry points: predictor.py ML Predictor · run_client.py Scenario Runner · client.py DoH Exfiltration Client · models Trained Models
Components 20
Exfiltration Client
- Scenario Runner
exfiltration/client/run_client.py - JSON Config Loader
exfiltration/client/json_config_loader.py - Config Generator
exfiltration/client/config_generator.py - DoH Exfiltration Client
exfiltration/client/client.py
DoH Infrastructure
- TLS Proxy
- DoH Server
- DNS Resolver
resolver/unbound.conf
Capture And Reconstruction
- Traffic Capture
traffic_analyzer - DoH Interceptor
exfiltration/server/traffic_interceptor.py - Exfiltration Server
exfiltration/server/server.py - Reconstructed Files
Detection And Analysis
- DoHLyzer Flow Analysis
- Pattern Analysis
classifier/dohxp/detect_dohxp.py - Detection CSV Filter
exfiltration/client/filter_detection_csv.sh - ML Trainer
ml_analyzer/model_trainer.py - ML Predictor
ml_analyzer/predictor.py - DoHxP Trainer
classifier/train_classifier.py - DoHxP Evaluator
classifier/dohxp/evaluate_dohxp.py - Trained Models
models
Other components
- Operator
Connections 20
- Operator → Scenario Runner: runs scenario
README.md - Scenario Runner → JSON Config Loader: loads settings
exfiltration/client/run_client.py - Scenario Runner → DoH Exfiltration Client: starts transfer
exfiltration/client/run_client.py - JSON Config Loader → DoH Exfiltration Client: builds config
exfiltration/client/json_config_loader.py - Operator → Config Generator: creates config
README.md - DoH Exfiltration Client → TLS Proxy: sends HTTPS DoH
README.md - TLS Proxy → DoH Server: forwards queries
README.md - DoH Server → DNS Resolver: sends DNS query
README.md - Traffic Capture → DoHLyzer Flow Analysis: provides traffic
README.md - Traffic Capture → Pattern Analysis: provides flows
README.md - DoHLyzer Flow Analysis → ML Predictor: provides flow data
README.md - Pattern Analysis → ML Predictor: provides findings
- ML Predictor → Trained Models: loads models
ml_analyzer/predictor.py - ML Trainer → Trained Models: saves models
README.md - DoHxP Trainer → Trained Models: trains classifier
- Detection CSV Filter → ML Predictor: filters input
README.md - Operator → DoH Interceptor: monitors traffic
README.md - DoH Interceptor → Exfiltration Server: dispatches queries
exfiltration/server/server.py - Exfiltration Server → Reconstructed Files: reconstructs files
README.md - Operator → DoHxP Evaluator: evaluates flows