# spiderlabs/responder architecture

> Architecture diagram of the GitHub repository spiderlabs/responder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/spiderlabs/responder
- Repository: https://github.com/spiderlabs/responder

## Overview

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`](https://github.com/spiderlabs/responder/blob/master/Responder.py) (Runtime dispatcher), [`servers`](https://github.com/spiderlabs/responder/tree/master/servers) (Authentication servers), [`poisoners`](https://github.com/spiderlabs/responder/tree/master/poisoners) (Name poisoners), [`poisoners/LLMNR.py`](https://github.com/spiderlabs/responder/blob/master/poisoners/LLMNR.py) (LLMNR handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Responder runtime"]
  node_entry["Runtime dispatcher<br/>[Responder.py]"]
  node_config["Configuration<br/>[settings.py]"]
  node_common["Shared utilities<br/>[utils.py]"]
  node_packetdefs["Packet definitions<br/>[packets.py]"]
end

subgraph group_discovery["Discovery and poisoning"]
  node_namepoison["Name poisoners"]
  node_llmnr["LLMNR handler<br/>[LLMNR.py]"]
  node_nbt["NBT-NS handler<br/>[NBTNS.py]"]
  node_mdns["mDNS handler<br/>[MDNS.py]"]
  node_browser["Browser listener<br/>[Browser.py]"]
  node_dns["DNS service<br/>[DNS.py]"]
end

subgraph group_capture["Authentication services"]
  node_auth["Authentication servers"]
  node_smb["SMB authentication<br/>[SMB.py]"]
  node_http["HTTP and HTTPS<br/>[HTTP.py]"]
  node_proxy["WPAD proxy<br/>[HTTP_Proxy.py]"]
  node_ldap["LDAP authentication<br/>[LDAP.py]"]
  node_mssql["MSSQL authentication<br/>[MSSQL.py]"]
  node_otherauth["Other auth services"]
end

subgraph group_support["Analysis and support"]
  node_fingerprint["Host fingerprinting<br/>[fingerprint.py]"]
  node_capturestore[("Credential logging<br/>[utils.py]")]
  node_relay["SMB relay<br/>[SMBRelay.py]"]
  node_relaypackets["Relay packet builders<br/>[RelayPackets.py]"]
  node_dhcp["Rogue DHCP<br/>[DHCP.py]"]
  node_icmp["ICMP redirect<br/>[Icmp-Redirect.py]"]
  node_listener["Browser discovery tool<br/>[BrowserListener.py]"]
  node_analysis["Analyze mode<br/>[Responder.py]"]
end

node_operator(("Operator"))
node_client(("Network client"))

node_operator -->|"starts"| node_entry
node_entry -->|"loads settings"| node_config
node_entry -->|"starts listener"| node_llmnr
node_entry -->|"starts listener"| node_nbt
node_entry -->|"starts listener"| node_mdns
node_entry -->|"starts listener"| node_browser
node_entry -->|"starts service"| node_dns
node_entry -->|"starts services"| node_auth
node_client -->|"sends query"| node_namepoison
node_namepoison -.->|"dispatches"| node_llmnr
node_namepoison -.->|"dispatches"| node_nbt
node_namepoison -.->|"dispatches"| node_mdns
node_llmnr -->|"builds answer"| node_packetdefs
node_nbt -->|"builds answer"| node_packetdefs
node_llmnr -->|"fingerprints host"| node_fingerprint
node_nbt -->|"fingerprints host"| node_fingerprint
node_client -->|"authenticates"| node_auth
node_auth -->|"provides SMB"| node_smb
node_auth -->|"provides HTTP&#40;S&#41;"| node_http
node_auth -->|"provides WPAD"| node_proxy
node_auth -->|"provides LDAP"| node_ldap
node_auth -->|"provides MSSQL"| node_mssql
node_auth -->|"provides protocols"| node_otherauth
node_smb -->|"saves credentials"| node_common
node_http -->|"saves credentials"| node_common
node_common -->|"writes captures"| node_capturestore
node_entry -->|"enables mode"| node_analysis
node_analysis -->|"observes traffic"| node_browser
node_analysis -->|"observes queries"| node_dns
node_listener -->|"uses browser logic"| node_browser
node_relay -->|"uses builders"| node_relaypackets
node_operator -->|"runs tool"| node_dhcp
node_operator -->|"runs tool"| node_icmp

click node_entry "https://github.com/spiderlabs/responder/blob/master/Responder.py"
click node_config "https://github.com/spiderlabs/responder/blob/master/settings.py"
click node_common "https://github.com/spiderlabs/responder/blob/master/utils.py"
click node_packetdefs "https://github.com/spiderlabs/responder/blob/master/packets.py"
click node_namepoison "https://github.com/spiderlabs/responder/tree/master/poisoners"
click node_llmnr "https://github.com/spiderlabs/responder/blob/master/poisoners/LLMNR.py"
click node_nbt "https://github.com/spiderlabs/responder/blob/master/poisoners/NBTNS.py"
click node_mdns "https://github.com/spiderlabs/responder/blob/master/poisoners/MDNS.py"
click node_browser "https://github.com/spiderlabs/responder/blob/master/servers/Browser.py"
click node_dns "https://github.com/spiderlabs/responder/blob/master/servers/DNS.py"
click node_auth "https://github.com/spiderlabs/responder/tree/master/servers"
click node_smb "https://github.com/spiderlabs/responder/blob/master/servers/SMB.py"
click node_http "https://github.com/spiderlabs/responder/blob/master/servers/HTTP.py"
click node_proxy "https://github.com/spiderlabs/responder/blob/master/servers/HTTP_Proxy.py"
click node_ldap "https://github.com/spiderlabs/responder/blob/master/servers/LDAP.py"
click node_mssql "https://github.com/spiderlabs/responder/blob/master/servers/MSSQL.py"
click node_otherauth "https://github.com/spiderlabs/responder/tree/master/servers"
click node_fingerprint "https://github.com/spiderlabs/responder/blob/master/fingerprint.py"
click node_capturestore "https://github.com/spiderlabs/responder/blob/master/utils.py"
click node_relay "https://github.com/spiderlabs/responder/blob/master/tools/SMBRelay.py"
click node_relaypackets "https://github.com/spiderlabs/responder/blob/master/tools/RelayPackets.py"
click node_dhcp "https://github.com/spiderlabs/responder/blob/master/tools/DHCP.py"
click node_icmp "https://github.com/spiderlabs/responder/blob/master/tools/Icmp-Redirect.py"
click node_listener "https://github.com/spiderlabs/responder/blob/master/tools/BrowserListener.py"
click node_analysis "https://github.com/spiderlabs/responder/blob/master/Responder.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_config,node_common,node_packetdefs,node_client toneBlue
class node_namepoison,node_llmnr,node_nbt,node_mdns,node_browser,node_dns toneAmber
class node_auth,node_smb,node_http,node_proxy,node_ldap,node_mssql,node_otherauth toneMint
class node_fingerprint,node_capturestore,node_relay,node_relaypackets,node_dhcp,node_icmp,node_listener,node_analysis toneRose
class node_operator toneIndigo
```

## Components

### Responder runtime

- [Runtime dispatcher](https://github.com/spiderlabs/responder/blob/master/Responder.py): `Responder.py`
- [Configuration](https://github.com/spiderlabs/responder/blob/master/settings.py): `settings.py`
- [Shared utilities](https://github.com/spiderlabs/responder/blob/master/utils.py): `utils.py`
- [Packet definitions](https://github.com/spiderlabs/responder/blob/master/packets.py): `packets.py`

### Discovery and poisoning

- [Name poisoners](https://github.com/spiderlabs/responder/tree/master/poisoners): `poisoners`
- [LLMNR handler](https://github.com/spiderlabs/responder/blob/master/poisoners/LLMNR.py): `poisoners/LLMNR.py`
- [NBT-NS handler](https://github.com/spiderlabs/responder/blob/master/poisoners/NBTNS.py): `poisoners/NBTNS.py`
- [mDNS handler](https://github.com/spiderlabs/responder/blob/master/poisoners/MDNS.py): `poisoners/MDNS.py`
- [Browser listener](https://github.com/spiderlabs/responder/blob/master/servers/Browser.py): `servers/Browser.py`
- [DNS service](https://github.com/spiderlabs/responder/blob/master/servers/DNS.py): `servers/DNS.py`

### Authentication services

- [Authentication servers](https://github.com/spiderlabs/responder/tree/master/servers): `servers`
- [SMB authentication](https://github.com/spiderlabs/responder/blob/master/servers/SMB.py): `servers/SMB.py`
- [HTTP and HTTPS](https://github.com/spiderlabs/responder/blob/master/servers/HTTP.py): `servers/HTTP.py`
- [WPAD proxy](https://github.com/spiderlabs/responder/blob/master/servers/HTTP_Proxy.py): `servers/HTTP_Proxy.py`
- [LDAP authentication](https://github.com/spiderlabs/responder/blob/master/servers/LDAP.py): `servers/LDAP.py`
- [MSSQL authentication](https://github.com/spiderlabs/responder/blob/master/servers/MSSQL.py): `servers/MSSQL.py`
- [Other auth services](https://github.com/spiderlabs/responder/tree/master/servers): `servers`

### Analysis and support

- [Host fingerprinting](https://github.com/spiderlabs/responder/blob/master/fingerprint.py): `fingerprint.py`
- [Credential logging](https://github.com/spiderlabs/responder/blob/master/utils.py): `utils.py`
- [SMB relay](https://github.com/spiderlabs/responder/blob/master/tools/SMBRelay.py): `tools/SMBRelay.py`
- [Relay packet builders](https://github.com/spiderlabs/responder/blob/master/tools/RelayPackets.py): `tools/RelayPackets.py`
- [Rogue DHCP](https://github.com/spiderlabs/responder/blob/master/tools/DHCP.py): `tools/DHCP.py`
- [ICMP redirect](https://github.com/spiderlabs/responder/blob/master/tools/Icmp-Redirect.py): `tools/Icmp-Redirect.py`
- [Browser discovery tool](https://github.com/spiderlabs/responder/blob/master/tools/BrowserListener.py): `tools/BrowserListener.py`
- [Analyze mode](https://github.com/spiderlabs/responder/blob/master/Responder.py): `Responder.py`

### Other components

- **Operator**
- **Network client**

## Connections

- Operator → Runtime dispatcher: starts (evidence: `README.md`)
- Runtime dispatcher → Configuration: loads settings (evidence: `Responder.py`)
- Runtime dispatcher → LLMNR handler: starts listener (evidence: `Responder.py`)
- Runtime dispatcher → NBT-NS handler: starts listener (evidence: `Responder.py`)
- Runtime dispatcher → mDNS handler: starts listener (evidence: `Responder.py`)
- Runtime dispatcher → Browser listener: starts listener (evidence: `Responder.py`)
- Runtime dispatcher → DNS service: starts service (evidence: `Responder.py`)
- Runtime dispatcher → Authentication servers: starts services (evidence: `Responder.py`)
- Network client → Name poisoners: sends query (evidence: `README.md`)
- Name poisoners → LLMNR handler: dispatches
- Name poisoners → NBT-NS handler: dispatches
- Name poisoners → mDNS handler: dispatches
- LLMNR handler → Packet definitions: builds answer (evidence: `poisoners/LLMNR.py`)
- NBT-NS handler → Packet definitions: builds answer (evidence: `poisoners/NBTNS.py`)
- LLMNR handler → Host fingerprinting: fingerprints host (evidence: `poisoners/LLMNR.py`)
- NBT-NS handler → Host fingerprinting: fingerprints host (evidence: `poisoners/NBTNS.py`)
- Network client → Authentication servers: authenticates (evidence: `README.md`)
- Authentication servers → SMB authentication: provides SMB (evidence: `README.md`)
- Authentication servers → HTTP and HTTPS: provides HTTP(S) (evidence: `README.md`)
- Authentication servers → WPAD proxy: provides WPAD (evidence: `README.md`)
- Authentication servers → LDAP authentication: provides LDAP (evidence: `README.md`)
- Authentication servers → MSSQL authentication: provides MSSQL (evidence: `README.md`)
- Authentication servers → Other auth services: provides protocols (evidence: `README.md`)
- SMB authentication → Shared utilities: saves credentials (evidence: `servers/SMB.py`)
- HTTP and HTTPS → Shared utilities: saves credentials (evidence: `servers/HTTP.py`)
- Shared utilities → Credential logging: writes captures (evidence: `utils.py`)
- Runtime dispatcher → Analyze mode: enables mode (evidence: `Responder.py`)
- Analyze mode → Browser listener: observes traffic (evidence: `README.md`)
- Analyze mode → DNS service: observes queries (evidence: `README.md`)
- Browser discovery tool → Browser listener: uses browser logic (evidence: `tools/BrowserListener.py`)
- SMB relay → Relay packet builders: uses builders (evidence: `tools/SMBRelay.py`)
- Operator → Rogue DHCP: runs tool (evidence: `README.md`)
- Operator → ICMP redirect: runs tool (evidence: `README.md`)
