trustDesk basic readme.txt
==========================

-Linux 
-Mac OS X

************************************************************************
* LINUX
************************************************************************

1) Installation des Securitylayer:
----------------------------------

  Eine Installation ist nicht erforderlich, das Verzeichnis kann einfach
  an den Zielort kopiert werden.

  Einrichten von Gnome/KDE/XDG Menues, TrayIcon und Autostart:

  a) mittels GUI

    ./setup.sh

  b) mittels Kommandozeile

    ./install.sh -i [menu_gn] [menu_kde] [menu_xdg] [auto_gn] [auto_kde]

    [menu_gn] .... Installiere Gnome Menues (XDG konform mit gnome-* Prefix) 
    [menu_kde] ... Installiere KDE Menues (XDG konform mit kde-* Prefix)
    [menu_xdg] ... Installiere XDG Menues (XDG konform)
    [auto_gn] .... Installiere Gnome/XDG Autostart (XDG konform)
    [auto_kde] ... Installiere KDE Autostart (KDE Autostart)

    Beispiel fuer Gnome 2.14: ./install.sh -i menu_gn auto_gn
    Beispiel fuer KDE 3.5: ./install.sh -i menu_kde auto_kde
    Beispiel fuer 100% XDG konformen Desktop: ./install.sh -i menu_xdg auto_gn

  Beachten Sie dabei bitte, dass Sie eine aktuelle Version der Desktops
  Gnome (2.14) und KDE (3.5) installiert haben. Wenn Sie eine aeltere
  oder inkompatible Version verwenden, empfiehlt sich ein variieren der
  Parameter bzw. ein manuelles Einrichten. Die dazu erforderlichen Dateien 
  finden Sie im Unterverzeichnis "conf/kde-data".

2) Starten des Securitylayer:
-----------------------------

  a) automatisch ueber Autostart des Desktops
     Hinweis: Falls der Autostartvorgang fehlschlaegt, empfehlen wir den trustDesk basic
              direkt ueber das Menu zu starten.

  b) Manuell

  ./securitylayer

3) Kommandos ueber Kontextmenue:
--------------------------------

  a) Kontextmenue als standalone executable

    ./cardaccess.Lin/trustDesk

  b) als Gnome-Applet (Tray Icon)

    Im Gnome Panel auf "Zum Panel hinzufuegen" klicken und "trustDesk" 
    auswaehlen. Mit rechter Maustaste das Kontextmenue verwenden.

  c) als Kicker-Applet (Tray Icon)

    Mit rechter Maustaste das Kontextmenue verwenden.

4) Deinstallation des Securitylayer:
------------------------------------

  Entfernen von Gnome/KDE/XDG Menues, TrayIcon und Autostart:

  a) mittels GUI

    ./setup.sh

  b) mittels Kommandozeile

    ./install.sh -r [menu_gn] [menu_kde] [menu_xdg] [auto_gn] [auto_kde]

    Parameter wie 1. b) nur zum Deinstallieren

  Entfernen der Software und der Daten:

  a) mittels GUI

    ./setup.sh

  b) mittels Kommandozeile

    ./install.sh -r [remove_tdb] [remove_all]

    [remove_tdb] ... entfernt die Software
    [remove_all] ... entfernt die Software und die vom Benutzer 
                     gespeicherten Daten (Einstellungen, Infoboxen, etc.)

5) Mindestanforderungen:
------------------------

  X11, Gnome 2.14 oder KDE 3.5, XDG konformes Menuesystem


************************************************************************
* MAC OS X
************************************************************************

1) Installation des Securitylayer:
----------------------------------

  Per Drag&Drop.

2) Starten des Securitylayer:
-----------------------------

3) Kommandos ueber Kontextmenue:
--------------------------------

  trustDesk Icon mit der Maustaste anklicken um das Menue zu erhalten.

4) Deinstallation des Securitylayer:
------------------------------------

  Entfernen des Verzeichnisses. Sollen die Benutzerdaten auch entfernt werden,
  so ist noch das Verzeichnis ".Signaturumgebung" aus dem Homeverzeichnis des
  Benutzers zu entfernen.

5) Mindestanforderungen:
------------------------

  Mac OS X 10.4.7

6) Probleme mit Safari Browser und Javascript:
----------------------------------------------

Falls eine Web-Applikation Javascript zum Submitten einer HTML Form verwendet 
kann es zu Problemen mit dem Safari Browser kommen (Client SSL Zertifikat wird
automatisch und ohne Rückfrage abgelehnt). 

Um diese Probleme zu umgehen muessen Sie vorher das Root Zertifikat des BKU
SSL Zertifikates ("data/root.cer") in Safari als vertrauenswürdiges Zertifikat 
("X509Anchors Schluesselbund") importieren. Damit wird das SSL Zertifikat der 
BKU beim Submitten mittels Javascript automatisch akzeptiert und das Problem 
tritt nicht auf.