search

wifiphisher / roguehostapd

Hostapd fork including Wi-Fi attacks and providing Python bindings with ctypes.
BSD 3-Clause "New" or "Revised" License
173 stars 67 forks source link
hostapd python wifi

readme

roguehostapd

Roguehostapd is a fork of hostapd, the famous user space software access point. It provides Python ctypes bindings and a number of additional attack features. It was primarily developed for use in the Wifiphisher project.

Build

To build the latest development version type the following commands:

git clone https://github.com/wifiphisher/roguehostapd.git # Download the latest version
cd roguehostapd # Switch to the roguehostapd directory
python setup.py install # Build the shared library of hostapd

Usage

python run.py -i wlan0 -ssid haha

Use wlan0 for spawning the OPEN rogue AP on channel 6 and the ssid is haha.

python run.py -i wlan0 -ssid haha -pK 12345678

Use wlan0 for spawning the WPA2/WPA rogue AP with passhrase 12345678

python run.py -i wlan0 -ssid haha -kA

Use wlan0 for spawning the OPEN rogue AP supporting the KARMA attack.

HOSTAPD_CONFIG_DICT = {
    'ssid': 'haha',
    'interface': 'wlan0',
    'karma_enable': 1}
HOSTAPD_OPTION_DICT = {
    'debug_level': hostapd_constants.HOSTAPD_DEBUG_OFF
}
HOSTAPD_OBJ = Hostapd()
HOSTAPD_OBJ.start(HOSTAPD_CONFIG_DICT, HOSTAPD_OPTION_DICT)

The above configuration will perform the KARMA attack.

Following are all the options along with their descriptions (also available with python run.py -h)

Short form Long form Explanation
-h --help show this help message and exit
-ssid SSID --ssid SSID Select the ssid for the spawn rogue AP
-c CHANNEL --channel CHANNEL Select the channel number for the spawn rogue AP
-bI BEACON_INT --beacon_int BEACON_INT Define the beacon interval in milliseconds for the spawn rogue AP
-i INTERFACE --interface INTERFACE Select the interface for the spawn rogue AP. Example: -i wlan0
-pK WPA_PASSPHRASE --wpa_passphrase WPA_PASSPHRASE Define the password for the spawn rogue AP.
-kA Enabling the KARMA attack
-dV --debug-verbose Enabling the verbose debug log
-K --key_data Include key data in debug messages
-t --timestamp Include timestamps in some debug messages
-v --version Show hostapd version