Subsections

1.7 Konfiguration von OPT_VOUCHER

OPT_C3SURF_VOUCHER

OPT_C3SURF_VOUCHER='no'

Das Gutscheinsystem von Opt C3SURF_VOUCHER aktivieren ('yes'), Standard ist 'no'. Gutscheine sind anonyme aber sichere Einmal-Accounts, die zur Anmeldung verwendet werden können. Voraussetzung ist die Einstellung OPT_LOGINUSR='yes'.

Die Erzeugung und Löschung der Gutscheine übernehmen zwei nächtliche cron JOBs, welche jederzeit auch manuell(Admin-Interface) gestartet werden können. Im Folgenden wird erklärt wie diese Jobs verwaltet werden.

Alle neu generierten Gutscheine werden an eine Druckliste angehängt. Nur in der Druckliste ist das zum Gutschein gehörende Kennwort im Klartext gespeichert. Du kannst diese Liste jederzeit Herunterladen, Drucken oder Löschen. Nach dem Löschen der Liste kann das Kennwort nicht wieder ermittelt werden. Normal wird die Liste zuerst gedruckt und dann gelöscht. Es darf immer nur ein gedrucktes Exemplar eines Gutscheines geben. Die Druckfunktion ist in html implementiert, Seitenumbrüche werden leider nicht beachtet. Gutscheine, die durch Seitenwechsel nicht gedruckt werden, sollten vernichtet werden (allerdings verfallen sie sowieso durch Zeitablauf). Listen, die nicht gedruckt, sondern heruntergeladen wurden, können mit anderen Programmen ein eigenes Layout erhalten, welches dann auch Seitenwechsel sauber berücksichtigt.

C3SURF_VOUCHER_N

C3SURF_VOUCHER_N='n'

Wertebereich: 0 und Natürliche Zahlen

Wie viele verschiedene Gutscheinkategorien sollen erzeugt werden? Wichtigstes Kriterium für Gutscheine ist die Laufzeit. Daneben gibt man noch die Anzahl der Gutscheine und deren Gültigkeit in Tagen an. Siehe auch die folgenden Variablen.

C3SURF_VOUCHER_x_TIME

C3SURF_VOUCHER_x_TIME='30'

Wertebereich: Natürliche Zahlen

Laufzeit in Minuten (hier: 30) für einen Gutschein dieser Kategorie ('n' siehe oben).

C3SURF_VOUCHER_x_COUNT

C3SURF_VOUCHER_x_COUNT='3'

Wertebereich: Natürliche Zahlen

Wie viele Gutscheine dieser Kategorie (in diesm Fall 3) sollen erzeugt werden?

C3SURF_VOUCHER_x_DAYS

C3SURF_VOUCHER_x_DAYS='90'

Wertebereich: 0 und Natürliche Zahlen

Wie viele Tage soll der Gutschein ab seiner Erzeugung gültig sein (hier:90). Damit wird ein Verfallsdatum für diesen Gutschein erzeugt. Die Löschung erfolgt dann entweder manuell oder per cron-Job. Der Gutschein erlischt, wenn er das erste Mal verwendet wird.


Wichtig: '0' bedeutet, dass Gutscheine dieser Kategorie kein Verfallsdatum haben. Sie werden erst mit Benutzung oder wenn die Zeit komplett verbraucht wurde ungültig (wird auch durch C3SURF_VOUCHER_LIVES_N beeinflusst). Sie können jedoch jederzeit im Admin-Interface des fli4l gelöscht werden.

1.7.1 Optionale Parameter OPT_VOUCHER

C3SURF_VOUCHER_x_LIVES

C3SURF_VOUCHER_x_LIVES='n'

Wertebereich(n): -1, 0, Natürliche Zahlen

Angabe von Stunden, die der Voucher nach der ersten Anmeldung noch gültig ist.


Sonderfälle:

Diese Gutscheine werden nicht mit der ersten Anmeldung ungültig, sondern gelten 'n' Stunden weiter. Sobald der Gutschein benutzt wird, wird daraus ein zeitlich limitierter LOGINUSR-Account generiert oder es wird das Verfallsdatum des Vouchers neu berechnet. Dieser Account / Voucher darf sich beliebig oft an und wieder abmelden. Es wird das von LOGIN_USR gewohnte Quota-System für diesen Account verwendet. Erst wenn die gesamte Zeit verbraucht ist oder wenn das Verfallsdatum (C3SURF_VOUCHER_DAYS_N) erreicht wurde, wird dieser Account automatisch von C3SURF gelöscht.

C3SURF_VOUCHER_DEL_CRON

C3SURF_VOUCHER_DEL_CRON='0 4 * * *'

Wertebereich: 'cron-Syntax' oder 'never'

Der oben angegebene Wert ist der Standard, wenn diese Variable in der config-Datei 'c3surf.txt' fehlt. Standard: lösche täglich morgens um 4 Uhr alle verfallenen Guscheine.

Die cron-Syntax ist einzuhalten und wird nicht geprüft. Zusätzlich kann der Wert 'never' verwendet werden. Dann wird der Job vom System überhaupt nicht eingeplant. Man kann im Admin-Interface jederzeit manuell alle verfallenen Gutscheine löschen lassen.

C3SURF_VOUCHER_GEN_CRON

C3SURF_VOUCHER_GEN_CRON='15 4 * * *'

Wertebereich: 'cron-Syntax' oder 'never'

Der oben angegebene Wert ist der Standard, wenn diese Variable in der config-Datei 'c3surf.txt' fehlt. Standard: generiere täglich morgens um 4:15 Uhr neue Gutscheine, falls weniger als C3SURF_VOUCHER_COUNT vorhanden sind.

Die cron-Syntax ist einzuhalten und wird nicht geprüft. Zusätzlich kann der Wert 'never' verwendet werden. Dann wird der Job vom System überhaupt nicht eingeplant. Man kann im Admin-Interface jederzeit manuell neue Gutscheine bis zur Menge
C3SURF_VOUCHER_x_COUNT erzeugen lassen.

Alle neu generierten Gutscheine werden an eine Druckliste angehängt. Nur in der Druckliste ist das zum Gutschein gehörende Kennwort im Klartext gespeichert. Jeder Gutschein sollte nur einmal gedruckt werden. Die Liste sollte sofort nach dem Ausdruck oder Herunterladen gelöscht werden.

C3SURF_VOUCHER_PRTUPDATE

Standard-Einstellung: C3SURF_VOUCHER_PRTUPDATE='no'

Wertebereich: 'yes' oder 'no'

Aktualisierung der Druckdatei. Meine Empfehlung: 'no'. Wer wenige Gutscheine im System hält und die Druckdatei nach dem Ausdruck oder Herunterladen nicht löschen möchte, kann mit 'yes' eine Aktualisierung der Druckdatei beim Verbrauch von Gutscheinen einstellen. Bei der Wahl von 'yes' werden benutzte Gutscheine auch aus der Druckdatei gelöscht. Das benötigt Ressourcen auf dem Router.

C3SURF_VOUCHER_USRLEN

Standard-Einstellung: C3SURF_VOUCHER_USRLEN='12'

Wertebereich: '1-16'

Zeichenlänge für Gutscheinaccount festlegen, ab 8 Zeichen werden '-' als Trenner eingebaut, die auch eingegeben werden müssen. Es werden immer vier Zeichen gruppiert. Der Maximalwert ist 16.

C3SURF_VOUCHER_USRCAP

Standard-Einstellung: C3SURF_VOUCHER_USRCAP='random'

- 'yes' : nur Großbuchstaben
- 'no' : nur Kleinbuchstaben
- 'random' : zufällige Wechsel von Groß- Kleinschreibung (Empfehlung)

Mit dieser Variable wird festgelegt ob Groß- oder Kleinbuchstaben im Benutzernamen verwendet werden sollen. Der Wert 'random' (empfohlen) bewirkt eine zufällige Auswahl.

C3SURF_VOUCHER_PWDLEN

Standard-Einstellung: C3SURF_VOUCHER_PWDLEN='6'

Wertebereich: 1-12

Zeichenlänge für das Gutschein-Password.

C3SURF_VOUCHER_PWDMOD

Standard-Einstellung: C3SURF_VOUCHER_PWDMOD='3'

Wertebereich: 1-5

Modulo für zufällige Verlängerung des Passwortes. Max: 5 (die Werte 0, 1, 2, 3, 4), Min 1 (der Wert 0). Es wird bei der Password-Generierung das Password zufällig um die möglichen Werte verlängert. Damit ergeben sich per default Password-Längen zwischen 6 und 8. Maximal einstellbar sind Password-Längen zwischen 12 und 16, das ist sicher genug mit zufälliger Groß- und Kleinschreibung.

C3SURF_VOUCHER_PWDCAP

Standard-Einstellung: C3SURF_VOUCHER_PWDCAP='random'

- 'yes' : nur Großbuchstaben
- 'no' : nur Kleinbuchstaben
- 'random' : zufälliger Wechsel von Groß- und Kleinschreibung (Empfehlung)

Mit dieser Variablen wird festgelegt ob Groß- oder Kleinbuchstaben im Passwort verwendet werden sollen. Der Wert 'random' (empfohlen) bewirkt eine zufällige Auswahl.

© 2001-2015 Das fli4l-Team - July 26, 2015