TwinHunter

KO | EN

gitlite — search

#hacktoberfest #react #typescript #golang #linux #docker #macos #cli #kubernetes #vue #security #pytorch #ios #mcp

(★ 16)

A proof of concept project to detect an stop Evil Twin Attacks.

TwinHunter 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TwinHunter

A proof of concept project to detect an stop Evil Twin Attacks.

## What It Does

Scans the wireless airspace and looks for wireless access points that may be imitating a legitmate one (this is called an evil twin attack). If an Evil Twin is discovered then it will be instantly flooded with deauth frames preventing any clients from connecting to it.

## Known Issues

- No channel hopping
- Deauthing never stops even if the access point goes away
- Threads opened by the `Deauther` are not stopped properly
- Observers of the `Scanner` object are not stopped properly

## Goals

- Fix the known issues
- Allow white listing of multiple wifi access points
- Allow the use of multiple wifi interfaces to limit the amount of channel hopping a single interface needs to do
- Be able to detect and respond to other wifi events not just beacons

## Setup

This projects requires Python 3.5 or greater.

- Clone the repo:

```bash
  git clone https://github.com/frozenjava/TwinHunter.git
  ```

- Install the requirements

```bash
  cd TwinHunter
  pip install -r requirements.txt
  ```

- Identify your wireless card with `ifconfig`. Assuming `wlan0` for this README.

The remaining steps will need to be run with root privileges.

- Put your wireless interface into monitor mode

```bash
  airmon-ng start wlan0
  ```

- Run the script using the WiFi name (ESSID) and a mac address serving that WiFi (BSSID)

```bash
  chmod +x twinhunter.py
  ./twinhunter.py --iface wlan0mon --essid home --bssid 00:11:22:33:44:55
  ```

Once it successfully discovers the net work you will see a log similar to

```bash 
Discorvered Accesspoint => BSSID: 00:11:22:33:44:55 | ESSID: home
```

The process will continue to scan for evil twins. If one is discovered, additional logs will appear

```bash
FOUND EVIL TWIN!!! BSSID: 00:11:22:33:44:55 | ESSID: home
```

TwinHunter

TwinHunter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

TwinHunter

TwinHunter 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README