Hibiscus Online-Banking mit Jameica

Aus MILLENNIUM ARTS ISP - Hilfe | FAQ
Zur Navigation springen Zur Suche springen

Hibiscus ist eine freie, quelloffene Online-Banking-Software für die Jameica-Plattform, mit der sich Konten, Umsätze, Überweisungen sowie SEPA-Lastschriften verwalten lassen. Da das Programm unter der GPL veröffentlicht wird, ist es dauerhaft kostenfrei, transparent prüfbar und unabhängig von Lizenzmodellen oder Abonnements kommerzieller Anbieter.


Installation unter Windows 11

Hibiscus wird als Plugin innerhalb von Jameica betrieben. Zuerst wird Jameica eingerichtet, danach Hibiscus über die integrierte Pluginverwaltung installiert.

SETUP und EINRICHTUNG

Download

Die aktuelle stabile 64-Bit-Version herunterladen:

Benötigte Datei: 

jameica-win64.zip

Die Windows-Version enthält bereits Java. Eine separate Java-Installation ist normalerweise nicht erforderlich. Es wird auch keine Setup-Datei ausgeführt. Stattdessen muß ein Programmordner angelegt werden, beispielsweise: 

C:\Jameica

Anschließend:

  1. ZIP-Datei vollständig entpacken
  2. Inhalt nach C:\Jameica kopieren
  3. jameica-win64.exe starten


START

Benutzerverzeichnis

Beim ersten Start wird der Ordner für alle persönlichen Daten festgelegt.

Standard: 

C:\Users\BENUTZERNAME\.jameica

Alternativ kann ein gesicherter Datenordner verwendet werden: 

D:\Banking\Jameica

Darin liegen unter anderem:

  • Konten und Umsätze
  • Bankzugänge
  • Zahlungsaufträge
  • Einstellungen
  • automatische Backups

Empfehlung: Programmordner und Benutzerverzeichnis getrennt halten.

Masterpasswort

Beim ersten Start ein eigenes Jameica-Masterpasswort vergeben.

Es sollte:

  • nicht der OnlineBanking-PIN entsprechen
  • ausreichend lang sein
  • sicher aufbewahrt werden

Achtung: Das Masterpasswort kann nicht einfach zurückgesetzt werden.

Hibiscus installieren

In Jameica öffnen: 

 Datei
 → Plugins online suchen

Danach:

  1. Hibiscus auswählen
  2. Installieren anklicken
  3. Installation bestätigen
  4. Jameica vollständig neu starten

Nach dem Neustart erscheint links der neue Bereich: 

Hibiscus

Dort stehen anschließend unter anderem zur Verfügung:

Bereich Funktion
Konten Kontostände und Bankkonten
Umsätze Buchungen und Suchfunktionen
Bank-Zugänge FinTS-, PIN/TAN- und HBCI-Zugänge
Zahlungsverkehr Überweisungen und Lastschriften

Installation prüfen

Die installierte Version wird unter folgendem Punkt angezeigt: 

 Hibiscus
 → Über

Dort sollten Hibiscus-Version, HBCI4Java-Version und Datenbank-Version angezeigt werden. Die Installation ist damit abgeschlossen.


Bankzugang

Nach der Installation wird der Online-Banking-Zugang der jeweiligen Bank in Hibiscus eingerichtet. Die Verbindung erfolgt bei den meisten deutschen Banken über FinTS beziehungsweise HBCI.

Benötigt werden die bereits vorhandenen Zugangsdaten des Online-Bankings, beispielsweise:

  • Bankleitzahl
  • Benutzerkennung oder VR-NetKey
  • Online-Banking-PIN
  • freigeschaltetes TAN-Verfahren
  • gegebenenfalls Kundenkennung

Voraussetzung: Der Online-Banking-Zugang muss bereits bei der Bank freigeschaltet sein und im Web-Banking funktionieren.

Zugang anlegen

In Hibiscus öffnen: 

Bank-Zugänge
→ Neuer Bank-Zugang

Als Zugangsverfahren wird bei normalen Online-Banking-Zugängen ausgewählt: 

PIN/TAN

Dazu gehören auch Freigabeverfahren wie:

  • Push-TAN
  • SecureGo plus
  • photoTAN
  • chipTAN
  • Sm@rt-TAN

Anschließend die Bankleitzahl und die von der Bank vergebene Benutzerkennung eintragen.

Bei Volksbanken und Raiffeisenbanken wird als Benutzerkennung normalerweise der VR-NetKey verwendet. Ein selbst vergebener Alias sollte nur eingesetzt werden, wenn die Bank diesen ausdrücklich für FinTS unterstützt.

Zugangsdaten

Die wichtigsten Felder sind:

Feld Eingabe
Bezeichnung Frei wählbarer Name des Bankzugangs
Bankleitzahl Bankleitzahl des Kreditinstituts
Benutzerkennung Online-Banking-Kennung, beispielsweise VR-NetKey
Kundenkennung Häufig identisch mit der Benutzerkennung
FinTS-Version In der Regel FinTS 3.0
Bankserver Wird normalerweise automatisch ermittelt

Die Bankserver-Adresse sollte nur manuell geändert werden, wenn die Bank eine konkrete FinTS-Adresse vorgibt oder die automatische Erkennung fehlschlägt.

Verbindung prüfen

Nach Eingabe der Zugangsdaten:

  1. Konfiguration testen oder Synchronisieren auswählen
  2. Online-Banking-PIN eingeben
  3. TAN-Verfahren auswählen
  4. Freigabe in der Banking-App oder am TAN-Gerät bestätigen
  5. von der Bank gemeldete Konten übernehmen

Während der ersten Verbindung ruft Hibiscus die unterstützten Bankfunktionen ab. Dazu gehören unter anderem:

  • Kontostandsabfrage
  • Umsatzabruf
  • Überweisungen
  • Sammelüberweisungen
  • SEPA-Lastschriften
  • verfügbare TAN-Verfahren

Welche Funktionen tatsächlich verfügbar sind, bestimmt die Bank. Nicht jedes Kreditinstitut stellt alle Zahlungsarten über FinTS bereit.

Konten übernehmen

Nach erfolgreicher Synchronisierung zeigt Hibiscus die von der Bank gemeldeten Konten an.

Die gewünschten Konten übernehmen und anschließend unter 

Konten

prüfen, ob folgende Angaben korrekt übernommen wurden:

  • Kontoinhaber
  • IBAN
  • BIC
  • Kontonummer
  • Währung
  • zugeordneter Bankzugang

Danach das Konto markieren und einmal vollständig synchronisieren. Kontostand und vorhandene Umsätze sollten anschließend in Hibiscus erscheinen.

TAN-Verfahren

Verwendet eine Bank mehrere TAN-Verfahren, fragt Hibiscus bei der ersten Verbindung nach dem gewünschten Verfahren.

Beispiele: 

SecureGo plus
Push-TAN
chipTAN
Sm@rt-TAN
photoTAN

Das Verfahren auswählen, das auch im normalen Online-Banking verwendet wird. Die Auswahl kann später im jeweiligen Bankzugang geändert werden.

Funktionstest

Nach der Einrichtung sollte zunächst nur ein einfacher Abruf durchgeführt werden:

  1. Kontostand abrufen
  2. Umsätze synchronisieren
  3. eine kleine Testüberweisung ausführen
  4. gegebenenfalls eine Testlastschrift anlegen

Erst wenn diese Funktionen fehlerfrei arbeiten, sollte Hibiscus vollständig für den laufenden Zahlungsverkehr verwendet werden.


Tips

Automatisches Vollbackup

Jameica erstellt zwar eigene interne Sicherungen, diese liegen jedoch gewöhnlich innerhalb des Benutzerverzeichnisses. Wird dieser Ordner beschädigt, gelöscht oder fällt das betreffende Laufwerk aus, können Originaldaten und interne Sicherungen gleichzeitig verloren gehen.

Das folgende PowerShell-Skript:

  • startet Jameica mit dem festgelegten Benutzerverzeichnis,
  • wartet, bis Jameica vollständig beendet wurde,
  • komprimiert danach den gesamten Benutzerordner,
  • prüft das erzeugte ZIP-Archiv,
  • legt für jeden Programmstart eine neue Sicherung mit Datum und Uhrzeit an.

Beispiel: 

hibiscus-backup-2026-07-12_11-44-05.zip

Vorteil: Das Backup enthält nicht nur die Hibiscus-Datenbank, sondern den vollständigen Jameica-Benutzerordner mit Konten, Umsätzen, Bankzugängen, Einstellungen, Zahlungsaufträgen und internen Sicherungen.

Empfehlung: Das Backupziel sollte sich auf einem anderen Laufwerk, NAS oder externen Datenträger befinden. Eine Sicherung auf demselben Laufwerk schützt nicht vor einem Laufwerksausfall.

Beispielstruktur

Für das folgende Skript wird diese Ordnerstruktur verwendet:

Zweck Beispielpfad
Jameica-Programm C:\Jameica
Jameica-Benutzerdaten D:\Banking\Jameica
Backupordner E:\Backups\Hibiscus

Die Datei 

jameica-win64.exe

muss sich damit hier befinden: 

C:\Jameica\jameica-win64.exe

PowerShell-Skript

Den folgenden Inhalt in eine neue Textdatei kopieren: 

$ErrorActionPreference = 'Stop'

$Jameica    = 'C:\Jameica\jameica-win64.exe'
$DatenRoot  = 'D:\Banking'
$UserDaten  = 'D:\Banking\Jameica'
$BackupZiel = 'E:\Backups\Hibiscus'
$Tar        = "$env:SystemRoot\System32\tar.exe"

try {
    if (-not (Test-Path -LiteralPath $Jameica -PathType Leaf)) {
        throw "Jameica wurde nicht gefunden:`n$Jameica"
    }

    if (-not (Test-Path -LiteralPath $UserDaten -PathType Container)) {
        throw "Jameica-Benutzerverzeichnis wurde nicht gefunden:`n$UserDaten"
    }

    if (-not (Test-Path -LiteralPath $Tar -PathType Leaf)) {
        throw "Windows TAR wurde nicht gefunden:`n$Tar"
    }

    New-Item `
        -ItemType Directory `
        -Path $BackupZiel `
        -Force | Out-Null

    Write-Host 'Starte Jameica ...'

    Start-Process `
        -FilePath $Jameica `
        -ArgumentList @('-f', "`"$UserDaten`"") `
        -Wait

    Write-Host ''
    Write-Host 'Jameica wurde beendet. Vollbackup wird erstellt ...'

    $Zeit = Get-Date -Format 'yyyy-MM-dd_HH-mm-ss'

    $Archiv = Join-Path `
        $BackupZiel `
        "hibiscus-backup-$Zeit.zip"

    $TempArchiv = Join-Path `
        $BackupZiel `
        "hibiscus-backup-$Zeit.partial.zip"

    if (Test-Path -LiteralPath $TempArchiv) {
        Remove-Item -LiteralPath $TempArchiv -Force
    }

    Push-Location -LiteralPath $DatenRoot

    try {
        & $Tar -a -c -f $TempArchiv 'Jameica'

        if ($LASTEXITCODE -ne 0) {
            throw "Fehler beim Erstellen des ZIP-Archivs. TAR-Code: $LASTEXITCODE"
        }

        & $Tar -t -f $TempArchiv | Out-Null

        if ($LASTEXITCODE -ne 0) {
            throw "Das ZIP-Archiv konnte nicht geprüft werden. TAR-Code: $LASTEXITCODE"
        }
    }
    finally {
        Pop-Location
    }

    Move-Item `
        -LiteralPath $TempArchiv `
        -Destination $Archiv `
        -Force

    Write-Host ''
    Write-Host 'Backup erfolgreich erstellt:'
    Write-Host $Archiv
    Write-Host ''

    Read-Host 'Enter zum Schließen'
}
catch {
    Write-Host ''
    Write-Host 'FEHLER:' -ForegroundColor Red
    Write-Host $_.Exception.Message -ForegroundColor Red

    if ($TempArchiv -and (Test-Path -LiteralPath $TempArchiv)) {
        Remove-Item `
            -LiteralPath $TempArchiv `
            -Force `
            -ErrorAction SilentlyContinue
    }

    Write-Host ''
    Read-Host 'Enter zum Schließen'
    exit 1
}

Skript speichern

Die Datei beispielsweise hier speichern: 

C:\Jameica\Jameica-mit-Backup.ps1

Im Windows-Editor:

Einstellung Wert
Dateiname Jameica-mit-Backup.ps1
Dateityp Alle Dateien
Codierung UTF-8

Pfade anpassen

Am Anfang des Skripts müssen gegebenenfalls diese vier Werte geändert werden: 

$Jameica    = 'C:\Jameica\jameica-win64.exe'
$DatenRoot  = 'D:\Banking'
$UserDaten  = 'D:\Banking\Jameica'
$BackupZiel = 'E:\Backups\Hibiscus'
Variable Bedeutung
$Jameica Vollständiger Pfad zur Datei jameica-win64.exe
$DatenRoot Übergeordneter Ordner des Jameica-Benutzerordners
$UserDaten Vollständiger Pfad zum Jameica-Benutzerverzeichnis
$BackupZiel Ordner, in dem die datierten ZIP-Sicherungen gespeichert werden

Der letzte Ordnername von $UserDaten muss mit dem im TAR-Befehl verwendeten Ordnernamen übereinstimmen. Im Beispiel lautet dieser Ordner jeweils Jameica.

Bei einer anderen Struktur, beispielsweise: 

D:\Banking\Jameica-Daten

muss auch diese Zeile geändert werden: 

& $Tar -a -c -f $TempArchiv 'Jameica-Daten'

Desktop-Verknüpfung

Die PowerShell-Datei sollte nicht direkt geöffnet werden. Stattdessen wird eine Desktop-Verknüpfung angelegt.

Auf dem Desktop:

  1. Mit der rechten Maustaste klicken.
  2. Neu → Verknüpfung auswählen.
  3. Als Ziel folgenden Befehl eintragen:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Jameica\Jameica-mit-Backup.ps1"

Als Namen beispielsweise eintragen: 

Hibiscus mit Backup

Jameica künftig über diese Verknüpfung starten.

Ablauf

Beim Start über die Verknüpfung geschieht Folgendes: 

Jameica startet
→ Benutzer arbeitet normal
→ Jameica wird geschlossen
→ vollständiger Benutzerordner wird komprimiert
→ ZIP-Datei wird geprüft
→ Sicherung wird im Backupordner gespeichert

Das PowerShell-Fenster darf nach dem Schließen von Jameica nicht sofort geschlossen werden. Erst wenn folgende Meldung erscheint, ist die Sicherung abgeschlossen: 

Backup erfolgreich erstellt:
E:\Backups\Hibiscus\hibiscus-backup-2026-07-12_11-44-05.zip

Wiederherstellung

Zur Wiederherstellung:

  1. Jameica vollständig schließen.
  2. Den vorhandenen Benutzerordner umbenennen oder verschieben.
  3. Das gewünschte ZIP-Archiv entpacken.
  4. Den enthaltenen Ordner wieder an seinem ursprünglichen Speicherort ablegen.
  5. Jameica erneut über die Desktop-Verknüpfung starten.

Nach dem Entpacken muss im Beispiel wieder dieser Ordner vorhanden sein: 

D:\Banking\Jameica

Wichtig: Eine Sicherung sollte nur zurückgespielt werden, während Jameica vollständig beendet ist.

Abgerufen von „https://hilfe.maisp.de/index.php?title=Hibiscus_Online-Banking_mit_Jameica&oldid=965“