LocalSigner FAQ

Häufig gestellt Fragen zum LocalSigner


Funktioniert der LocalSigner mit der SuisseID?

Der LocalSigner unterstützt die SuisseID von SwissSign und QuoVadis.

Probleme beim Signieren mit QuoVadis Signing Service

Wenn Sie beim Signieren unter Verwendung des QuoVadis Signing Service die nachfolgende Fehlermeldung sehen, dann gehen Sie wie folgt vor:

Deaktivieren Sie im Menü Einstellungen -> Konfiguration die Option "LTV Informationen einbetten"Es kann sein, dass die LTV (long-term validation)-Informationen zu gross sind, um sie in der Signatur einzubetten. Durch Ausschalten der Option kann wieder signiert werden.

Ob wirklich die LTV-Information das Problem ist, können Sie verifizieren, indem Sie das Debug-Log aktivieren (siehe weiter unten), den Signaturvorgang wiederholen und dann die Logdatei untersuchen. Sie werden in diesem Fall dort einen Fehler der folgenden Art vorfinden


2020-12-03 10:44:12,600 [ERROR] PdfSigner - Error signing document
java.lang.ArrayIndexOutOfBoundsException: Real contents size 142700 exceeds current max of 65535 bytes.
	at ch.glue.securitytools.pdf.PdfSigner.embedSignature(PdfSigner.java:418)
	at ch.glue.securitytools.pdf.PdfSigner.sign(PdfSigner.java:315)
	at ch.admin.localsigner.gui.SignerGUI.signFile(SignerGUI.java:787)
	at ch.admin.localsigner.gui.SignerGUI.signGUI(SignerGUI.java:680)
	at ch.admin.localsigner.gui.SignerGUI.access$200(SignerGUI.java:107)
	at ch.admin.localsigner.gui.SignerGUI$1.run(SignerGUI.java:506)
	at java.lang.Thread.run(Thread.java:748)


Warum startet LocalSigner unter Mac OS nicht?

Der LocalSigner hat aktuell noch ein bekanntes Problem, falls sich im Namen des Installationspfads ein Leerschlag befindet. Einfacher: die LocalSigner App darf nicht in einem Ordner sein, der einen Leerschlag enthält.

LocalSigner läuft nicht unter Mac OS Snow Leopard (Mac OS X 10.6.x)

LocalSigner unter MacOS mit Linux VM

LocalSigner wird für die neuen Versionen von MacOS nicht mehr unterstützt. Als Umgehungslösung können versierte Benutzerinnen und Benutzer LocalSigner auf MacOS unter VMWare oder VirtualBox in einer Linux (Ubuntu) VM installieren und so betreiben.

Die folgende Instruktionen für VMWare sollten zum Ziel führen (unser Dank dafür geht an Arrigo Triulzi):

  • Uninstall SwissSign SuisseID tools (essential)
  • install Ubuntu 18.04 (not 20.04, unsupported by SwissSign)
  • follow the manual instructions (not the shell script path) to add the SwissSign tools to Ubuntu
  • install pcscd manually and set it to auto-start with systemd
  • install LocalSigner
  • associate the USB card reader for SuisseID permanently to the Ubuntu VM (it is seen as “Advanced Card CCID USB Reader”)
Gatekeeper verhindert den Start von LocalSigner auf Mac OS ab Version 10.14.5

Seit der Version 10.14.5 von Mac OS verhindert der Gatekeeper den Start von LocalSigner. Um dies zu umgehen, kann Gatekeeper kurzfristig ausgeschaltet, LocalSigner gestartet und Gatekeeper wieder aktiviert werden. Danach ist LocalSigner im System freigeschaltet und kann wieder wie gewohnt verwendet werden.

  1. sudo spctl --master-disable (in einem Terminalfenster -> dieser Befehl aktiviert die Option « Von irgendeinem Entwickler » unter « Sicherheit »)
  2. LocalSigner installieren und starten (das « registriert » die Anwendung auf dem Mac)
  3. sudo spctl --master-enable (jetzt kann man die Option wieder deaktivieren, Localsigner kann auch anschliessend ohne Probleme gestartet werden)

Achtung: Sie verantworten mit diesem Eingriff eine temporäre Deaktivierung von einer der vielen Sicherheitsfunktionen des Betriebssystems.

Probleme nach der Migration auf einen anderen Mac-Computer

Bei der Migration auf einen anderen/neuen Mac-Computer reicht es nicht, einfach nur alle Dateien zu kopieren. Die SuisseID-Treiber müssen in jedem Fall neu installiert werden.

Absturz beim Start von LocalSigner unter Linux

Die Themes oxygen-gtk und Breeze der Version 2 von GTK hat Inkompatibilitäten SWT ab Version 4.5. Um dieses Problem zu umgehen, konfigurieren Sie bitte eine andere Theme. Konfigurieren Sie dazu unter System Settings → GTK+ Appearance → GTK+ Styles eine andere Theme als oxygen-gtk oder Breeze.

Absturz von LocalSigner unter Linux

LocalSigner ab Version 4.2.4 setzt ein Amazon Corretto JDK der Version 8 voraus.

Signatur kann unter Debian-Linux nicht angebracht werden

Kann die Signatur unter einem Debian-Linux (unter Umständen auch Debian-Derivat wie Ubuntu) nicht mit der SuisseID von SwissSign angebracht werden, muss das Paket swisssign-pin-entry nachinstalliert werden.

sudo apt-get upgrade && sudo apt install swisssign-pin-entry

Der Fehler tritt auf, nachdem die Signaturparameter wie Zertifikat, Kontaktinformationen, Signaturgrund etc. angegeben bzw. ausgewählt wurden und der PIN für das Qualified-Signature Zertifikat abgefragt werden muss. Das Signieren mit dem Authentisierungszertifikat funktioniert in diesem Fall trotzdem.

Falls die Karte schon von dem SuisseID Assistant nicht erkannt wird, so fehlt eventuell noch eine weitere Komponente, diese kann wie folgt installiert werden:

sudo apt-get upgrade && sudo apt install pcscd
Warum kann LocalSigner ein Dokument nicht öffnen?

LocalSigner kann folgende PDF nicht öffnen

  • Das Dokument hat einen Passwortschutz (Lese- und/oder Schreibschutz)
  • Es handelt sich um ein Formular. Dieses muss mit Adobe Reader ausgefüllt werden
  • Der interne Viewer hat Probleme mit dem Dokument. LocalSigner kann in den Einstellungen auf Adobe Reader als Betrachter umgestellt werden
  • LocalSigner 4.0.2 und 4.1.x kann ein Dokument dann nicht öffnen, wenn ein anderes Programm die Datei noch geöffnet hat. Schliessen Sie das entsprechende Programm und versuchen Sie es noch einmal.
  • Das Dokument ist wirklich fehlerhaft
Beim Start erscheint die Meldung, dass die Konfiguration nicht geschrieben werden kann

LocalSigner schreibt die lokale Konfiguration ins Benutzerverzeichnis (z.B. C:\Dokumente und Einstellungen\muster\.localsigner)
Dieser Pfad kann in den init.properties (z.B. in C:\Programme\Open eGov LocalSigner\configuration) umgestellt werden.

Debug-Log aktivieren

Um Probleme mit LocalSigner zu analysieren, sollten Sie das Debug-Log aktivieren. Gehen Sie bitte wie folgt vor.

Windows
  • Beenden Sie LocalSigner
  • Fügen Sie in der Datei %USERPROFILE%\.localsigner\userconfiguration.properties eine neue Zeile mit dem folgenden Text ein.

    debug=true
  • Starten Sie LocalSigner und führen Sie die Funktion aus, die Probleme macht.
  • Analysieren Sie das Debug-Log in der Datei  %USERPROFILE%\.localsigner\debug.log oder senden Sie die Datei an den LocalSigner Support.
Mac
  • Beenden Sie LocalSigner
  • Wählen Sie im Finder auf dem Mac „Gehe zu“ > „Gehe zum Ordner“
  • Geben Sie darin ~/.localsigner/ ein und klicken auf Öffnen
  • Öffnen Sie die Datei userfconfiguration.properties mit einem Texteditor und fügen 
  • eine neue Zeile mit dem folgenden Text ein.

    debug=true
  • Starten Sie LocalSigner und führen Sie die Funktion aus, die Probleme macht
  • Analysieren Sie das Debug-Log in der Datei ~/.localsigner/debug.log oder senden Sie die Datei an den LocalSigner Support
Probleme mit dem Adobe Reader-Betrachter

Der LocalSigner kann zur Anzeige des PDF Dokuments den Adobe Reader einsetzen. Dies kann jedoch zu Problemen führen.

Welcher Betrachter verwendet und ob dieser z.B. nach dem Signieren automatisch umgeschaltet werden soll, kann im Konfigurationsdialog (Menü Einstellungen → Konfiguration) unter Betrachter konfiguriert werden. Es wird empfohlen bei Problemen ausschliesslich den internen Betrachter zu verwenden.

Mögliche Symptome sind:

  • Ist im Adobe Reader DC der Treiber für das Signieren mit der SuisseID eingerichtet, treten unter Windows Probleme beim Wechsel vom Betrachter mit Adobe Reader zurück zum internen Betrachter auf.
  • Ist kein Adobe Reader installiert oder ein anderes Programm als Standard zum Öffnen von PDF-Dokumenten konfiguriert, ist das Verhalten nicht definiert.
  • Der LocalSigner stürzt mit der Fehlermeldung «SWTException: Widget is disposed» ab.
  • Der LocalSigner stürzt nach dem Signaturvorgang ab, das Dokument wurde jedoch unter Umständen erfolgreich signiert.
In der Anzeige erscheint gross das Wort DEMO über allen PDFs

Bitte aktualisieren Sie den LocalSigner auf die neueste verfügbare Version. Die Anzeige von DEMO bedeutet, dass die Lizenz der Bibliothek zum Darstellen der PDFs abgelaufen ist. Die jeweils aktuellste Version von LocalSigner enthält eine erneuerte Lizenz.