routeros-scripts/doc/daily-psk.md

70 lines
2.4 KiB
Markdown
Raw Normal View History

2020-03-27 20:44:36 +00:00
Use wireless network with daily psk
===================================
[⬅️ Go back to main README](../README.md)
2020-03-27 20:44:36 +00:00
> **Info**: This script can not be used on its own but requires the base
2022-02-11 22:34:39 +00:00
> installation. See [main README](../README.md) for details.
2020-03-27 20:44:36 +00:00
Description
-----------
This script is supposed to provide a wifi network which changes the
passphrase to a pseudo-random string daily.
2021-06-17 13:23:51 +00:00
### Sample notification
![daily-psk notification](daily-psk.d/notification.avif)
2021-06-17 13:23:51 +00:00
2020-03-27 20:44:36 +00:00
Requirements and installation
-----------------------------
Just install this script.
2020-03-27 20:44:36 +00:00
2022-05-11 08:00:56 +00:00
Depending on whether you use CAPsMAN (`/caps-man`) or local wireless
interface (`/interface/wireless`) you need to install a different script
and add schedulers to run the script:
2020-03-27 20:44:36 +00:00
For CAPsMAN:
$ScriptInstallUpdate daily-psk.capsman;
/system/scheduler/add interval=1d name=daily-psk on-event="/system/script/run daily-psk.capsman;" start-time=03:00:00;
/system/scheduler/add name=daily-psk@startup on-event="/system/script/run daily-psk.capsman;" start-time=startup;
2020-03-27 20:44:36 +00:00
For local interface:
$ScriptInstallUpdate daily-psk.local;
/system/scheduler/add interval=1d name=daily-psk on-event="/system/script/run daily-psk.local;" start-time=03:00:00;
/system/scheduler/add name=daily-psk@startup on-event="/system/script/run daily-psk.local;" start-time=startup;
2020-03-27 20:44:36 +00:00
These will update the passphrase on boot and nightly at 3:00.
Configuration
-------------
The configuration goes to `global-config-overlay`, these are the parameters:
* `DailyPskMatchComment`: pattern to match the wireless access list comment
* `DailyPskSecrets`: an array with pseudo random strings
> **Info**: Copy relevant configuration from
> [`global-config`](../global-config.rsc) (the one without `-overlay`) to
> your local `global-config-overlay` and modify it to your specific needs.
Then add an access list entry. For CAPsMAN:
/caps-man/access-list/add comment="Daily PSK" ssid-regexp="-guest\$" private-passphrase="ToBeChangedDaily";
For local interface:
2020-03-27 20:44:36 +00:00
2022-05-11 08:00:56 +00:00
/interface/wireless/access-list/add comment="Daily PSK" interface=wl-daily private-pre-shared-key="ToBeChangedDaily";
2020-03-27 20:44:36 +00:00
Also notification settings are required for
[e-mail](mod/notification-email.md),
2021-11-16 15:03:25 +00:00
[matrix](mod/notification-matrix.md) and/or
2021-11-16 15:03:43 +00:00
[telegram](mod/notification-telegram.md).
2020-03-27 20:44:36 +00:00
---
[⬅️ Go back to main README](../README.md)
[⬆️ Go back to top](#top)