Dokumentation der MCard-Bibliothek 1.18.0.0 der bremen-online ...

Handbuch Governikus - Kartenansteuerung (MCard) Version 1.18.0.0
5 Technische Informationen zur MCard
Die MCard ist eine Funktionsbibliothek in der Programmiersprache Java, die die Verwendung
von Kartenlesern über das OpenCard-Framework (OCF) und den Zugriff auf Signaturkarten
durch einen speziellen JCE/JCA-Kryptoprovider ermöglicht.
Das OCF unterteilt sich in zwei Teile: einerseits die CardTerminal-Klassen, welche die Funktionalität
des Kartenterminals in einer Java-Klasse kapseln, und andererseits die verschiedenen
CardService-Klassen, welche die unterschiedlichen Funktionen einer Chipkarte in
entsprechenden Java-Klassen kapseln. OCF kennt konzeptionell schon Klasse-3-Terminals
und bietet für einen Großteil der Funktionen von Chipkarten bereits vordefinierte Schnittstellen.
Der Provider ermöglicht eine einheitliche Behandlung von Signaturkarten, indem er
Signatur-, Chiffrierungs- und Authentisierungsdienste zur Verfügung stellt. Der vom Provider
bereitgestellte KeyStore enthält alle gefundenen Schlüssel aller erkannten Signaturkarten. Im
Fall spezieller Karten ist es ggf. notwendig, den korrekten Sicherheitszustand herzustellen,
damit der Schlüssel mit seinem Zertifikat durch den Provider im KeyStore bereitgestellt werden
kann.
Zu diesem Zweck wird das OCF, das den Zugriff auf Kartenleser verwaltet und das Absetzen
von Kommandos für Karten und Leser regelt, gekapselt. Die Benutzung des Providers wird
ausführlich im Entwicklerhandbuch beschrieben.
Jede kartenspezifische Implementierung erfolgt in einer von CardService abgeleiteten Klasse.
Die Erkennung erfolgt in einer MCard spezifischen Implementierung der Klasse CardServiceFactory
des OCF. Die Schnittstelle der CardService-Kartenimplementierungen enthält
sowohl Funktionen zur Erkennung und Struktur einer Karte als auch die Funktionen für das
Signieren, Entschlüsseln, Authentisieren, Verifizieren und Ändern einer PIN. Die OCF spezifischen
Fehlermeldungen werden in den JCE/JCA-Provider-Klassen in konforme Fehlermeldungen
umgesetzt.
Der PIN-Dialog wird dem Benutzer angezeigt, wenn eine PIN für einen Schlüssel eingegeben
werden muss. Über die Implementierung des PIN-Dialogs kann die Kommunikation mit
dem Benutzer in unterschiedlicher Weise gestaltet werden. Dies beinhaltet die Beeinflussung
des Aussehens, die Anzeige von Informationen über den verwendeten Schlüssel und Eingabeaufforderungen.
Für Klasse 1-Kartenleser erfolgt über den Dialog auch die Eingabe der
PIN. Bei der PIN-Dialog-Schnittstelle handelt sich um ein Java-Interface, das je nach Anforderung
zum Anzeigen einer sichtbaren Java-Komponente, wie einem JDialog, benutzt werden
kann, aber auch die Steuerung über die Konsole ermöglicht. Der letzte Fall ist insbesondere
für Server interessant, die unter Umständen nur über eine Kommandozeile verfügen.
Die genaue Implementierung ist im OSCI-Client-Enabler-Handbuch beschrieben.
Ein Chipkartenleser ist ein Peripheriegerät. Wie bei jedem anderen Gerät wird seine Funktionalität
dem PC über einen entsprechenden Treiber zur Verfügung gestellt. Hier gibt es viele
unterschiedlich komplexe Treiberkonzepte, die auf unterschiedlichen Standards beruhen.
Die MCard verwendet als Default den international sehr weit verbreiteten plattformunabhängigen
PC/SC-Standard zur Kommunikation mit Chipkartenlesern, die in Form einer C-
basierten Betriebssystemschnittstelle unter Windows, Linux und Mac OS verwendet werden
kann (bei MacOS mit Einschränkungen). Die meisten für die qualifizierte elektronische Signatur
in Deutschland zugelassenen Chipkartenlesegeräte verwenden PC/SC, nur einige we-
27