A brief explanation

This script provides way to setup a monitoring service of specific MACs for a Hostapd Wifi Access Point.

It uses the hostapd-cli list_sta to list the connected devices to the AP.

Setup

  1. Install python3

  2. Install telegram-send for python3

  3. Create your own telegram bot and configure telegram-send

    ⚠Important, since the script runs as root, set the configuration of telegram-send as root:

     $ sudo telegram-send --configure

  4. Setup hostapd and enable hostapd_cli by adding to the config

     ctrl_interface=/var/run/hostapd
 ctrl_interface_group=0

  5. Place the mac-monitoring.py, mac-monitoring.json in /etc/hostapd/

  6. Place the daemon file mac-monitoring.service at /etc/systemd/system/ and start the daemon

     $ sudo systemctl daemon-reload
 $ sudo systemctl enable --now mac-monitoring
 $ sudo systemctl restart mac-monitoring

  7. Configure the MACs you want to monitor

Configure the MACs to monitor

  1. Set your MAC monitoring filter with the file ac-monitoring.json. The format is:
["mac0", …, "macN"]
  1. Restart the daemon
$ sudo systemctl restart mac-monitoring

mac-monitoring.json

format

["mac0", …, "macN"]

example

["48:01:C5:76:14:53", "87:0F:32:45:01:64"]

GitHub

View Github