emreutkan / jukebox

Wireless Network Security Auditing Tool

Jukebox

Interactive toolkit designed for Wi-Fi network attacks and analyses. Jukebox automates tasks such as network scanning, device deauthentication, packet capturing, and the cracking of WPA/WPA2 security protocols through minimal user input. It employs a menu that guides the user through selecting options and executing attacks

Features

• Interface Management
• MAC Address Spoofing
• Network Scanning and Target Selection
• Deauthentication Attacks
• Packet Capture
• Handshake Capture
• WPA Key Cracking

Prerequisites

• Python 3
• Linux environment

Installation

• current installer supports Debian/Arch based dirstros, for others you have to do it manually.

jukebox's Issues

capture_handshake gives authentication error on target even though the authentication iis PSK

Issue

When executing capture_handshake, if airodump-ng does not discover the network within

output = get_airodump_output(interface)

then the target network will not appear in the output variable. Due to this, get_SSIDs_with_PSK_authentication_from_output(output) proceeds without the target network information:

authentications = SSIDs_with_PSK_authentication_from_output(output)

This results in the authentications variable not including the target network in the PSK list, leading to the output: "target network is not authenticated with PSK."

null return after recursion in get_BSSID_and_Station_from_AP

When attempting to retrieve the BSSID and CHANNEL from the function get_BSSID_and_Station_from_AP, if the network information is not found on the first attempt due to airodump-ng not detecting the SSID, the function may still succeed after multiple attempts. However, even though eventually being successful, it will still return the results as Null.

Error:

BSSID, CHANNEL = get_BSSID_and_Station_from_AP(interface, target_ap)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/home/kali/PycharmProjects/jukebox/Network.py", line 268, in get_BSSID_and_Station_from_AP
recursion()
File "/home/kali/PycharmProjects/jukebox/Network.py", line 213, in recursion
BSSID,STATION = get_BSSID_and_Station_from_AP(interface, targetAP) # this function is called to assign it to a variable
^^^^^^^^^^^^^
TypeError: cannot unpack non-iterable NoneType object

faster implementation of get_BSSID_and_Station_from_AP

The time it takes to run the following function is reasonable, since we don't know which SSID the user will choose as the target. It waits a while (10 seconds) to gather all the network data:

def get_devices_in_AP_output(interface, targetAP)

This function does the same thing as the function above, but the goal is different, this time the aim is to get information on a single SSID.

But why maintain the same wait time of 10 seconds instead of reducing it to 3 seconds? Well most attempts to scan the target would not be successful if the wait time were shorter, given that it must scan all networks and it happens to be that our target is somewhere in there for sure in around 10 seconds:

def get_BSSID_and_Station_from_AP(interface, targetAP)

The reason for this approach was my initial unawareness of the -N parameter in airodump-ng, which allows for running airodump-ng on a specific SSID (not BSSID), a discovery made through a random exploration of the manual pages