====== Installationsanleitung PC/SC-CTAPI Wrapper für Fedora Linux ======

  * Dies ist Anleitung schildert die vom Autor ausgeführten Schritte einer Installation auf einem Fedora 15 (x86-64) in deutscher Sprache
  * Während der Installation wird sudo verwendet, da dieses unter Fedora 15 für Benutzer mit "Systemverwalter"-Rechten gut funktioniert.
  * Als Kartenleser wird der interne Kartenleser eines Lenovo Notebooks verwendet (Lenovo R61, USB-ID des Kartenlesers 17ef:1003). Ebenso wurde ein Cherry ST-2000U Kartenleser erfolgreich getestet (USB-ID 046a:003e).

===== pcsc-lite installieren =====

Im Paketmanager die folgenden Pakete installieren:
  * pcsc-lite
  * pcsc-lite-ccid
  * pcsc-lite-devel (*)
  * gcc (*)
  * make (*)
Die mit (*) gekennzeichneten Programme werden nur zum compilieren von pcsc-ctapi-wrapper gebraucht und können am Ende der Installation wieder gelöscht werden.


===== pcsc-ctapi-wrapper compilieren =====

Von [[http://sourceforge.net/projects/pcsc-ctapi/files/pcsc-ctapi/0.3/pcsc-ctapi-wrapper-0.3.tar.gz/download]] den pcsc-ctapi-wrapper Quellcode herunterladen und entpacken. Als Ordner zum Entpacken kann "Persönlicher Ordner" gewählt werden.

Als nächstes muss der Quelltext compiliert werden. Dazu unter Programme => Systemwerkzeuge => Terminal ein Befehlsfenster öffnen. Mit
<code bash>
cd ~\pcsc-ctapi-wrapper-0.3
</code>
in den eben entpackten Ordner wechseln, und mit
<code bash>
make
</code>
compilieren. Dabei entsteht die Datei libpcsc-ctapi-wrapper.so.0.3

Diese Datei in den Ordner /usr/lib kopieren:
<code bash>
sudo mv libpcsc-ctapi-wrapper.so.0.3 /usr/lib
</code>

Und den pcscd Dienst aktivieren und starten
<code bash>
sudo chkconfig pcscd on
sudo /etc/init.d/pcscd restart
</code>


Jetzt kann der Quelltext Ordner wieder gelöscht werden. Dies kann grafisch geschehen, oder im Befehlsfenster mit:
<code bash>
cd ~
rm -r ~/pcsc-ctapi-wrapper-0.3
</code>


===== Hibiscus installieren =====

Der Anleitung auf [[http://www.willuhn.de/products/hibiscus/download.php]] folgen und Jameica+Hibiscus installieren. Als Ordner zum Entpacken kann "Persönlicher Ordner" gewählt werden. Hibiscus muss dann in den Ordner Jameica/Plugins entpackt werden.

Aus Sicherheitsgründen kann das Programm in einen für den normalen Nutzer schreibgeschützten Ordner verschoben werden. Dadurch wird es anderen schädlichen Programmen (Viren, Trojaner ...) erschwert die Hibiscus Installation zu verändern. Die Funktionalität der Software wird dabei nicht eingeschränkt.

Dazu wieder unter Programme => Systemwerkzeuge => Terminal ein Befehlsfenster öffnen.
<code bash>
sudo chown root:root ~/jameica
sudo mv ~/jameica /opt/
</code>
(Sollte Jameica in einen anderen Ordner entpackt worden sein, so muss "~/jameica" in den Befehlen angepasst werden)

Um Jameica in Fedora zu integrieren und über das Programm oder Aktivitäten Menü auswählbar zu machen, muss noch eine Datei erstellt werden. Dazu den folgenden Text in einem einfachen Editor wie gedit kopieren:
<code ini>
#!/usr/bin/env xdg-open

[Desktop Entry]
Version=1.0
Type=Application
Terminal=false
Exec=/opt/jameica/jameica.sh
Name=Hibiscus
Categories=Office
Comment=Onlinebanking (HBCI)
Icon=/opt/jameica/hibiscus-icon-64x64.png
</code>

Diese Datei für für den aktuellen Benutzer unter folgendem Namen speichern (Die ganze Zeile als Dateiname angeben!)
<code>
~/.local/share/applications/jameica.desktop
</code>
Sollen alle Benutzer dieses Rechners Hibiscus im Programm Menü finden, so muss die Datei in einen Systemordner kopiert werden. Im Terminal kann die eben gespeicherte Datei verschoben werden:
<code bash>
sudo mv ~/.local/share/applications/jameica.desktop /usr/share/applications/jameica.desktop
</code>


===== Hibiscus einrichten =====

Konfiguriere den Kartenleser in Hibiscus nun wie folgt:

  * neuen Bank-Zugang anlegen
  * Typ Chipkarte (DDV)
  * Kartenleser manuell anlegen

^ Name                       ^ Wert                           ^
| Kartenleser                | Benutzerdefiniert |
| CTAPI Treiber              | /usr/lib/libpcsc-ctapi-wrapper.so.0.3 |
| Port des Lesers            | COM/USB (ggf. auch COM2/USB2) |
| Index des Lesers           | 0 |
| Index des HBCI Zugangs     | meist 1 |
| HBCI Version               | FinTS 3.0 |
| Tastatur des PCs verwenden | ja |