routeros-scripts/doc/collect-wireless-mac.md
Michael Gisbers 8375673d93 global-functions: implement notifications via Matrix
Matrix is an open network for secure, decentralized communication - and
it has a web api.

A warning on message type: Using 'm.notice' breaks rendering on Element
for Android (no fixed width font) and does not pop up desktop
notification. Thus we use 'm.text'. Should be safe as we do not send the
messages in response to other messages.

https://matrix.org/
2021-06-08 21:07:25 +02:00

1.6 KiB

Collect MAC addresses in wireless access list

◀ Go back to main README

🛈 This script can not be used on its own but requires the base installation. See main README for details.

Description

This script adds unknown MAC addresses of connected wireless devices to address list. In addition a notification is sent.

By default the access list entry is disabled, but you can easily enable and modify it to your needs.

Requirements and installation

Depending on whether you use CAPsMAN (/ caps-man) or local wireless interface (/ interface wireless) you need to install a different script.

For CAPsMAN:

$ScriptInstallUpdate collect-wireless-mac.capsman;

For local interface:

$ScriptInstallUpdate collect-wireless-mac.local;

Configuration

On first run a disabled access list entry acting as marker (with comment "--- collected above ---") is added. Move this entry to define where new entries are to be added.

Also notification settings are required for e-mail, matrix and/or telegram.

Usage and invocation

Run this script from a dhcp server as lease-script to collect the MAC address when a new address is leased. You may want to use lease-script.

See also


◀ Go back to main README
▲ Go back to top