routeros-scripts/doc/collect-wireless-mac.md
Christian Hesse 009674b5bc bump RouterOS requirement for all scripts and modules...
... now that global-functions requires RouterOS 7.13 anyway.
2024-04-07 22:51:24 +02:00

3 KiB
Raw Blame History

Collect MAC addresses in wireless access list

GitHub stars GitHub forks GitHub watchers required RouterOS version Telegram group @routeros_scripts donate with PayPal

⬅️ Go back to main README

Info: 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.

Sample notification

collect-wireless-mac notification

Requirements and installation

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

For wifi:

$ScriptInstallUpdate collect-wireless-mac.wifi;

For legacy CAPsMAN:

$ScriptInstallUpdate collect-wireless-mac.capsman;

For legacy 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, ntfy 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