doc: Document setup of netkey cards
authorAndre Heinecke <aheinecke@intevation.de>
Tue, 3 Apr 2018 10:29:07 +0000 (12:29 +0200)
committerAndre Heinecke <aheinecke@intevation.de>
Tue, 3 Apr 2018 10:30:18 +0000 (12:30 +0200)
--

configure.ac
doc/manual/Makefile.am
doc/manual/gpg4win-compendium-de.tex
doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_1_de.png [new file with mode: 0644]
doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_2_de.png [new file with mode: 0644]
doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_3_de.png [new file with mode: 0644]
doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_4_de.png [new file with mode: 0644]

index fe602cb..328b2d2 100644 (file)
@@ -52,9 +52,9 @@ MANUALVERSION_NOVICES="1.0.0"
 MANUALDATE_NOVICES="Nov. 30, 2006"
 MANUALVERSION_ADVANCED="0.0.0"
 MANUALDATE_ADVANCED="Nov. 30, 2006"
-COMPENDIUM_VERSION_DE="4.0.0"
-COMPENDIUM_DATE_DE="23. Juni 2017"
-COMPENDIUMINPROGRESS_DE="zuletzt geringfügig korrigiert am 10. Januar 2018"
+COMPENDIUM_VERSION_DE="4.0.1"
+COMPENDIUM_DATE_DE="3. April 2019"
+COMPENDIUMINPROGRESS_DE=""
 COMPENDIUM_VERSION_EN="3.0.0"
 COMPENDIUM_DATE_EN="30th November 2016"
 COMPENDIUMINPROGRESS_EN="last minor changes from 30th November 2016"
index 02b1e66..48da087 100644 (file)
@@ -182,7 +182,12 @@ png_compendium_files = \
        images-compendium/sc-kleopatra-smartCard1_de.png \
        images-compendium/sc-kleopatra-smartCard2_de.png \
        images-compendium/sc-kleopatra-smartCard3_de.png \
-       images-compendium/sc-kleopatra-smartCard4_de.png
+       images-compendium/sc-kleopatra-smartCard4_de.png \
+       images-compendium/sc-kleopatra-smartCard_netkey_1_de.png \
+       images-compendium/sc-kleopatra-smartCard_netkey_2_de.png \
+       images-compendium/sc-kleopatra-smartCard_netkey_3_de.png \
+       images-compendium/sc-kleopatra-smartCard_netkey_4_de.png
+
 
 png_manual_files = \
        images-manual/adele01.png \
index 5e6c20c..04f4b4b 100644 (file)
@@ -3355,14 +3355,48 @@ einzugeben.
 
 %TODO: Option gibt es noch nicht
 %\subsection{Kopieren eines vorhandenen Schlüssels auf die SmartCard}
+\clearpage
 
 \section{Nutzung von NetKey-Cards mit X.509}
 \label{X509Smartcard}
-Ebenso wie OpenPGP-SmartCards können auch X.509 NetKey-Cards verwendet werden.
-Hierbei müssen Sie allerdings keine eigenen Einstellungen übernehmen, Sie wird
-von der Zertifizierungsstelle vorkonfiguriert und kann danach in Kleopatra
-genutzt werden.
+X.509 Smartcards kommen im Unterschied zu OpenPGP Karten üblicherweise
+mit vorkonfigurierten Zertifikaten, welche von der Zertifizierungstelle
+eingerichtet wurden. Kleopatra unterstützt die NetKey Karten
+der Telekom.
+
+Bei der ersten Verwendung einer X.509 Smartcard muss eine PIN für
+die jeweiligen Zertifikate gesetzt werden. Zudem müssen die Zertifikate
+der Karte im Gpg4win-System registriert werden damit diese für Kryptographie-
+Aktionen zur Auswahl stehen.
+
+Legt man eine, unbekannte, unterstützte X.509 Smartcard in einen Kartenleser ein
+blinkt das Systemtray Icon von Kleopatra. Nach einem Linksklick öffnet sich der
+Einrichtungsdialog um eine anfängliche PIN zu setzen:
+
+\IncludeImage[width=0.8\textwidth]{sc-kleopatra-smartCard_netkey_1_de}
+
+Dabei ist ein Spezialfall bei NetKey Karten das diese zwei Zertifikate
+unterstützen. Ein gewöhnliches und ein weiteres für qualifizierte Signaturen.\footnote{
+ \url{https://de.wikipedia.org/wiki/Signaturgesetz_(Deutschland)}}
+
+Nachdem die anfänglichen PINs eingerichtet sind können die Zertifikate registriert
+werden. Dazu kann man erneut auf das blinkende Symbol klicken. Es folgen
+einige Diagnoseausgaben. Diese können ignoriert werden. Anschließend sind die
+Zertifikate im System registriert.
+
+Alternativ zum Tray Icon können beide Aktionen auch über die SmartCard-Verwaltung
+angestoßen werden. Das Menü erreichen Sie über \Menu{Extras $\to$ SmartCards verwalten}.
+
+Ansicht einer nicht initialisierten NetKey Karte:
+\IncludeImage[width=0.7\textwidth]{sc-kleopatra-smartCard_netkey_2_de}
+
+Mit ``Zertifikate neu Laden" werden die Zertifikate der SmartCard registriert:
+\IncludeImage[width=0.7\textwidth]{sc-kleopatra-smartCard_netkey_4_de}
+
+Ist alles eingerichtet werden die auf der Karte vorhandenen Zertifikate in
+der SmartCard-Verwaltung angezeigt.
 
+\IncludeImage[width=0.7\textwidth]{sc-kleopatra-smartCard_netkey_3_de}
 
 \clearpage
 \chapter{Systemweite Konfiguration und Vorbelegung für
diff --git a/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_1_de.png b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_1_de.png
new file mode 100644 (file)
index 0000000..20a3406
Binary files /dev/null and b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_1_de.png differ
diff --git a/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_2_de.png b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_2_de.png
new file mode 100644 (file)
index 0000000..f25b7b7
Binary files /dev/null and b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_2_de.png differ
diff --git a/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_3_de.png b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_3_de.png
new file mode 100644 (file)
index 0000000..24014e3
Binary files /dev/null and b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_3_de.png differ
diff --git a/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_4_de.png b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_4_de.png
new file mode 100644 (file)
index 0000000..9dbd506
Binary files /dev/null and b/doc/manual/images-compendium/sc-kleopatra-smartCard_netkey_4_de.png differ