wifi-honey

Overview

wifi-honey is a shell script bundled with the aircrack-ng suite that automates spinning up a fake access point cloned from a real target network (same SSID, and where possible matching channel/encryption presentation). Clients that auto-connect to the strongest/known SSID land on the honeypot instead, letting an assessor capture WPA handshakes or credentials, or simply demonstrate how easily client devices can be lured onto rogue APs.

Common Usage

Basic usage: clone target SSID on given channel using given interface

wifi-honey <SSID> <channel> <interface>

Example: clone “CorpWiFi” on channel 6 using wlan0 (must support monitor mode / AP mode)

wifi-honey CorpWiFi 6 wlan0

What It Does Under the Hood

# wifi-honey orchestrates airbase-ng + airodump-ng + a tcpdump capture,
# roughly equivalent to running manually:

airmon-ng start wlan0

Fake AP matching the target SSID

airbase-ng -e "CorpWiFi" -c 6 wlan0mon &

Capture handshakes from clients that connect

airodump-ng -c 6 --bssid <fake_bssid> -w honeypot_capture wlan0mon &

Log all traffic hitting the honeypot

tcpdump -i at0 -w honeypot_traffic.pcap

Tips

• Best used in engagements assessing client-side wireless behavior (auto-connect policies, lack of certificate validation on WPA-Enterprise clients).
• Capturing a handshake from a connecting client still requires cracking it offline (aircrack-ng/hashcat) unless clients hand over cleartext credentials via a captive portal variant.
• Requires a wireless adapter capable of AP mode in addition to monitor mode (most aircrack-ng-compatible chipsets qualify).

wifi-honey <ssid> <channel> <interface>

  ssid        SSID of the target network to clone
  channel     Wireless channel to broadcast on
  interface   Wireless interface to use (monitor/AP capable)

Behind the scenes runs:
  airmon-ng start <interface>
  airbase-ng -e <ssid> -c <channel> <interface>mon
  airodump-ng -c <channel> --bssid <fake_bssid> -w capture <interface>mon
  tcpdump -i at0 -w capture.pcap

Vue d’ensemble

wifi-honey est un script shell fourni avec la suite aircrack-ng qui automatise la mise en place d’un faux point d’accès cloné à partir d’un réseau cible réel (même SSID, et si possible présentation de canal/chiffrement identique). Les clients qui se connectent automatiquement au SSID le plus fort/connu atterrissent sur le pot de miel à la place, permettant à l’auditeur de capturer des handshakes WPA ou des identifiants, ou simplement de démontrer avec quelle facilité les appareils clients peuvent être attirés vers des points d’accès rogues.

Utilisation courante

# Utilisation de base : cloner le SSID cible sur le canal donné, avec l'interface donnée
wifi-honey <SSID> <channel> <interface>

# Exemple : cloner « CorpWiFi » sur le canal 6 avec wlan0 (doit supporter le mode
# monitor / mode AP)
wifi-honey CorpWiFi 6 wlan0

Ce qui se passe en coulisses

# wifi-honey orchestre airbase-ng + airodump-ng + une capture tcpdump,
# ce qui équivaut approximativement à lancer manuellement :

airmon-ng start wlan0

# Faux AP correspondant au SSID cible
airbase-ng -e "CorpWiFi" -c 6 wlan0mon &

# Capturer les handshakes des clients qui se connectent
airodump-ng -c 6 --bssid <fake_bssid> -w honeypot_capture wlan0mon &

# Journaliser tout le trafic touchant le pot de miel
tcpdump -i at0 -w honeypot_traffic.pcap

Conseils

• Idéal pour les missions évaluant le comportement wireless côté client (politiques de connexion automatique, absence de validation de certificat sur les clients WPA-Enterprise).
• Capturer un handshake d’un client qui se connecte nécessite quand même de le casser hors ligne (aircrack-ng/hashcat), sauf si les clients livrent des identifiants en clair via une variante à portail captif.
• Nécessite un adaptateur wireless capable du mode AP en plus du mode monitor (la plupart des chipsets compatibles aircrack-ng conviennent).

wifi-honey <ssid> <channel> <interface>

  ssid        SSID of the target network to clone
  channel     Wireless channel to broadcast on
  interface   Wireless interface to use (monitor/AP capable)

Behind the scenes runs:
  airmon-ng start <interface>
  airbase-ng -e <ssid> -c <channel> <interface>mon
  airodump-ng -c <channel> --bssid <fake_bssid> -w capture <interface>mon
  tcpdump -i at0 -w capture.pcap