How spiderlabs/responder works
Responder is a network name-resolution poisoner and credential-capture suite. Its principal workflow is to receive LLMNR, NBT-NS or mDNS queries, selectively answer them, and direct clients to protocol-specific authentication services; captured credentials are logged and persisted. Separate capabilities include passive analysis, host fingerprinting, browser discovery, DNS/WPAD services, packet relay, rogue DHCP and ICMP redirects. The graph reflects documented capabilities and visible imports/calls; several service implementations and runtime registrations were not excerpted, so those links rely on the README or entry-point references.
Main entry points: Responder.py Runtime dispatcher · servers Authentication servers · poisoners Name poisoners · LLMNR.py LLMNR handler
Components 27
Responder runtime
- Runtime dispatcher
Responder.py - Configuration
settings.py - Shared utilities
utils.py - Packet definitions
packets.py
Discovery and poisoning
- Name poisoners
poisoners - LLMNR handler
poisoners/LLMNR.py - NBT-NS handler
poisoners/NBTNS.py - mDNS handler
poisoners/MDNS.py - Browser listener
servers/Browser.py - DNS service
servers/DNS.py
Authentication services
- Authentication servers
servers - SMB authentication
servers/SMB.py - HTTP and HTTPS
servers/HTTP.py - WPAD proxy
servers/HTTP_Proxy.py - LDAP authentication
servers/LDAP.py - MSSQL authentication
servers/MSSQL.py - Other auth services
servers
Analysis and support
- Host fingerprinting
fingerprint.py - Credential logging
utils.py - SMB relay
tools/SMBRelay.py - Relay packet builders
tools/RelayPackets.py - Rogue DHCP
tools/DHCP.py - ICMP redirect
tools/Icmp-Redirect.py - Browser discovery tool
tools/BrowserListener.py - Analyze mode
Responder.py
Other components
- Operator
- Network client
Connections 33
- Operator → Runtime dispatcher: starts
README.md - Runtime dispatcher → Configuration: loads settings
Responder.py - Runtime dispatcher → LLMNR handler: starts listener
Responder.py - Runtime dispatcher → NBT-NS handler: starts listener
Responder.py - Runtime dispatcher → mDNS handler: starts listener
Responder.py - Runtime dispatcher → Browser listener: starts listener
Responder.py - Runtime dispatcher → DNS service: starts service
Responder.py - Runtime dispatcher → Authentication servers: starts services
Responder.py - Network client → Name poisoners: sends query
README.md - Name poisoners → LLMNR handler: dispatches
- Name poisoners → NBT-NS handler: dispatches
- Name poisoners → mDNS handler: dispatches
- LLMNR handler → Packet definitions: builds answer
poisoners/LLMNR.py - NBT-NS handler → Packet definitions: builds answer
poisoners/NBTNS.py - LLMNR handler → Host fingerprinting: fingerprints host
poisoners/LLMNR.py - NBT-NS handler → Host fingerprinting: fingerprints host
poisoners/NBTNS.py - Network client → Authentication servers: authenticates
README.md - Authentication servers → SMB authentication: provides SMB
README.md - Authentication servers → HTTP and HTTPS: provides HTTP(S)
README.md - Authentication servers → WPAD proxy: provides WPAD
README.md - Authentication servers → LDAP authentication: provides LDAP
README.md - Authentication servers → MSSQL authentication: provides MSSQL
README.md - Authentication servers → Other auth services: provides protocols
README.md - SMB authentication → Shared utilities: saves credentials
servers/SMB.py - HTTP and HTTPS → Shared utilities: saves credentials
servers/HTTP.py - Shared utilities → Credential logging: writes captures
utils.py - Runtime dispatcher → Analyze mode: enables mode
Responder.py - Analyze mode → Browser listener: observes traffic
README.md - Analyze mode → DNS service: observes queries
README.md - Browser discovery tool → Browser listener: uses browser logic
tools/BrowserListener.py - SMB relay → Relay packet builders: uses builders
tools/SMBRelay.py - Operator → Rogue DHCP: runs tool
README.md - Operator → ICMP redirect: runs tool
README.md