Skip to content

Setup a hostapd AP to conntrol the connections of specific MACs

License

Notifications You must be signed in to change notification settings

mattcarter11/hostapd-mac-monitor

Repository files navigation

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"]

About

Setup a hostapd AP to conntrol the connections of specific MACs

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages