#acl AdminGroup:read,write,delete,revert,admin All:read

<<TableOfContents(3)>>

= 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:

|| Feld || Wert ||
|| Roll # || <Bisherig vorhandene Voucher Rolls + 1> ||
|| Minutes per ticket || <gewünschte Dauer (z.B. "1440" (24h) oder "10080" (7 Tage))> ||
|| Count || <gewünschte Ticketanzahl> ||
|| Comment || "Vouchers mit <Dauer> validity" ||

 * 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.