Nightshade User'S Manual: Description
Nightshade User'S Manual: Description
1 DESCRIPTION
This document describes installation and operation of Nightshade, a
collection of tools intended to exploit vulnerabilities in network devices,
including but not limited to wireless access points and routers.
2 GENERAL REQUIREMENTS
Nightshade requires:
• Hardware: laptop with 802.11 wireless card (internal or external)
• OS: Windows XP or Linux
• Software: Java JDK 1.5 (5.0) or newer (latest java download available
from: http://www.java.com/getjava)
3 INSTALLATION
To install Nightshade, unzip Nightshade.zip to a directory of your choosing.
After unzipping the file, you should see a “Nightshade” directory. Each
subdirectory under Nightshade is a different Tool (e.g., Nightshade/Tomato/
contains all relevant software for the Tomato tool).
4 OPERATION
This section describes the operation of each Nightshade tool.
4.1 TOMATO
Tomato is a tool that fetches the administrator password from various Broadcom-
based wireless access points and routers.
4.1.1 General Operation
Tomato is generally operated as follows:
• Tomato user runs the Tomato program which returns the network device’s
administrator password (and performs any other actions), or indicates an
error.
• Wirelessly connect to the network device. This procedure can vary per
linux distribution, but typically one can use linux wireless tools (iwconfig)
and wpa_supplicant (pre-installed on most recent linux distributions).
Consult the man pages if necessary. Also, the wpa_supplicant GUI, is a
particularly useful tool (see
http://hostap.epitest.fi/wpa_supplicant/wpa_gui.html).
cd /home/myuser/foobar/Nightshade/Tomato/Release
• Run Tomato.sh with the appropriate action argument (see section 4.1.4 for
a discussion of which action may be appropriate)::
C:\foobar\Nightshade\Tomato\Release
• To run Tomato, double-click the appropriate batch (.bat) file (see section
4.1.4 for a discussion of which batch file may be appropriate):
The batch files are simply for convenience. Alternatively, you can
open a command prompt (Start->Run, type “cmd”, and click “OK”),
change to the Tomato Release directory (cd
C:\foobar\Nightshade\Tomato\Release), and type “Tomato.bat help”
for more Tomato information, including device coverage.
As Tomato finishes its last operation, the UPnP service on the network device
will terminate. So, running:
Windows: “TomatoGetPassword.bat”
Linux “Tomato.sh pass”
will fetch the password, and in doing so terminate the UPnP service.
Running:
Windows: “TomatoGetPasswordAndReboot.bat”
Linux: “Tomato.sh passr”
will fetch the password and reboot the device. Once rebooted, the device will
again be running the UPnP service.
Thus, the user must consider which will be more detectable: a missing UPnP
service, or a temporary interruption in network service while the device reboots.
In general, UPnP is not a particularly oft-used service, and a network
administrator may not be too suspicious if the service fails. All of the Tomato-
covered network devices reboot in less than 10 seconds, although a system
administrator may be more suspicious about a temporary drop in network
service.
Running:
Windows: “TomatoGetPasswordAndOpenShell.bat”
Linux: “Tomato.sh shell”
should be used in advanced situations where an interactive shell is appropriate.
Note that all Tomato-covered devices have a reboot utility, typically run as
“/sbin/reboot” through the interactive shell.