Erstellen und Verteilen der CaptivePortal Gäste Voucher

Erstellen der Voucher via pfSense

• Auf der pfSense des Standortes (10.0.0.1) einwählen mit den Zugangsdaten aus dem admin-creds.

• Nach erfolgreicher Anmeldung auf Services klicken und dort CaptivePortal auswählen.

• Nun werden die vorhandenen CaptivePortal Netze aufgelistet.

• Hier hinter dem gewünschten Netz (z.B. <SCHULE>_GAESTE_Captive_Portal ) auf Edit klicken.

• In den Reiter Vouchers wechseln, wo die bisher vorhandenen Voucher-Rolls aufgelistet sind und auf Add klicken.

• Nun wie gewünscht ausfüllen:

• danach kann die Voucker-Roll als .csv exportiert werden.

Erstellen der PDF-Datei mit Zugangsdaten

Im credential-sheets git im Unterordner der Schule einen Ordner "Wifi-Vouchers" erstellen.

Dort folgende Dateien erstellen:

header.tex mit dem Inhalt:

\documentclass[a4paper,12pt]{scrartcl}
\usepackage[utf8]{inputenc}
\usepackage{cmbright}
\usepackage[noheadfoot, left=1cm, right=1cm, top=4.93mm, bottom=4.93mm]{geometry}

\usepackage[T1]{fontenc}

\usepackage{ngerman}
\usepackage[newdimens]{labels}

\LabelInfotrue
\LabelGridtrue
\LabelRows=@@@_ROWS_@@@
\LabelCols=@@@_COLS_@@@
\LeftPageMargin=10mm
\RightPageMargin=10mm
\TopPageMargin=4.93mm
\BottomPageMargin=4.93mm
\InterLabelRow=2mm
\InterLabelColumn=2mm

\begin{document}

\begin{labels}

wifigutscheine-template.tex mit dem Inhalt:

\textbf{WiFi-Zugang zum Netzwerk (ESSID): VAR-essid}\smallskip
WLAN-Passwort: \texttt{Di1PkfGd<SCHULE>}\smallskip
Merksatz f"ur WLAN-Passwort: \textbf{D}ies \textbf{i}st \textbf{1} \textbf{P}ass\textbf{k}ey \textbf{f}ür \textbf{G}"aste \textbf{d}es \textbf{<SCHULE>}\smallskip
Zugangs-Code (Voucher-Code): \texttt{VAR-code}
G"ultigkeitsdauer: VAR-duration\bigskip
Der G"ultigkeitszeitraum dieses WiFi-Gutschein beginnt nach erster Anmeldung mit dem o.\,g. Zugangs-Code.
~

In diesen Ordner werden die via pfSense erstellten und als .csv heruntergeladenen Voucher-Rolls kopiert und folgendermaßen angepasst:

Umbennen von <VoucherRoll>.csv nach <Erstelldatum>_<VoucherRoll>.csv.

Anpassen der .csv-Datei selber mit folgenden Spalten:

essid,login,code,duration
<SCHULE>-GAESTE,-, <Voucher-Codes>,<Gültigkeitsdauer>

Dann mit dem Tool credential-sheets die .pdf erstellen, über welche die Voucher-Login-Daten an die Nutzer verteilt werden:

credential-sheets --template=/path/to/wifigutscheine --cols=1 --rows=5 <Voucher-Roll>.csv

Hinweis: credential-sheets vervollständigt automatisch die unter --template= angegebene Datei mit -template.tex. Es muss also zB die Datei wifigutscheine_<SCHULE>-template.tex heißen und mit -template=/path/to/wifigutscheine_<SCHULE> angegebene werden, da sonst das Skript nicht funktioniert.