How blacklanternsecurity/bbot works
BBOT is a modular reconnaissance and attack-surface scanner. Users provide targets and presets through the CLI or Python API; a scan prepares its preset, seeds events, and runs modules that discover and enrich assets. Results are streamed as events or handled by output modules, with JSON and many other destinations documented. The graph preserves major discovery, web-scanning, and output capabilities. Several runtime connections are inferred from the architecture but were not visible in the excerpts, so those edges are dashed and uncited.
Main entry points: event/base.py Scan events · scanner.py Scanner API · preset.py Preset setup · modules/base.py Module runtime
Components 23
Scan entry
- Command line
bbot/cli.py - Scanner API
bbot/scanner/scanner.py - Preset setup
bbot/scanner/preset/preset.py - Preset validation
bbot/scanner/preset/validate.py
Scan runtime
- Scan manager
bbot/scanner/manager.py - Event dispatcher
bbot/scanner/dispatcher.py - Module registry
bbot/core/modules.py - Module runtime
bbot/modules/base.py
Discovery modules
- DNS discovery
bbot/core/helpers/dns/dns.py - DNS enumeration
bbot/modules/dnsbrute.py - Internal analysis
bbot/modules/internal - Asset enrichment
bbot/modules
Web analysis
- HTTP crawling
bbot/modules/http.py - Web helpers
bbot/core/helpers/web/web.py - Web fuzzing
bbot/modules/lightfuzz/lightfuzz.py - Fuzz submodules
bbot/modules/lightfuzz/submodules/base.py
Events and models
- Scan events
bbot/core/event/base.py - Event model
bbot/models/pydantic.py - Configuration schema
bbot/core/config/models.py
Output modules
- Output runtime
bbot/modules/output/base.py - JSON output
bbot/modules/output/json.py - Other destinations
bbot/modules/output
Other components
- Scan user
Connections 23
- Scan user → Command line: runs scan
- Scan user → Scanner API: starts scan
- Command line → Scanner API: launches
bbot/cli.py - Scanner API → Preset setup: loads preset
bbot/scanner/scanner.py - Preset setup → Preset validation: validates
bbot/scanner/preset/preset.py - Scanner API → Scan manager: coordinates
bbot/scanner/scanner.py - Scanner API → Event dispatcher: dispatches through
bbot/scanner/scanner.py - Scanner API → Scan events: creates events
bbot/scanner/scanner.py - Scan manager → Module runtime: inherits from
bbot/scanner/manager.py - Preset setup → Module registry: loads modules
bbot/scanner/preset/preset.py - Module runtime → Scan events: queues events
- DNS enumeration → DNS discovery: uses resolver
- HTTP crawling → Web helpers: uses web client
- Web fuzzing → Fuzz submodules: uses submodules
bbot/modules/lightfuzz/lightfuzz.py - Web fuzzing → Web helpers: tests web targets
- Internal analysis → Scan events: analyzes events
- Scan events → Event model: serializes as
bbot/core/event/base.py - Preset setup → Configuration schema: configures scan
bbot/scanner/preset/preset.py - Module runtime → Configuration schema: reads module config
bbot/modules/base.py - JSON output → Output runtime: extends
bbot/modules/output/json.py - JSON output → Scan events: serializes events
bbot/modules/output/json.py - Scan events → Other destinations: feeds destinations
bbot/core/event/base.py - Scan events → JSON output: streams results
bbot/core/event/base.py