github/Responder
1
0
Fork 0
mirror of https://github.com/lgandx/Responder.git synced 2025-07-14 00:53:01 -07:00
Code Issues Projects Releases Packages Wiki Activity Actions

Updated Readme

Browse source
This commit is contained in:
jrmdev 2015-07-10 11:04:15 +10:00
parent bc06818ed1
commit 38969832ce
2 changed files with 111 additions and 150 deletions
Download patch file Download diff file Expand all files Collapse all files

260
README.md Normal file → Executable file
View file

@ -1,190 +1,152 @@
NBT-NS/LLMNR Responder # Responder.py #
Laurent Gaffie <lgaffie@trustwave.com>
http://www.spiderlabs.com
INTRODUCTION LLMNR/NBT-NS/mDNS Poisoner
============
This tool is first an LLMNR, NBT-NS and MDNS responder, it will answer to (Original work by Laurent Gaffie <lgaffie@trustwave.com> http://www.spiderlabs.com)
*specific* NBT-NS (NetBIOS Name Service) queries based on their name
suffix (see: http://support.microsoft.com/kb/163409). By default, the
tool will only answers to File Server Service request, which is for SMB.
The concept behind this, is to target our answers, and be stealthier on
the network. This also helps to ensure that we don't break legitimate
NBT-NS behavior. You can set the -r option via command line if
you want this tool to answer to the Workstation Service request name
suffix.
FEATURES
========
- Built-in SMB Auth server.
Supports NTLMv1, NTLMv2 hashes with Extended Security NTLMSSP by default. ## Intro ##
Successfully tested from Windows 95 to Server 2012 RC, Samba and Mac OSX Lion.
Clear text password is supported for NT4, and LM hashing downgrade when the
--lm option is set. This functionality is enabled by default when the
tool is launched.
- Built-in MSSQL Auth server. Responder an LLMNR, NBT-NS and MDNS poisoner. It will answer to *specific* NBT-NS (NetBIOS Name Service) queries based on their name suffix (see: http://support.microsoft.com/kb/163409). By default, the tool will only answer to File Server Service request, which is for SMB.
In order to redirect SQL Authentication to this tool, you will need to
set the option -r (NBT-NS queries for SQL Server lookup are using
the Workstation Service name suffix) for systems older than windows
Vista (LLMNR will be used for Vista and higher). This server supports
NTLMv1, LMv2 hashes. This functionality was successfully tested on
Windows SQL Server 2005 & 2008.
- Built-in HTTP Auth server. The concept behind this is to target our answers, and be stealthier on the network. This also helps to ensure that we don't break legitimate NBT-NS behavior. You can set the -r option via command line if you want to answer to the Workstation Service request name suffix.
In order to redirect HTTP Authentication to this tool, you will need
to set the option -r for Windows version older than Vista (NBT-NS
queries for HTTP server lookup are sent using the Workstation Service
name suffix). For Vista and higher, LLMNR will be used. This server
supports NTLMv1, NTLMv2 hashes *and* Basic Authentication. This server
was successfully tested on IE 6 to IE 10, Firefox, Chrome, Safari.
Note: This module also works for WebDav NTLM authentication issued from
Windows WebDav clients (WebClient). You can now send your custom files to a victim.
- Built-in HTTPS Auth server. ## Features ##
In order to redirect HTTPS Authentication to this tool, you will need
 to set the -r option for Windows versions older than Vista (NBT-NS - Built-in SMB Auth server.
 queries for HTTP server lookups are sent using the Workstation Service
 name suffix). For Vista and higher, LLMNR will be used. This server Supports NTLMv1, NTLMv2 hashes with Extended Security NTLMSSP by default. Successfully tested from Windows 95 to Server 2012 RC, Samba and Mac OSX Lion. Clear text password is supported for NT4, and LM hashing downgrade when the --lm option is set. This functionality is enabled by default when the tool is launched.
 supports NTLMv1, NTLMv2, *and* Basic Authentication. This server
 was successfully tested on IE 6 to IE 10, Firefox, Chrome, and Safari. - Built-in MSSQL Auth server.
 The folder Cert/ was added and contain 2 default keys, including a dummy
 private key. This is *intentional*, the purpose is to have Responder In order to redirect SQL Authentication to this tool, you will need to set the option -r (NBT-NS queries for SQL Server lookup are using the Workstation Service name suffix) for systems older than windows Vista (LLMNR will be used for Vista and higher). This server supports NTLMv1, LMv2 hashes. This functionality was successfully tested on Windows SQL Server 2005 & 2008.
 working out of the box. A script was added in case you need to generate
 your own self signed key pair. - Built-in HTTP Auth server.
In order to redirect HTTP Authentication to this tool, you will need to set the option -r for Windows version older than Vista (NBT-NS queries for HTTP server lookup are sent using the Workstation Service name suffix). For Vista and higher, LLMNR will be used. This server supports NTLMv1, NTLMv2 hashes *and* Basic Authentication. This server was successfully tested on IE 6 to IE 10, Firefox, Chrome, Safari.
Note: This module also works for WebDav NTLM authentication issued from Windows WebDav clients (WebClient). You can now send your custom files to a victim.
- Built-in HTTPS Auth server.
Same as above. The folder certs/ containa 2 default keys, including a dummy private key. This is *intentional*, the purpose is to have Responder working out of the box. A script was added in case you need to generate your own self signed key pair.
- Built-in LDAP Auth server. - Built-in LDAP Auth server.
In order to redirect LDAP Authentication to this tool, you will need
to set the option -r for Windows version older than Vista (NBT-NS
queries for HTTP server lookup are sent using the Workstation Service
name suffix). For Vista and higher, LLMNR will be used. This server
supports NTLMSSP hashes and Simple Authentication (clear text authentication).
This server was successfully tested on Windows Support tool "ldp" and LdapAdmin.
- Built-in FTP Auth server. In order to redirect LDAP Authentication to this tool, you will need to set the option -r for Windows version older than Vista (NBT-NS queries for HTTP server lookup are sent using the Workstation Service name suffix). For Vista and higher, LLMNR will be used. This server supports NTLMSSP hashes and Simple Authentication (clear text authentication). This server was successfully tested on Windows Support tool "ldp" and LdapAdmin.
This module will collect FTP clear text credentials.
- Built-in small DNS server. This server will answer type A queries. This - Built-in FTP, POP3, IMAP, SMTP Auth servers.
is really handy when it's combined with ARP spoofing.
- All hashes are printed to stdout and dumped in an unique file John This modules will collect clear text credentials.
Jumbo compliant, using this format:
(SMB or MSSQL or HTTP)-(ntlm-v1 or v2 or clear-text)-Client_IP.txt
The file will be located in the current folder.
- Responder will logs all its activity to a file Responder-Session.log. - Built-in DNS server.
- When the option -f is set to "On", Responder will fingerprint every host who issued This server will answer type A queries. This is really handy when it's combined with ARP spoofing.
an LLMNR/NBT-NS query. All capture modules still work while in fingerprint mode.
- Browser Listener finds the PDC in stealth mode. - Built-in WPAD Proxy Server.
- Icmp Redirect for MITM on Windows XP/2003 and earlier Domain members. This attack combined with This module will capture all HTTP requests from anyone launching Internet Explorer on the network if they have "Auto-detect settings" enabled. This module is higly effective. You can configure your custom PAC script in Responder.conf and inject HTML into the server's responses. See Responder.conf.
the DNS module is pretty effective.
- WPAD rogue transparent proxy server. This module will capture all HTTP requests from anyone launching Internet Explorer on the network. This module is higly effective. You can now send your custom Pac script to a victim and inject HTML into the server's responses. See Responder.conf. This module is now enabled by default. - Browser Listener
- Analyze mode: This module allows you to see NBT-NS, BROWSER, LLMNR requests from which workstation to which workstation without poisoning any requests. Also, you can map domains, MSSQL servers, workstations passively, see if ICMP Redirects attacks are plausible on your subnet. This module allows to find the PDC in stealth mode.
- Responder is now using a configuration file. See Responder.conf. - Fingerprinting
- Built-in POP3 auth server. This module will collect POP3 plaintext credentials When the option -f is used, Responder will fingerprint every host who issued an LLMNR/NBT-NS query. All capture modules still work while in fingerprint mode.
- Built-in SMTP auth server. This module will collect PLAIN/LOGIN clear text credentials. - Icmp Redirect
CONSIDERATIONS python tools/Icmp-Redirect.py
==============
- This tool listen on several port: UDP 137, UDP 138, UDP 53, UDP/TCP 389,TCP 1433, For MITM on Windows XP/2003 and earlier Domain members. This attack combined with the DNS module is pretty effective.
TCP 80, TCP 139, TCP 445, TCP 21, TCP 3141,TCP 25, TCP 110, TCP 587 and Multicast UDP 5553.
If you run Samba on your system, stop smbd and nmbd and all other
services listening on these ports.
For Ubuntu users:
Edit this file /etc/NetworkManager/NetworkManager.conf and comment the line : "dns=dnsmasq".
Then kill dnsmasq with this command (as root): killall dnsmasq -9
- Any rogue server can be turn off in Responder.conf. - Rogue DHCP
- You can set a network interface via command line switch -I. Default is all. python tools/DHCP.py
DHCP Inform Spoofing. Allows you to let the real DHCP Server issue IP addresses, and then send a DHCP Inform answer to set your IP address as a primary DNS server, and your own WPAD URL.
- Analyze mode.
This module allows you to see NBT-NS, BROWSER, LLMNR, DNS requests on the network without poisoning any responses. Also, you can map domains, MSSQL servers, workstations passively, see if ICMP Redirects attacks are plausible on your subnet.
## Hashes ##
All hashes are printed to stdout and dumped in an unique file John Jumbo compliant, using this format:
(MODULE_NAME)-(HASH_TYPE)-(CLIENT_IP).txt
Log files are located in the "logs/" folder. Hashes will be logged and printed only once per user per hash type, unless you are using the Verbose mode (-v).
- Responder will logs all its activity to Responder-Session.log
- Analyze mode will be logged to Analyze-Session.log
- Poisoning will be logged to Poisoners-Session.log
Additionally, all captured hashed are logged into an SQLite database which you can configure in Responder.conf
## Considerations ##
- This tool listens on several ports: UDP 137, UDP 138, UDP 53, UDP/TCP 389,TCP 1433, TCP 80, TCP 139, TCP 445, TCP 21, TCP 3141,TCP 25, TCP 110, TCP 587 and Multicast UDP 5553.
- If you run Samba on your system, stop smbd and nmbd and all other services listening on these ports.
- For Ubuntu users:
Edit this file /etc/NetworkManager/NetworkManager.conf and comment the line: `dns=dnsmasq`. Then kill dnsmasq with this command (as root): `killall dnsmasq -9`
- Any rogue server can be turned off in Responder.conf.
- This tool is not meant to work on Windows. - This tool is not meant to work on Windows.
## Usage ##
USAGE First of all, please take a look at Responder.conf and tweak it for your needs.
=====
First of all, please take a look at Responder.conf and set it for your needs. Running the tool:
Running this tool:
- ./Responder.py [options] ./Responder.py [options]
Usage Example: Typical Usage Example:
./Responder.py -i 10.20.30.40 -w -r -f ./Responder.py -I eth0 -wrf
or: Options:
python Responder.py -i 10.20.30.40 -wrf --version show program's version number and exit
-h, --help show this help message and exit
Options List: -A, --analyze Analyze mode. This option allows you to see NBT-NS,
BROWSER, LLMNR requests without responding.
-h, --help show this help message and exit -I eth0, --interface=eth0
Network interface to use
-A, --analyze Analyze mode. This option allows you to see NBT-NS, -b, --basic Return a Basic HTTP authentication. Default: NTLM
BROWSER, LLMNR requests from which workstation to -r, --wredir Enable answers for netbios wredir suffix queries.
which workstation without poisoning anything. Answering to wredir will likely break stuff on the
network. Default: False
-i 10.20.30.40, --ip=10.20.30.40 -d, --NBTNSdomain Enable answers for netbios domain suffix queries.
The ip address to redirect the traffic to. (usually Answering to domain suffixes will likely break stuff
yours) on the network. Default: False
-f, --fingerprint This option allows you to fingerprint a host that
-I eth0, --interface=eth0 Network interface to use issued an NBT-NS or LLMNR query.
-w, --wpad Start the WPAD rogue proxy server. Default value is
-b, --basic Set this if you want to return a Basic HTTP False
authentication. If not set, an NTLM authentication -u UPSTREAM_PROXY, --upstream-proxy=UPSTREAM_PROXY
will be returned. Upstream HTTP proxy used by the rogue WPAD Proxy for
outgoing requests (format: host:port)
-r, --wredir Set this to enable answers for netbios wredir suffix -F, --ForceWpadAuth Force NTLM/Basic authentication on wpad.dat file
queries. Answering to wredir will likely break stuff retrieval. This may cause a login prompt. Default:
on the network (like classics 'nbns spoofer' would). False
Default value is therefore set to False --lm Force LM hashing downgrade for Windows XP/2003 and
earlier. Default: False
-d, --NBTNSdomain Set this to enable answers for netbios domain suffix -v, --verbose Increase verbosity.
queries. Answering to domain suffixes will likely
break stuff on the network (like a classic 'nbns
spoofer' would). Default value is therefore set to
False
-f, --fingerprint This option allows you to fingerprint a host that
issued an NBT-NS or LLMNR query.
-w, --wpad Set this to start the WPAD rogue proxy server. Default
value is False
-F, --ForceWpadAuth Set this if you want to force NTLM/Basic
authentication on wpad.dat file retrieval. This might
cause a login prompt in some specific cases.
Therefore, default value is False
--lm Set this if you want to force LM hashing downgrade for
Windows XP/2003 and earlier. Default value is False
-v More verbose
For more information read these posts:
http://blog.spiderlabs.com/2012/10/introducing-responder-10.html
http://blog.spiderlabs.com/2013/01/owning-windows-networks-with-responder-17.html
http://blog.spiderlabs.com/2013/02/owning-windows-network-with-responder-part-2.html
http://blog.spiderlabs.com/2014/02/responder-20-owning-windows-networks-part-3.html
Follow our latest updates on twitter:
https://twitter.com/PythonResponder ## Copyright ##
COPYRIGHT
=========
NBT-NS/LLMNR Responder NBT-NS/LLMNR Responder
Created by Laurent Gaffie Created by Laurent Gaffie

1
utils.py
View file

@ -122,7 +122,6 @@ def WriteData(outfile, data, user):
outf2.write("\n") outf2.write("\n")
outf2.close() outf2.close()
# Return true if the data is to be printed, else false
def SaveToDb(result): def SaveToDb(result):
# Creating the DB if it doesn't exist # Creating the DB if it doesn't exist