add doc/daily-psk.md

This commit is contained in:
Christian Hesse 2020-03-27 21:44:36 +01:00
parent 79e7b3229f
commit e949e527f6
4 changed files with 59 additions and 0 deletions

View file

@ -4,6 +4,7 @@
# Michael Gisbers <michael@gisbers.de>
#
# update daily PSK (pre shared key)
# https://git.eworm.de/cgit/routeros-scripts/about/doc/daily-psk.md
#
# !! Do not edit this file, it is generated from template!

View file

@ -4,6 +4,7 @@
# Michael Gisbers <michael@gisbers.de>
#
# update daily PSK (pre shared key)
# https://git.eworm.de/cgit/routeros-scripts/about/doc/daily-psk.md
#
# !! Do not edit this file, it is generated from template!

View file

@ -4,6 +4,7 @@
# Michael Gisbers <michael@gisbers.de>
#
# update daily PSK (pre shared key)
# https://git.eworm.de/cgit/routeros-scripts/about/doc/daily-psk.md
#
# !! This is just a template! Replace '%PATH%' with 'caps-man'
# !! or 'interface wireless'!

56
doc/daily-psk.md Normal file
View file

@ -0,0 +1,56 @@
Use wireless network with daily psk
===================================
[◀ Go back to main README](../README.md)
Description
-----------
This script is supposed to provide a wifi network which changes the
passphrase to a pseudo-random string daily.
Requirements and installation
-----------------------------
Just install this script and [global-wait](global-wait.md).
Depending on whether you use CAPsMAN (`/ caps-man`) or local wireless
interface (`/ interface wireless`) you need to install a different script.
For CAPsMAN:
$ScriptInstallUpdate daily-psk.capsman,global-wait;
For local interface:
$ScriptInstallUpdate daily-psk.local,global-wait;
And add schedulers to run the script:
/ system scheduler add interval=1d name=daily-psk-nightly on-event="/ system script run daily-psk.local;" start-date=may/23/2018 start-time=03:00:00;
/ system scheduler add name=daily-psk-startup on-event=":global WaitTimeSync; / system script { run global-wait; \$WaitTimeSync; run daily-psk.local; }" start-time=startup;
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
Then add an access list entry:
/ interface wireless access-list add comment="Daily PSK" interface=wl-daily private-pre-shared-key="ToBeChangedDaily";
Also notification settings are required for e-mail and telegram.
See also
--------
* [Wait for configuration und functions](global-wait.md)
---
[◀ Go back to main README](../README.md)
[▲ Go back to top](#top)