#----------------------------------------------------------------------------
# onkonto.txt - OnKonto Dokumentation
#
# Package:      OnKonto - Version: 0.11
#
# Creation:     07/03/2004  Dennis Kellerer <Dennis.Kellerer@gmx.net>
# Last Update:  07/27/2004  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#----------------------------------------------------------------------------
# Changelog:
#
# 07/03/2004  -  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#                - initial release
#
# 07/03/2004  -  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#                - time statements now in minutes
#
# 07/04/2004  -  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#                - ONKONTO_NETMASK not needed anymore
#
# 07/22/2004  -  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#                - user-based controlling
#
# 07/27/2004  -  Dennis Kellerer <Dennis.Kellerer@gmx.net>
#                - dns-resolving prohibited for locked clients
#----------------------------------------------------------------------------



               --- Online-Konto - Dokumentation ---

Dieses Paket stellt fr bestimmte Benutzer und PC's tgliche Onlinezeiten zur
Verfgung, die dann abge"-surft" werden knnen oder aber auch bis zu einer
bestimmten Obergrenze gesammelt werden knnen.



Gesperrte PC's mssen sich ber: http://192.168.6.1/onkonto

anmelden bzw. abmelden. Diese Seite kann der Einfachheit halber als Start-
seite fr den Browser definiert werden.

Da seit der Version 0.11 das DNS-Resolving unterbunden wurde, sollte die
IP-Adresse verwendet werden. Des weiteren ist es sinnvoll, den Proxy in den
Browser einzutragen (Standard-Einstellung ist Port 8118) und fr lokale
Adressen abzustellen.




IP-Adressen bzw. Hostnamen entsprechend der eigenen Konfiguration abndern.


Diese Dokumentation gibt (vorerst) nur einen kurzen berblick ber das
opt-Paket.

Die finale Doku wird demnchst (naja) released, wenn alle ToDo's in das Paket
eingebaut wurden.






Konfiguration:

OPT_ONKONTO='yes'                       # 'yes' oder 'no'
                                        # aktiviert / deaktiviert das Paket

ONKONTO_WORKDIR='/usr/local/OnKonto'    # Pfad, in dem OnKonto die Konten-
                                        # Daten abspeichert

ONKONTO_LOG='no'                        # 'yes' oder 'no'
                                        # aktiviert / deaktiviert das Logging

ONKONTO_LOGDIR='/var/log/OnKonto'       # Pfad, in dem das Logfile
                                        # gespeichert wird

ONKONTO_HTTP_CONFIG='yes'               # 'yes' oder 'no'
                                        # aktiviert / deaktiviert die
                                        # Kontenverwaltung via Webinterface
                                        # Achtung: Zugriff sollte durch
                                        # Passwort im httpd-Paket geschtzt
                                        # werden (USER_RIGHTS fr Bereich
                                        # 'onkonto:edit', Nheres siehe
                                        # httpd-Dokumentation)

ONKONTO_IP_N='2'                        # Anzahl der berwachten PC's

ONKONTO_IP_1='192.168.6.11'             # IP-Adresse des ersten PC's
ONKONTO_IP_1_PRESELECT_USER='1'         # Standard-User (siehe weiter unten)
                                        # fr diesen PC (fr komfortableres
                                        # einloggen)
ONKONTO_IP_2='192.168.6.12'             # 2. PC
ONKONTO_IP_2_PRESELECT_USER='0'         # hier ist kein Standard-Benutzer vor-
                                        # gewhlt (in der Anmeldemaske auf der
                                        # webseite)

ONKONTO_USER_N='4'                      # Anzahl der Benutzer(-konten)

ONKONTO_USER_1_NAME='ich chef'          # Name von Benutzer eins
ONKONTO_USER_1_PASSWORD='4711'          # Passwort von Benutzer 1
ONKONTO_USER_1_STARTMINUTES='180'       # Anzahl der verfgbaren Onlineminuten
                                        # nach dem hochfahren des Routers
ONKONTO_USER_1_ADD_AT_NIGHT='120'       # Anzahl der Minuten, die um Mitternacht
                                        # addiert werden
ONKONTO_USER_1_MAX_MINUTES='240'        # Obergrenze der sammelbaren Minuten
ONKONTO_USER_1_PROXY_ENABLED='yes'      # Proxy an oder aus fr diesen Benutzer
                                        # Falls der Proxyzugang erlaubt wurde,
                                        # kann der Benutzer auf Webseiten
                                        # gehen, auch wenn er nicht online ist
                                        # (sinnvoll wenn http erlaubt werden soll
                                        # aber bspw. Online-Spiele nicht)

ONKONTO_USER_2_NAME='du nix'            # Zweiter Benutzer
ONKONTO_USER_2_PASSWORD='08/15'         # Passwort
ONKONTO_USER_2_STARTMINUTES='120'       # siehe oben
ONKONTO_USER_2_ADD_AT_NIGHT='120'       # siehe Benutzer 1
ONKONTO_USER_2_MAX_MINUTES='180'        # siehe oben
ONKONTO_USER_2_PROXY_ENABLED='no'       # Benutzer kann erst ins Internet, wenn
                                        # er Online ist (nur anmelden reicht hier
                                        # nicht!)

ONKONTO_USER_3_NAME='Mo-Do'             # s.o.
ONKONTO_USER_3_PASSWORD='12polizei'     # s.o.
ONKONTO_USER_3_STARTMINUTES='0'         # s.o.
ONKONTO_USER_3_ADD_AT_NIGHT='0'         # s.o.
ONKONTO_USER_3_MAX_MINUTES='0'          # s.o.
ONKONTO_USER_3_PROXY_ENABLED='yes'      # s.o.

ONKONTO_USER_4_NAME='gast'              # s.o.
ONKONTO_USER_4_PASSWORD=''              # s.o.
ONKONTO_USER_4_STARTMINUTES='0'         # s.o.
ONKONTO_USER_4_ADD_AT_NIGHT='0'         # s.o.
ONKONTO_USER_4_MAX_MINUTES='0'          # s.o.
ONKONTO_USER_4_PROXY_ENABLED='yes'      # s.o.





ToDo's:
-------

- An-/Abmelden ber kleines Windows-Programm

- Wochenend-Schaltung: am WE (Freitag auf Samstag, Samstag auf Sonntag)
                       wird die Obergrenze der Konten hochgeschraubt und
                       auch mehr Freiminuten addiert

- Konfiguration ber das Webinterface

- Logfile-Ausgabe

- Einfachere Variablen-bergebung von der config-Datei in die Shell-Skripte

- Weitere Konfigurationsmglichkeiten, bspw. gezielteres Sperren von IP's,

- ...

- Doku berarbeiten :o)



Done:
-----

- Einfhrung einzelner Benutzer, damit knnen Benutzer von verschiedenen IP's
  aus ins Web gehen.



Thx to:
-------

- Sebastian Bognar, der mich auf das Problem mit der DNS-Namensauflsung
  aufmerksam gemacht hat.
