Kismet Server/Drone

From DD-WRT Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 16:53, 14 May 2005 (edit)
Sveasoft (Talk | contribs)
(Installing & Configuring on the WRT54G)
← Previous diff
Revision as of 21:35, 18 May 2005 (edit) (undo)
Sveasoft (Talk | contribs)
(formatting and Table of Contents)
Next diff →
Line 1: Line 1:
-===Introduction===+=Introduction=
Anyone familiar with Network Stumbler will definately appreciate running Kismet Server or Kismet Drone on their WRT54G, since this router has some of the best radios around, along with nice sturdy RP-TNC connectors to hook up even better antennas to without worry about damaging your wireless card or radio pigtails (I've gone through a number of PCI cards with RP-SMA connectors that keep breaking appart). Anyone familiar with Network Stumbler will definately appreciate running Kismet Server or Kismet Drone on their WRT54G, since this router has some of the best radios around, along with nice sturdy RP-TNC connectors to hook up even better antennas to without worry about damaging your wireless card or radio pigtails (I've gone through a number of PCI cards with RP-SMA connectors that keep breaking appart).
'''This Wiki assumes you already have a current build of DD-WRT installed on your router.''' '''This Wiki assumes you already have a current build of DD-WRT installed on your router.'''
-===What is Kismet===+==What is Kismet==
Kismet is a layer 2 wireless network detector, sniffer, and intrusion detection kit. Kismet is a layer 2 wireless network detector, sniffer, and intrusion detection kit.
Line 11: Line 11:
Since Kismet is a Linux project, it can run as either the full server, or just a drone server on the WRT54G router. You are then free to run a Kismet client on your desktop computer view the output. Since Kismet is a Linux project, it can run as either the full server, or just a drone server on the WRT54G router. You are then free to run a Kismet client on your desktop computer view the output.
-===Server or Drone===+=Server or Drone=
-'''Drone'''<br>+==Drone==
-The Kismet project has developed the capability of running Drones: devices with wireless cards that mearly send their data back to a Kismet server. If you run the Kismet Drone on your DD-WRT box, you'll need to run the client and the server elsewhere. Both can be on your desktop computer, or you could have a machine somewhere else running just the server. Running a Kismet drone on your WRT and the Client/Server on a desktop computer(s) seems to be the most common installation. <nowiki>[I was not able to get this to work, so someone else will have to write that part of the HowTo.]</nowiki>+The Kismet project has developed the capability of running Drones: devices with wireless cards that mearly send their data back to a Kismet server. If you run the Kismet Drone on your DD-WRT box, you'll need to run the client and the server elsewhere. Both can be on your desktop computer, or you could have a machine somewhere else running just the server. Running a Kismet drone on your WRT and the Client/Server on a desktop computer(s) seems to be the most common installation. <nowiki>[I was not able to get this to work, so someone else will have to write that part of the HowTo.]</nowiki><br>
 +[[#Drone_2|Install on WRT54G/S]]
-'''Server'''<br>+==Server==
-Since the kismet server is capable of running on top of DD-WRT one is able to simplify the installation by only running a client on their desktop machine. I'm not exactly sure what the advantages are, except that this seemed to be easier to install.+Since the kismet server is capable of running on top of DD-WRT one is able to simplify the installation by only running a client on their desktop machine. I'm not exactly sure what the advantages are, except that this seemed to be easier to install.<br>
 +[[#Server_2|Install on WRT54G/S]]
-===Installing & Configuring on the WRT54G===+=Installing & Configuring on the WRT54G=
-'''Drone'''<br>+==Drone==
If you desire to install just the drone on the WRT54G, you'll have to wait until someone more knowledgeable comes along. You can try the links in the external links section. If you desire to install just the drone on the WRT54G, you'll have to wait until someone more knowledgeable comes along. You can try the links in the external links section.
-Just remember that drone setup requires a server somewhere else (on the desktop perhaps?)+Just remember that drone setup requires a server somewhere else (on the desktop perhaps?) as well as a client (on the same desktop maybe?)
 +[[#When_installed_on_WRT_as_drone|Continue to Desktop Configuration]]
-'''Server'''<br>+==Server==
-''Assumptions''<br>+===Assumptions===
--Your router has SSH configured and you can send files via SSH to and from your desktop --Your router has SSH configured and you can send files via SSH to and from your desktop
--You have a text editor capable of Unix line delimiters. [http://www.textpad.com TextPad] and [http://www.gena01.com/win32pad/win32pad_1_5_7.exe win32pad] are both acceptable (and free).<br> '''Failure to use one of these when editing text files will prevent your installation from working''' --You have a text editor capable of Unix line delimiters. [http://www.textpad.com TextPad] and [http://www.gena01.com/win32pad/win32pad_1_5_7.exe win32pad] are both acceptable (and free).<br> '''Failure to use one of these when editing text files will prevent your installation from working'''
Line 32: Line 35:
--I will assume you are installing to the jffs partition. If you are not, replace jffs with tmp or some other folder --I will assume you are installing to the jffs partition. If you are not, replace jffs with tmp or some other folder
-''Preperation''<br>+===Preperation===
The guy at Musatcha.com has put together a [http://www5.musatcha.com/musatcha/computers/wap54g_kismet.zip great binary] to make installation simplier. Download it. The guy at Musatcha.com has put together a [http://www5.musatcha.com/musatcha/computers/wap54g_kismet.zip great binary] to make installation simplier. Download it.
--Extract the two files to somewhere on your computer. --Extract the two files to somewhere on your computer.
Line 42: Line 45:
-- If you are not using 192.168.1.x for your network, substitute your network setup. -- If you are not using 192.168.1.x for your network, substitute your network setup.
-''Copy the Files''<br>+===Copy the Files===
Load up WinSCP or some other SCP client to copy the files over Load up WinSCP or some other SCP client to copy the files over
--Browse to /jfss --Browse to /jfss
Line 48: Line 51:
--Copy kismet_server and kismet.conf from your computer to the /jfss/kismet_server folder on your wrt54g --Copy kismet_server and kismet.conf from your computer to the /jfss/kismet_server folder on your wrt54g
-''Installation''<br>+===Installation===
Telnet to your router and finish the configuration. Telnet to your router and finish the configuration.
-- telnet 192.168.1.1 -- telnet 192.168.1.1
Line 58: Line 61:
-- enter the command "chmod 755 /jffs/kismet_server/kismet_server" -- enter the command "chmod 755 /jffs/kismet_server/kismet_server"
-''Run the Server''<br>+===Run the Server===
&nbsp;&nbsp;A) You can launch the server on startup (let me know if you know how to do this).<br> &nbsp;&nbsp;A) You can launch the server on startup (let me know if you know how to do this).<br>
&nbsp;&nbsp;B) You can telnet into the router and launch it manually.<br> &nbsp;&nbsp;B) You can telnet into the router and launch it manually.<br>
Line 66: Line 69:
'''Method A: You can launch the server on startup''' '''Method A: You can launch the server on startup'''
I'm not sure how to do this. I'm not a linux guy. I'm not sure how to do this. I'm not a linux guy.
 + [[#When_installed_on_WRT_as_server|Continue to Desktop Configuration]]
'''Method B: You can telnet into the router and launch it manually.''' '''Method B: You can telnet into the router and launch it manually.'''
Line 71: Line 75:
--Telnet into the Router --Telnet into the Router
--enter the command /jfs/kismet_server/kismet_server -n -f /jfs/kismet_server/kismet.conf --enter the command /jfs/kismet_server/kismet_server -n -f /jfs/kismet_server/kismet.conf
 + [[#When_installed_on_WRT_as_server|Continue to Desktop Configuration]]
'''Method C: Launch the server manually fromt the web interface''' '''Method C: Launch the server manually fromt the web interface'''
Line 79: Line 84:
--Click the run button --Click the run button
--Enter the command in the command box and click the "cmd" button. --Enter the command in the command box and click the "cmd" button.
 + [[#When_installed_on_WRT_as_server|Continue to Desktop Configuration]]
'''Method D: You can have a client, such as Musatcha.com, automatically telnet in and launch the server.''' '''Method D: You can have a client, such as Musatcha.com, automatically telnet in and launch the server.'''
''Disadvantage: Currently can't send Usernames and Passwords, so you have to launch using another method.'' ''Disadvantage: Currently can't send Usernames and Passwords, so you have to launch using another method.''
--Visit [http://www5.musatcha.com/musatcha/computers/kismet_on_the_linksys_wap54g.htm Musatcha's howto] and view step 5. --Visit [http://www5.musatcha.com/musatcha/computers/kismet_on_the_linksys_wap54g.htm Musatcha's howto] and view step 5.
 + [[#When_installed_on_WRT_as_server|Continue to Desktop Configuration]]
-===Installing & Configuring on the Desktop===+=Installing & Configuring on the Desktop=
 +==When installed on WRT as drone==
 +I didn't get the drone to work, so someone else will have to fill this in.
 + 
 +==When installed on WRT as server==
'''Choose a client:'''<br> '''Choose a client:'''<br>
If you have a linux box, you can run Kismet client right off your desktop.<br> If you have a linux box, you can run Kismet client right off your desktop.<br>
Line 111: Line 122:
--The client is entirely keyboard driven. Press the 'h' key for help. You'll probably want to turn off auto sort right<br> away so you can view extended information about individual networks. Press the 's' key to do this. --The client is entirely keyboard driven. Press the 'h' key for help. You'll probably want to turn off auto sort right<br> away so you can view extended information about individual networks. Press the 's' key to do this.
-===External Links===+=External Links=
These are the references I used when creating this wiki<br> These are the references I used when creating this wiki<br>
[http://www5.musatcha.com/musatcha/computers/kismet_on_the_linksys_wap54g.htm Kismet on the WAP54G]<br> [http://www5.musatcha.com/musatcha/computers/kismet_on_the_linksys_wap54g.htm Kismet on the WAP54G]<br>
Line 119: Line 130:
---- ----
'''You are here: ''' '''[[Main Page]]'''/'''[[DD-WRT Doku (EN)]]'''/'''[[Kismet Server/Drone]]''' '''You are here: ''' '''[[Main Page]]'''/'''[[DD-WRT Doku (EN)]]'''/'''[[Kismet Server/Drone]]'''
- 
---[[User:Sveasoft|Sveasoft]] 18:29, 14 May 2005 (CEST) 

Revision as of 21:35, 18 May 2005

Contents

Introduction

Anyone familiar with Network Stumbler will definately appreciate running Kismet Server or Kismet Drone on their WRT54G, since this router has some of the best radios around, along with nice sturdy RP-TNC connectors to hook up even better antennas to without worry about damaging your wireless card or radio pigtails (I've gone through a number of PCI cards with RP-SMA connectors that keep breaking appart).

This Wiki assumes you already have a current build of DD-WRT installed on your router.

What is Kismet

Kismet is a layer 2 wireless network detector, sniffer, and intrusion detection kit.

Kismet is an OSS project for Linux. Find out more information about it at the Official Kismet Wireless site.

Since Kismet is a Linux project, it can run as either the full server, or just a drone server on the WRT54G router. You are then free to run a Kismet client on your desktop computer view the output.

Server or Drone

Drone

The Kismet project has developed the capability of running Drones: devices with wireless cards that mearly send their data back to a Kismet server. If you run the Kismet Drone on your DD-WRT box, you'll need to run the client and the server elsewhere. Both can be on your desktop computer, or you could have a machine somewhere else running just the server. Running a Kismet drone on your WRT and the Client/Server on a desktop computer(s) seems to be the most common installation. [I was not able to get this to work, so someone else will have to write that part of the HowTo.]
Install on WRT54G/S

Server

Since the kismet server is capable of running on top of DD-WRT one is able to simplify the installation by only running a client on their desktop machine. I'm not exactly sure what the advantages are, except that this seemed to be easier to install.
Install on WRT54G/S

Installing & Configuring on the WRT54G

Drone

If you desire to install just the drone on the WRT54G, you'll have to wait until someone more knowledgeable comes along. You can try the links in the external links section.

Just remember that drone setup requires a server somewhere else (on the desktop perhaps?) as well as a client (on the same desktop maybe?) Continue to Desktop Configuration

Server

Assumptions

 --Your router has SSH configured and you can send files via SSH to and from your desktop
 --You have a text editor capable of Unix line delimiters. TextPad and win32pad are both acceptable (and free).
Failure to use one of these when editing text files will prevent your installation from working --You have telnet enabled on your router. --You have jffs enabled or do mind redoing this whenever the router reboots --I will assume you are installing to the jffs partition. If you are not, replace jffs with tmp or some other folder

Preperation

 The guy at Musatcha.com has put together a great binary to make installation simplier. Download it.
 --Extract the two files to somewhere on your computer.
 --Edit the kismet.conf file 
  -- Find the line "source=wrt54g..."
  -- Change it to "source=wrt54g,prism0,wrt54g"
  -- Find the line "allowedhosts=...."
  -- Change it to "allowedhosts=192.168.1.0/8"
    -- If you are not using 192.168.1.x for your network, substitute your network setup.

Copy the Files

 Load up WinSCP or some other SCP client to copy the files over
 --Browse to /jfss 
 --Make a folder called "kismet_server"
 --Copy kismet_server and kismet.conf from your computer to the /jfss/kismet_server folder on your wrt54g

Installation

 Telnet to your router and finish the configuration.
 -- telnet 192.168.1.1
   --Log in. username: root password : [Your-Routers-Password]
 Disable AP mode and enable passive mode (alternatively, you can choose client mode from the web interface)
 -- enter the command "wl ap 0"
 -- enter the command "wl passive 1"
 Make the server binary executabe
 -- enter the command "chmod 755 /jffs/kismet_server/kismet_server"

Run the Server

  A) You can launch the server on startup (let me know if you know how to do this).
  B) You can telnet into the router and launch it manually.
  C) You can launch the server manually from the web interface
  D) You can have a client, such as Musatcha.com, automatically telnet in and launch the server.

 Method A: You can launch the server on startup
 I'm not sure how to do this. I'm not a linux guy.
Continue to Desktop Configuration
 Method B: You can telnet into the router and launch it manually.
 Disadvantage: Server will stop if you close the telnet window
 --Telnet into the Router
 --enter the command /jfs/kismet_server/kismet_server -n -f /jfs/kismet_server/kismet.conf
Continue to Desktop Configuration
 Method C: Launch the server manually fromt the web interface
 Disadvantage: Server doesn't always start correctly, forcing a reboot to fix 
 --Log into your routers web interface.
 --Click on the Administration Tab
 --Click on the Diagnostics subtab
 --Click the run button
 --Enter the command in the command box and click the "cmd" button.
Continue to Desktop Configuration
 Method D: You can have a client, such as Musatcha.com, automatically telnet in and launch the server.
 Disadvantage: Currently can't send Usernames and Passwords, so you have to launch using another method.
 --Visit Musatcha's howto and view step 5.
Continue to Desktop Configuration

Installing & Configuring on the Desktop

When installed on WRT as drone

I didn't get the drone to work, so someone else will have to fill this in.

When installed on WRT as server

Choose a client:
If you have a linux box, you can run Kismet client right off your desktop.
If you have a Windows box, you have to do something else.
  A) Use Musatcha.com's WiFi mapping software.
  B) Run Compile Kismet to run on Cygwin
  C) Run the precompiled Kismet for windows on Cygwin.

 Method A: Musatcha.com's WiFi Mapping Software
 -- Read Step 5 from his guide
 Method B: Compile Kismet to run on Cygwin
 --Install Cygwin.
   -- Make sure to install the developer tools. You'll need gcc, make, subversion, etc
 -- svn the source into your cygwin
 -- make, etc. See the guide in the external links. I couldn't get this to work.
 Method C: Precompiled Kismet for Windows on Cygwin
 --Install Cygwin, a *nix environment for Windows. 
   --Minimal install is fine.
 --Download an unzip the precompiled client to a folder
 --Edit kismet_ui.conf to reflect your correct WRT LAN ip address
   --find "host=192.168.1.1:2501"
   --change it if your router is not 192.168.1.1
 --Run kismet_client.exe WHILE your server is running on the router. You may have to 
launch a cygwin command prompt first. Cygwin behaves kinda weird sometimes. --The client is entirely keyboard driven. Press the 'h' key for help. You'll probably want to turn off auto sort right
away so you can view extended information about individual networks. Press the 's' key to do this.

External Links

These are the references I used when creating this wiki
Kismet on the WAP54G
WRT54G with OpenWRT + kismet-drone + kismet-server and kismet_client for windows (XP) running on cygwin
Kismet on Windows How-To guide V0.1


You are here: Main Page/DD-WRT Doku (EN)/Kismet Server/Drone