|
 | eIDClientCore |  |
- BeID-lab: Eine gemeinsame Initiative der Bundesdruckerei und der Humboldt-Universität Berlin -
|
Lizenz
- Präambel
Die Humboldt-Universität zu Berlin, Unter den Linden 6, 10099 Berlin, im Folgenden als Humboldt-Universität bezeichnet, stellt für die Anwendung im Zusammenhang mit deutschen hoheitlichen Dokumenten, wie beispielsweise den neuen Personalausweis und den elektronischen Aufenthaltstitel, eine clientseitige eID-Basis-Software zum Bereitstellen der sogenannten eID-Funktionalität, d. h. Ermöglichen eines elektronischen Identitätsnachweises, die sich an den Richtlinien des BSI TR-03110, TR-03112, TR-03130 orientiert, bereit, und zwar in dem Entwicklungszustand, in dem sie sich zum Zeitpunkt der Bereitstellung befindet. Diese Software, die im Folgenden als eIDClientCore bezeichnet wird, hat die Humboldt-Universität von der Bundesdruckerei GmbH, Oranienstraße 91, 10969 Berlin zur Verwendung in Lehre und Forschung sowie zur Bereitstellung an die Öffentlichkeit („Hosten“) für die allgemeine Prüfung und Verwendung durch jedermann erhalten.
- Details
- Lizenz [COPYING]
Architektur
- Aufbau
Wie kann die Software gebaut werden?
Die hier beschriebene Anleitung wurde auf einem aktuellen Linux-System [OpenSuSE (12.2) i568] getestet, und sollte auf andere aktuelle Distributionen übertragbar sein.
- Abhängigkeiten
Folgende Pakete werden zusätzlich, zu üblicher Weise auf Unix-Systemen installierten, gebraucht:
gettext-tools # Tools for Native Language Support (NLS)
libcryptopp-devel # Cryptographic Library for C++
libexpat-devel # XML Parser Toolkit
libgcrypt-devel # The GNU Crypto Library
pcsc-lite-devel # Development package for the MUSCLE project SmartCards library
asn1c # The asn1c is an open source, free ASN.1 to C compiler
Das Paket asn1c ist nicht in den Standardquellen von OpenSuSE enthalten, kann aber als RPM im Netz gefunden werden oder aber selbst aus den Quellen https://github.com/vlm/asn1c kompiliert werden. Bitte beachten Sie die Hinweise im Abschnitt Troubleshooting.
- Vorbereitung
Installieren Sie die benötigten Zusatzpakete über die Paketverwaltung. Also beispielsweise:
zypper install gettext-tools libcryptopp-devel libexpat-devel libgcrypt-devel pcsc-lite-devel
zypper install ftp://ftp.pbone.net/mirror/ftp5.gwdg.de/pub/opensuse/repositories/home:/schiele/SLE_10/i586/asn1c-0.9.21-5.2.i586.rpm
- Lokale Kopie des Repositories
Erzeugen Sie eine Kopie der gewünschten Version der Quellen auf Ihrem System. Initial wird dazu clone verwendet:
git clone https://github.com/BeID-lab/eIDClientCore
Kompilieren der Quellen cd eIDClientCore/
autoreconf -i
./configure
make
Troubleshooting
Gegebenenfalls müssen noch weitere Pakete, Bibliotheken und Werkzeuge nachinstalliert werden, wenn diese auf dem Builtsystem nicht vorrätig sind. Insbesondere die auto-tools, gcc, g++, wget werden benötigt.
Wegen unterschiedlicher Versionen des asn1c kann es ggf. erforderlich werden, manuell eine andere Belegung für die Variable BUILT_SOURCES in der Konfigurationsdatei für automake: lib/eidasn1/Makefile.am zu wählen. Dies wird einfach durch das Verschieben der zwei enthaltenen Kommentarzeichen auf die andere Belegung erreicht.
Testen
Wenn die Quellen erfolgreich kompiliert sind und Sie als Entwickler/Forscher in Besitz eines geeigneten Testausweises der Bundesdruckerei GmbH sind , kann ein eID-Durchlauf mit folgendem Aufruf initiiert werden (vorausgesetzt, ein geeigneter Smatcardleser ist angeschlossen und der pcscd ist gestartet): bin/Test_nPAClientLib/Test_nPAClientLib
Repository
Bemerkungen & Perspektive
- Dieses OpenSource-Projekt befindet sich in fortlaufender Entwicklung. Die Software ist nicht für den Produktiveinsatz gedacht und wird sich ggf. in Struktur und Aufbau verändern. Insbesondere beabsichtigen wir mittelfristig eine Umstrukturierung, um eine Reduktion der Zahl der verwendeten Cryptobibliotheken zu erreichen.
- Nächste Schritte: [README.md]
Kontakt
Dr. Wolf Müller