Skip to content

ESP32 Wireless Intrusion Detection eXperiment

License

Notifications You must be signed in to change notification settings

invpe/ESPWatchTower

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image

🗼 WATCHTOWER

WatchTower is a simple yet very effective WiFi intrusion detection system designed to safeguard your home network against unauthorized access. By monitoring incoming data packets and comparing them to a whitelist of known devices, WatchTower swiftly identifies potential intruders. When an unknown device is detected, WatchTower triggers a red LED indicator, providing a visual alert. When there is nothing unusual happening, it stays in the shadows without any sign of life.

As with any "red" scenario it is good to dive deeper and either mark the device as trusted or change your Access Point password immediately. WatchTower enables telnet access for you to control its behaviour.

🗞️ Use case

Real world scenario where a friend of mine suspected his AP was used by his neighbour. Since APs are not user's friendly in terms of notifying you about breaches, i had an idea to simply shine a 🔴 when an untrusted device is found using his AP.

We went with WatchTower and found it really happening after few hours.

image

🅰️ How does it work

It is really simple, that's why i like it.

WatchTower will continosuly look for packets going through your AP over WIFI. All devices that happen to send data with your AP will be added to a list. Devices are marked untrusted by default, so you will need some minimal time to isolate the ones you trust. Then when you're all set, anytime a device that is untrusted is seen talking with your AP, you will get a 🔴

Under the hood, you will have access to a telnet server running on the WatchTower, there you can set names, trust, untrust, add, delete devices.

🚶‍♂️ Next steps if you're still interested.