Skip to content

saikek/esp-canary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ESP Build Codacy Badge

esp-canary

LOGO

What

This is simple ESP-8266 or ESP-32-based canary application that acts as a server on local network and notifies you if it is being accessed or scanned.

Ideally Nmap scan of services should return same results as real server. Any type of scan or connection attempt should notify you.

Why

My home network had grown exponentially with each added device: laptops, phones, nas, RPi's, smart-home devices. Even with correctly configured firewall - each of them poses a security threat.

I was looking for some simple bash script / application that would notify me when network is breached since first thing after getting in would be scanning the network.

The question was not if but when this would happen.

How to use:

  • Clone project
  • Update src/user_config.h contents with your settings
  • Upload file system image using platformio - PlatformIO: Upload file system image or pio run -t uploadfs
  • Upload sketch using PlatformIO: upload

Home-Assitant configuration

Nmap scan Status

It does reacts on NMap -A scan.

TODOs:

See TODO List

Credits:

About

Simple ESP8266 / ESP32 Canary that simulates predefined application server and notifies you using E-mail, Telegram, etc if it was accessed.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors