<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kleopatra "<application
>Kleopatra</application
>">
  <!ENTITY kwatchgnupg "<application
>KWatchGnuPG</application
>">
  <!ENTITY gpgsm "<application
>GpgSM</application
>">
  <!ENTITY gpg "<application
>GPG</application
>">
  <!ENTITY gpgconf "<application
>GpgConf</application
>">
  <!ENTITY kappname "&kleopatra;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">

  <!ENTITY dn "<acronym
>DN</acronym
>">
  <!ENTITY ca "<acronym
>CA</acronym
>">

  <!-- FILE menu -->
  <!ENTITY file-new-key-pair "<menuchoice
><guimenu
>File</guimenu
><guimenuitem
>New Key Pair...</guimenuitem
></menuchoice
>">
  <!ENTITY file-export-certificates "<menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Export Certificates...</guimenuitem
></menuchoice
>">
  <!ENTITY file-export-secret-key "<menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Export Secret key...</guimenuitem
></menuchoice
>">
  <!ENTITY file-import-certificates "<menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Import Certificates...</guimenuitem
></menuchoice
>">
  <!ENTITY file-import-crls "<menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Import CRLs...</guimenuitem
></menuchoice
>">
  <!ENTITY file-quit "<menuchoice
><shortcut
><keycombo action='simul'
>&Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
><guimenu
>File</guimenu
><guimenuitem
>Quit</guimenuitem
></menuchoice
>">

  <!-- VIEW menu -->
  <!ENTITY view-redisplay "<menuchoice
><shortcut
><keycombo action='simul'
><keycap
>F5</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu
><guimenuitem
>Redisplay</guimenuitem
></menuchoice
>">
  <!ENTITY view-stop-operation "<menuchoice
><shortcut
><keycombo action='simul'
><keycap
>Esc</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu
><guimenuitem
>Stop Operation</guimenuitem
></menuchoice
>">
  <!ENTITY view-certificate-details "<menuchoice
><guimenu
>View</guimenu
><guimenuitem
>Certificate Details...</guimenuitem
></menuchoice
>">
  <!ENTITY view-hierarchical-key-list "<menuchoice
><guimenu
>View</guimenu
><guimenuitem
>Hierarchical Key List</guimenuitem
></menuchoice
>">
  <!ENTITY view-expand-all "<menuchoice
><shortcut
><keycombo action='simul'
>&Ctrl;<keycap
>.</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu
><guimenuitem
>Expand All</guimenuitem
></menuchoice
>">
  <!ENTITY view-collapse-all "<menuchoice
><shortcut
><keycombo action='simul'
>&Ctrl;<keycap
>,</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu
><guimenuitem
>Collapse All</guimenuitem
></menuchoice
>">

  <!-- CERTIFICATES menu -->
 <!ENTITY certificates-validate "<menuchoice
><shortcut
><keycombo action='simul'
>&Shift;<keycap
>F5</keycap
></keycombo
></shortcut
><guimenu
>Certificates</guimenu
><guimenuitem
>Validate</guimenuitem
></menuchoice
>">
  <!ENTITY certificates-refresh-crls "<menuchoice
><guimenu
>Certificates</guimenu
><guimenuitem
>Refresh CRLs</guimenuitem
></menuchoice
>">
  <!ENTITY certificates-delete "<menuchoice
><shortcut
><keycombo action='simul'
><keycap
>Delete</keycap
></keycombo
></shortcut
><guimenu
>Certificates</guimenu
><guimenuitem
>Delete</guimenuitem
></menuchoice
>">
  <!ENTITY certificates-download "<menuchoice
><guimenu
>Certificates</guimenu
><guimenuitem
>Download</guimenuitem
></menuchoice
>">

  <!-- CRLS menu -->
  <!ENTITY crls-clear-crl-cache "<menuchoice
><guimenu
>CRLs</guimenu
><guimenuitem
>Clear CRL Cache...</guimenuitem
></menuchoice
>">
  <!ENTITY crls-dump-crl-cache "<menuchoice
><guimenu
>CRLs</guimenu
><guimenuitem
>Dump CRL Cache...</guimenuitem
></menuchoice
>">

  <!-- TOOLS menu -->
  <!ENTITY tools-gnupg-log-viewer "<menuchoice
><guimenu
>Tools</guimenu
><guimenuitem
>GnuPG Log Viewer...</guimenuitem
></menuchoice
>">

  <!-- SETTINGS menu -->
  <!ENTITY settings-show-statusbar "<menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Show Statusbar</guimenuitem
></menuchoice
>">
  <!ENTITY settings-configure-shortcuts "<menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
>">
  <!ENTITY settings-configure-kleopatra "<menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure &kleopatra;...</guimenuitem
></menuchoice
>">
  <!ENTITY settings-configure-gpgme-backend "<menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure GpgME Backend...</guimenuitem
></menuchoice
>">

  <!-- Command line options -->
  <!ENTITY commandline-option-external "<option
>--external</option
>">
  <!ENTITY commandline-option-query "<option
>--query</option
>">
  <!ENTITY commandline-option-import-certificate "<option
>--import-certificate</option
>">
]>

<book lang="&language;">

<bookinfo>
<title
>Das &kleopatra;-Handbuch</title>

<authorgroup>
<author
><firstname
>Marc</firstname
> <surname
>Mutz</surname
> <affiliation
> <address
><email
>marc@klaralvdalens-datakonsult.se</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Faure</surname
> <contrib
>Entwickler</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Steffen</firstname
> <othername
></othername
> <surname
>Hansen</surname
> <affiliation
> <address
><email
>steffen@klaralvdalens-datakonsult.se</email
></address>
</affiliation>
<contrib
>Entwickler</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias Kalle</firstname
> <surname
>Dalheimer</surname
> <contrib
>Entwickler</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Jesper</firstname
> <surname
>Pedersen</surname
> <affiliation
> <address
><email
>blackie@kde.org</email
></address>
</affiliation>
<contrib
>Entwickler</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Daniel</firstname
> <surname
>Molkentin</surname
> <affiliation
> <address
><email
>molkentin@kde.org</email
></address>
</affiliation>
<contrib
>Entwickler</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Matthias Kalle</firstname
><surname
>Dalheimer</surname
><affiliation
><address
><email
>kalle@kdab.net</email
></address
></affiliation
> <contrib
>Deutsche Übersetzung</contrib
></othercredit
>  
</authorgroup>

<legalnotice
>&GPLNotice;</legalnotice>

<date
>2004-06-11</date>
<releaseinfo
>0.31</releaseinfo>

<abstract>
<para
>&kleopatra; ist ein Hilfsprogramm zum Verwalten von X.509-Zertifikaten. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>Kapp</keyword>
<keyword
>X509</keyword>
<keyword
>LDAP</keyword>
<keyword
>gpg</keyword>
<keyword
>gpgsm</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> <title
>Einführung</title
> 

<para
>&kleopatra; ist das &kde;-Programm zum Verwalten von X.509-Zertifikaten im &gpgsm;-Schlüsselspeicher, und zum Abfragen von Zertifikaten von <acronym
>LDAP</acronym
>-Servern.</para>

<para
>&kleopatra; kann sowohl aus dem <guimenu
>Werkzeuge</guimenu
>-Menü von KMail als auch von der Kommandozeile aus gestartet werden. Das ausführbare Programm von &kleopatra; heißt <userinput
><command
>kleopatra</command
></userinput
>.</para>

<note
><para
>Dieses Programm ist nach Kleopatra benannt, einer berühmten ägyptischen Pharaonin, die zur Zeit Julius Cäsars gelebt hat, mit dem sie eine intime Beziehung unterhalten haben soll.</para>

<para
>Der Name wurde gewählt, weil dieses Programm aus den <ulink url="http://www.gnupg.org/aegypten2/"
>&Auml;gypten-Projekten</ulink
> stammt.</para
></note>

</chapter>

<chapter id="functions"
><title
>Die wichtigsten Funktionen</title>

<sect1 id="functions-view"
><title
>Anzeige des lokalen Schlüsselspeichers</title>

<!-- Viewing and Refreshing, also Validation -->

<para
>Die wichtigste Funktion von &kleopatra; ist das Anzeigen und Editieren des Inhalts des lokalen Schlüsselspeichers, der dem Schlüsselring-Konzept von &gpg; ähnelt, auch wenn man diesen Vergleich nicht zu sehr bemühen sollte.</para>

<para
>Das Hauptfenster ist in den großen Schlüsselbereich, die Menüleiste und die <link linkend="functions-search"
>Suchleiste</link
> am oberen Rand, sowie die Statuszeile am unteren Rand aufgeteilt.</para>

<para
>Jede Zeile in der Schlüsselliste entspricht einem Zertifikat, das durch den sogenannten <guilabel
>Subjekt-&dn;</guilabel
> identifiziert wird. &dn; ist ein Akronym für den englischen Ausdruck <quote
>Distinguished Name</quote
>, ein hierarchischer Bezeichner, der einem Dateisystempfad mit merkwürdiger Syntax ähnelt und ein bestimmtes Zertifikat eindeutig global identifizieren soll.</para>

<para
>Um gültig und damit verwendbar zu sein, müssen (öffentliche) Schlüssel von einer &ca; (Certification Authority; Zertifizierungsinstanz) signiert sein. Diese Signaturen werden Zertifikate genannt, aber normalerweise werden die Ausdrücke <quote
>Zertifikat</quote
> und <quote
>(öffentlicher) Schlüssel</quote
> austauschbar verwendet, sofern das nicht ausdrücklich anders angegeben ist. Der Name der &ca;, die das Zertifikat ausgestellt hat (dessen &dn;) wird in der Spalte <guilabel
>Aussteller-DN</guilabel
> angezeigt.</para>

<para
>&ca;s müssen ebenfalls wiederum von anderen &ca;s signiert sein, um gültig zu sein. Natürlich muss diese Kette irgendwo enden, weswegen die oberste &ca; (die Wurzel-&ca;) ihren Schlüssel mit sich selbst signiert (dies wird eine Selbst-Signatur genannt). Wurzel-Zertifikaten muss daher die Gültigkeit (meistens Vertrauenswürdigkeit genannt) manuell zugewiesen werden, z.B. durch Vergleichen des Fingerabdrucks mit dem auf der Website der &ca;. Dies wird normalerweise vom Systemverwalter oder dem Hersteller des Produkts, das Zertifikate verwendet, vorgenommen, kann aber über die Kommandozeilenschnittstelle von &gpgsm; auch vom Benutzer durchgeführt werden.</para>

<para
>Um zu sehen, welche Zertifikate Wurzel-Zertifikate sind, können Sie entweder <guilabel
>Subjekt-&dn;</guilabel
> und <guilabel
>Aussteller-&dn;</guilabel
> vergleichen oder aber mit <xref linkend="view-hierarchical-key-list"/> in den hierarchischen Anzeigemodus wechseln.</para>

<para
>Sie können sich die Details eines beliebigen Zertifikats durch Doppelklick auf das Zertifikat oder durch Verwendung von <xref linkend="view-certificate-details"/> ansehen. Dabei wird ein Dialog geöffnet, in dem die gängigsten Eigenschaften des Zertifikats, dessen Zertifikatskette (d.h. die Kette der Aussteller bis zur Wurzel-&ca;) und alle Informationen, die das Backend über das Zertifikat ermitteln kann, angezeigt werden.</para>

<para
>Wenn Sie den Inhalt des Schlüsselspeichers außerhalb von &kleopatra; verändern (etwa über die Kommandozeilenschnittstelle von &gpgsm;), dann können Sie die Anzeige mit <xref linkend="view-redisplay"/> aktualisieren.</para>

<para
>Weil das Überprüfen der Schlüssel einige Zeit dauern kann (z.B. müssen möglicherweise erst CRLs heruntergeladen werden), versucht die normale Schlüsselanzeige nicht, die Gültigkeit der Schlüssel zu überprüfen. Dazu dient <xref linkend="certificates-validate"/>, eine spezielle Variante von <xref linkend="view-redisplay"/>. Damit werden entweder nur die ausgewählten Zertifikate oder, sofern keine ausgewählt sind, alle Schlüssel überprüft.</para>

</sect1>

<sect1 id="functions-search"
><title
>Zertifikate suchen und importieren</title>

<para
>Normalerweise bekommen Sie neue Zertifikate durch Überprüfen von Signaturen in E-Mail-Nachrichten, weil die Zertifikate normalerweise in die Signaturen, die damit vorgenommen wurden, eingebettet werden. Wenn Sie aber jemandem eine Nachricht senden wollen, mit dem Sie bisher noch keinen Kontakt hatten, dann müssen Sie das Zertifikat aus einem LDAP-Verzeichnis (&gpgsm; kann das aber auch automatisch für Sie tun) oder einer Datei holen. Außerdem müssen Sie Ihr eigenes Zertifikat importieren, nachdem Sie die Antwort der &ca; auf Ihre Zertifizierungsanfrage bekommen haben.</para>

<para
>Um ein Zertifikat in einem LDAP-Verzeichnis zu suchen, schalten Sie das Ausklappmenü in der Suchleiste von <guilabel
>in lokalen Zertifikaten</guilabel
> auf <guilabel
>in externen Zertifikaten</guilabel
> um, geben einen Text (etwa den Namen der Person, für die Sie das Zertifikat herunterladen wollen) in das Eingabefeld ein, und klicken auf das <guilabel
>Suche</guilabel
>-Symbol. Die Ergebnisse werden in der Schlüsselliste unterhalb der Suchleiste angezeigt, wo Sie Zertifikate entweder zur Ansicht mit <xref linkend="view-certificate-details"/> oder zum Herunterladen in den lokalen Schlüsselspeicher mit <xref linkend="certificates-download"/> auswählen können. Beachten Sie, dass Sie das Zertifikat auch aus dem Details-Dialog mit der Schaltfläche <guilabel
>Lokal importieren</guilabel
> herunterladen können.</para>

<para
>Sie können die Liste der zu durchsuchenden LDAP-Server auf der Seite <link linkend="configuration-directory-services"
><guilabel
>Verzeichnisdienste</guilabel
></link
> des <link linkend="configuration"
>Konfigurationsdialogs</link
> von &kleopatra; konfigurieren.</para>

<para
>Wenn Sie die Zertifikate als eine Datei bekommen haben, versuchen Sie es mit <xref linkend="file-import-certificates"/>. &gpgsm; muss dazu das Format der Zertifikatsdatei unterstützen; im &gpgsm;-Handbuch finden Sie eine Liste der unterstützten Dateiformate.</para>

<para
>Wenn Sie Ihr <link linkend="functions-newkey"
>Schlüsselpaar nicht mit &gpgsm; erzeugt</link
> haben, müssen Sie auch den öffentlichen und den geheimen Schlüssel aus der PKCS#12-Datei importieren, die Sie von der &ca; bekommen haben. Dies können Sie von der Kommandozeile aus mit <link linkend="commandline-option-import-certificate"
><userinput
><command
>kleopatra &commandline-option-import-certificate; <filename
>dateiname</filename
></command
></userinput
></link
> oder in &kleopatra; mit <xref linkend="file-import-certificates"/> durchführen, genauso, wie Sie es auch für <quote
>normale</quote
> Zertifikate tun würden.</para>

</sect1>

<sect1 id="functions-newkey"
><title
>Neue Schlüsselpaare erzeugen</title>

<para
>Der Menüeintrag <xref linkend="file-new-key-pair"/> startet den Assistenten zum Erzeugen von Zertifikatsanfragen, der Sie durch die notwendigen Schritte zur Erzeugung einer Zertifikatsanfrage führt; diese Anfrage kann auf der letzten Seite des Assistenten entweder an eine Zertifizierungsinstanz (CA) zur Unterzeichnung geschickt oder in einer Datei gespeichert werden (etwa auf einer Diskette, die dann an die CA geschickt wird).</para
> <para
>Wenn Sie mit dem Ausfüllen einer Seite im Assistenten fertig sind, klicken Sie auf <guibutton
>Vor</guibutton
>, um zum nächsten Schritt zu kommen (mit <guibutton
>Zurück</guibutton
> können Sie bereits durchgeführte Schritte noch einmal anschauen). Die Erzeugung der Zertifikatsanfrage kann jederzeit mit der Schaltfläche <guibutton
>Abbrechen</guibutton
> abgebrochen werden. </para>
<para
>Der erste Schritt im Assistenten besteht darin, Ihre persönlichen Daten für das Zertifikat einzufüllen. Die auszufüllenden Felder lauten: <itemizedlist>
<listitem>
<para
><guilabel
>Name:</guilabel
> Ihr Name;</para>
</listitem>
<listitem>
<para
><guilabel
>Ort:</guilabel
> Die Stadt oder der Ort, wo Sie leben;</para>
</listitem>
<listitem>
<para
><guilabel
>Organisation:</guilabel
>Die Organisation, die Sie repräsentieren (etwa Ihr Arbeitgeber);</para>
</listitem>
<listitem>
<para
><guilabel
>Abteilung:</guilabel
>Die Organisationseinheit, zu der Sie gehören (etwa "Logistik");</para
> 
</listitem>
<listitem>
<para
><guilabel
>Länder-Code:</guilabel
>Der zweibuchstabige Code, der das Land bezeichnet, in dem Sie leben (z.B. "DE");</para>
</listitem>
<listitem>
<para
><guilabel
>E-Mail-Adresse:</guilabel
>Ihre E-Mail-Adresse; geben Sie diese sorgfältig ein, denn an diese Adresse werden Nachrichten verschickt, wenn Ihr Zertifikat verwendet wird.</para>
</listitem>
</itemizedlist>
</para
><para
>Im nächsten Schritt des Assistenten wählen Sie aus, ob das Zertifikat in einer Datei gespeichert oder direkt an eine CA geschickt werden soll. Sie müssen entweder den Dateinamen oder die E-Mail-Adresse, an die die Zertifikatsanfrage geschickt werden soll, angeben. </para
></sect1>


<sect1 id="functions-keybox-management"
><title
>Verwaltung des Schlüsselspeichers</title>

<para
>Neben dem <link linkend="functions-view"
>Anzeigen und Validieren</link
>, <link linkend="functions-search"
>Suchen und Importieren</link
> und <link linkend="functions-newkey"
>Erzeugen</link
> von Zertifikaten, enthält &kleopatra; auch eine Reihe seltener verwendeter Funktionen, die Ihnen bei der Verwaltung Ihres lokalen Schlüsselspeichers helfen.</para>

<para
>Zu diesen Funktionen gehören das Löschen von Zertifikaten aus dem lokalen Schlüsselspeicher mit <xref linkend="certificates-delete"/>, sowie das Umgehen mit CRLs (<xref linkend="certificates-refresh-crls"/>, <xref linkend="crls-clear-crl-cache"/>, <xref linkend="crls-dump-crl-cache"/>).</para>

</sect1>

</chapter>

<chapter id="menu"
><title
>Menüreferenz</title>

<sect1 id="menufile"
><title
>Das Datei-Menü</title>

<variablelist>

<varlistentry id="file-new-key-pair">
<term
>&file-new-key-pair;</term>

<listitem>
<para
><action
>Erzeugt ein neues Schlüsselpaar (aus öffentlichem und privatem Schlüssel)</action
> und ermöglicht das Verschicken des öffentlichen Teils an eine Zertifizierungsinstanz (<acronym
>CA</acronym
>) zur Signierung. Das resultierende Zertifikat wird an Sie zurückgeschickt oder in einem LDAP-Server gespeichert, von wo Sie es in Ihren lokalen Schlüsselspeicher herunterladen können, wo es zum Signieren und Entschlüsseln von Nachrichten dient.</para>

<para
>Dieser Betriebsmodus wird <quote
>dezentrale Schlüsselerzeugung</quote
> genannt, weil alle Schlüssel lokal erzeugt werden. &kleopatra; (und &gpgsm;) unterstützt die <quote
>zentrale Schlüsselerzeugung</quote
> nicht direkt, aber Sie können das Bündel aus öffentlichem und geheimen Schlüssel, das Sie von der CA im PKCS#12-Format bekommen, mittels &file-import-certificates; importieren.</para>
</listitem>
</varlistentry>


<varlistentry id="file-export-certificates">
<term
>&file-export-certificates;</term>

<listitem>
<para
><action
>Exportiert die ausgewählten Zertifikate</action
> in eine Datei.</para>

<note
><para
>Diese Funktion exportiert nur die öffenltichen Schlüssel; auch wenn geheime Schlüssel verfügbar sind. Mit &file-export-secret-key; können Sie sowohl die öffentlichen als auch die geheimen Schlüssel in eine Datei exportieren; beachten Sie aber, dass das fast nie eine gute Idee ist.</para
></note>
</listitem>
</varlistentry>


<varlistentry id="file-export-secret-key">
<term
>&file-export-secret-key;</term>

<listitem>
<para
><action
>Exportiert sowohl den öffentlichen als auch den geheimen Schlüssel in eine (PKCS#12) Datei.</action
></para>

<warning
><para
>Diese Funktion benötigt man nur sehr selten, und wenn das doch einmal der Fall sein sollte, dann sollte dies sorgfältig geplant werden. Zur Planung der Migration eines geheimen Schlüssels gehört neben vielen anderen Dingen die Wahl des Transportmediums und das sichere Löschen der Schlüsseldaten auf dem alten Rechner sowie dem Transportmedium.</para
></warning>
</listitem>
</varlistentry>


<varlistentry id="file-import-certificates">
<term
>&file-import-certificates;</term>

<listitem>
<para
><action
>Importiert Zertifikate und/oder geheime Schlüssel aus Dateien in den lokalen Schlüsselspeicher.</action
></para>

<para
>Das Format der Zertifikatsdatei muss von &gpgsm; unterstützt werden. Im Handbuch von &gpgsm; finden Sie eine Liste der unterstützten Formate.</para>
</listitem>
</varlistentry>


<varlistentry id="file-import-crls">
<term
>&file-import-crls;</term>

<listitem>
<para
><action
>Importiert CRLs manuell aus Dateien.</action
></para>

<para
>Normalerweise werden Zertifikatswiderrufslisten (Certificate Revocation Lists, CRLs) vom Backend transparent verarbeitet, aber manchmal kann es trotzdem nützlich sein, eine CRL manuell in den lokalen CRL-Cache zu importieren.</para>

<note
><para
>Damit der Import von CRLs funktionieren kann, muss das Hilfsprogramm <application
>dirmngr</application
> im Suchpfad <varname
>PATH</varname
> enthalten sein. Wenn dieser Menüeintrag inaktiv ist, dann sollten Sie mit Ihrem Systemverwalter Kontakt aufnehmen und um die Installation von <application
>dirmgnr</application
> bitten.</para
></note>

<para
>Sie können sich den Inhalt des lokalen CRL-Caches über den Menüeintrag &crls-dump-crl-cache; ansehen. Dieser zeigt einen Dialog mit Informationen über die CRLs im Cache und den Fingerabdrücken der Zertifikate in jeder CRL an. </para>
</listitem>
</varlistentry>


<varlistentry id="file-quit">
<term
>&file-quit;</term>

<listitem>
<para
><action
>Beendet &kleopatra;.</action
></para>
</listitem>
</varlistentry>

</variablelist>

</sect1
> <!-- File Menu -->



<sect1 id="menuview"
><title
>Das Ansicht-Menü</title>

<variablelist>

<varlistentry id="view-redisplay">
<term
>&view-redisplay;</term>

<listitem>
<para
><action
>Zeigt die ausgewählten Zertifikate erneut an oder aktualisiert die Zertifikatsliste.</action
></para>

<para
>Wenn Zertifikate ausgewählt sind, beschränkt sich die Aktualisierungsoperation auf die ausgewählten Einträge.</para>

<para
>Wenn gerade ein (entferntes oder lokales) Abfrageergebnis angezeigt wird, wird die Abfrage erneut ausgeführt und die neuen Ergebnisse anstelle der alten angezeigt.</para>

<para
>Wenn keine Abfrage ausgewührt wurde, wird der gesamte Inhalt des Schlüsselspeichers neu eingelesen und angezeigt.</para>

<para
>Sie können diese Funktion verwenden, wenn Sie den Inhalt des Schlüsselspeichers auf andere Weise als mit &kleopatra; verändert haben (etwa mit der Kommandozeilenschnittstelle von &gpgsm;)</para>
</listitem>
</varlistentry>


<varlistentry id="view-stop-operation">
<term
>&view-stop-operation;</term>

<listitem>
<para
><action
>Bricht alle schwebenden Operationen ab,</action
> etwa eine Suche oder ein Herunterladen.</para>

<note
><para
>Je nach verwendetem Server kann das Abbrechen einer entfernten Suche &kleopatra; einige Sekunden blockieren, während das Backend den Vorgang abbricht. Dies ist völlig normal.</para
></note>
</listitem>
</varlistentry>


<varlistentry id="view-certificate-details">
<term
>&view-certificate-details;</term>

<listitem>
<para
><action
>Zeigt die Details des derzeit ausgewählten Zertifikats an.</action
></para>

<para
>Diese Funktion kann auch direkt durch Doppelklicken des entsprechenden Eintrags in der Zertifikatsliste aufgerufen werden.</para>

<!--FIXME: link to the dialog's help, but where do we put _that_?-->
</listitem>
</varlistentry>


<varlistentry id="view-hierarchical-key-list">
<term
>&view-hierarchical-key-list;</term>

<listitem>
<para
><action
>Schaltet zwischen der hierarchischen und der flachen Anzeige der Schlüsselliste um. </action
></para>

<para
>Im hierarchischen Modus werden die Zertifikate nach Aussteller und Subjekt angeordnet, so dass man einfach sehen kann, zu welcher Zertifikationshierarchie ein bestimmtes Zertifikat gehört; ein bestimmtes Zertifikat kann aber anfangs schwerer zu finden sein (zum Suchen können Sie aber natürlich die <link linkend="functions-search"
>Suchleiste</link
> verwenden).</para>

<para
>In der flachen Ansicht werden alle Zertifikate alphabetisch sortiert in einer flachen Liste angezeigt. In diesem Modus kann man ein bestimmtes Zertifikat leicht finden, aber es ist nicht direkt ersichtlich zu welchem Wurzel-Zertifikat es gehört.</para>
</listitem>
</varlistentry>


<varlistentry id="view-expand-all">
<term
>&view-expand-all;</term>

<listitem>
<para
>(Diese Funktion steht nur zur Verfügung, wenn <xref linkend="view-hierarchical-key-list"/> angewählt ist.)</para>

<para
><action
>Klappt alle Listeneinträge in der Zertifikatsliste auf,</action
> macht also die untergeordneten Einträge sichtbar.</para>

<para
>Dies ist die Standardeinstellung, wenn in die hierarchische Ansicht umgeschaltet wird.</para>

<para
>Natürlich können Sie auch weiterhin jeden Eintrag einzeln ein- und ausklappen.</para>
</listitem>
</varlistentry>



<varlistentry id="view-collapse-all">
<term
>&view-collapse-all;</term>

<listitem>
<para
>(Diese Funktion steht nur zur Verfügung, wenn <xref linkend="view-hierarchical-key-list"/> angewählt ist.)</para>

<para
><action
>Klappt alle Listeneinträge in der Zertifikatsliste ein,</action
> macht also alle Einträge außer denen auf der obersten Ebene unsichtbar.</para>

<para
>Natürlich können Sie auch weiterhin jeden Eintrag einzeln ein- und ausklappen.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menucertificates"
><title
>Das Zertifikate-Menü</title>

<variablelist>

<varlistentry id="certificates-validate">
<term
>&certificates-validate;</term>

<listitem>
<para
><action
>Validiert die ausgewählten (oder alle) Schlüssel.</action
></para>

<para
>Ähnelt <xref linkend="view-redisplay"/>, prüft aber gleichzeitig die (ausgewählten) Schlüssel auf Gültigkeit. Das bedeutet, dass alle relevanten CRLs eingeladen werden und die Zertifikatskette auf Korrektheit überprüft wird. Ungültige oder abgelaufene Schlüssel werden entsprechend der von Ihnen auf der <link linkend="configuration-appearance"
><guilabel
>Visuelle Einstellungen</guilabel
>-Seite</link
> des <link linkend="configuration"
>Konfigurationsdialogs</link
> von &kleopatra; vorgenommenen Farb- und Zeichensatzeinstellungen dargestellt.</para>

<warning
><para
>Sie können sich nur auf die Informationen von validierten Schlüsseln verlassen, aber selbst eine Validierung ist immer nur eine Momentaufnahme des aktuellen Zustands des lokalen Schlüsselspeichers, weil die Schlüssel jederzeit widerrufen werden können. Daher führt das Backend solche Überprüfungen normalerweise immer dann durch, wenn die Schlüssel verwendet werden (z.B. zum Signieren, zum Überprüfen von Signaturen, zum Ver- oder Entschlüsseln).</para
></warning>
</listitem>
</varlistentry>



<varlistentry id="certificates-refresh-crls">
<term
>&certificates-refresh-crls;</term>

<listitem>
<para
><action
>Holt die aktuellen CRLs aller ausgewählten Schlüssel,</action
> auch wenn diese bei Verwendung der Schlüssel normalerweise nicht geholt werden würden.</para>

<para
>Diese Funktion wirkt nur auf Zertifikate, die einen CRL-Verteilungspunkt definieren. Je nach verwendetem Backend werden Zertifikate, die für die Überprüfung mittels OCSP konfiguriert worden sind, nicht aktualisiert.</para>

<para
>Sie können diese Funktion etwa dann verwenden, wenn Sie erfahren haben, dass ein Schlüssel zurückgezogen worden ist, und Sie dieses Wissen im Backend <emphasis
>jetzt</emphasis
> verwenden wollen, anstatt auf die nächste planmäßige CRL-Aktualisierung zu warten.</para>

<warning
><para
>Die exzessive Verwendung dieser Funktion kann das Netzwerk Ihres Providers oder Ihrer Firma hoher Datenlast aussetzen, weil CRLs großer Organisationen überraschend groß werden können (mehrere Megabytes sind nicht ungewöhnlich).</para>

<para
>Verwenden Sie diese Funktion sparsam.</para
></warning>
</listitem>
</varlistentry>



<varlistentry id="certificates-delete">
<term
>&certificates-delete;</term>

<listitem>
<para
>Löscht die ausgewählten Zertifikate aus dem lokalen Schlüsselspeicher.</para>

<para
>Verwenden Sie diese Funktion, um unbenutzte Schlüssel aus Ihrem lokalen Schlüsselspeicher zu etnfernen. Weil Zertifikate aber normalerweise an signierte E-Mail-Nachrichten angehängt sind, kann das Überprüfen einer Nachricht dazu führen, dass ein Schlüssel, den Sie gerade entfernt haben, wieder im lokalen Schlüsselspeicher auftaucht. Daher sollte man dies Funktion weitgehend vermeiden. Wenn Sie sich in den Zertifikaten nicht mehr zurechtfinden, verwenden Sie die <link linkend="functions-search"
>Suchleiste</link
> oder die <xref linkend="view-hierarchical-key-list"/>-Funktion, um wieder klar zu sehen.</para>
</listitem>
</varlistentry>



<varlistentry id="certificates-download">
<term
>&certificates-download;</term>

<listitem>
<para
><action
>Lädt die ausgewählten Zertifikate vom LDAP-Server in den lokalen Schlüsselspeicher herunter.</action
></para>
</listitem>
</varlistentry>

</variablelist>

</sect1>



<sect1 id="menucrls"
><title
>Das CRLs-Menü</title>

<variablelist>

<varlistentry id="crls-clear-crl-cache">
<term
>&crls-clear-crl-cache;</term>

<listitem>
<para
><action
>Leert den CRL-Cache von &gpgsm;.</action
></para>

<para
>Diese Funktion benötigen Sie wahrscheinlich nie. Sie können das Aktualisieren des CRL-Caches erzwingen, indem Sie alle Zertifikate auswählen und <xref linkend="certificates-refresh-crls"/> aufrufen.</para>
</listitem>
</varlistentry>

<varlistentry id="crls-dump-crl-cache">
<term
>&crls-dump-crl-cache;</term>

<listitem>
<para
><action
>Zeigt den genauen Inhalt des CRL-Caches von &gpgsm; an.</action
></para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menutools"
><title
>Das Werkzeuge-Menü</title>

<variablelist>

<varlistentry id="tools-gnupg-log-viewer">
<term
>&tools-gnupg-log-viewer;</term>

<listitem>
<para
><action
>Startet <ulink url="help:/kwatchgnupg/index.html"
>&kwatchgnupg;</ulink
></action
></para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menusettings"
><title
>Das Einstellungen-Menü</title>

<variablelist>

<varlistentry id="settings-show-statusbar">
<term
>&settings-show-statusbar;</term>

<listitem>
<para
><action
>Schaltet die Statuszeile am unteren Rand ein und aus.</action
></para>
</listitem>
</varlistentry>

<varlistentry id="settings-configure-shortcuts">
<term
>&settings-configure-shortcuts;</term>

<listitem>
<para
><action
>Öffnet den Standard-&kde;-Konfigurationsdialog für Tastaturkürzel, indem Sie allen Menüeinträgen Tastaturkürzel zuweisen und diese auch wieder löschen können.</action
></para>
</listitem>
</varlistentry>

<varlistentry id="settings-configure-kleopatra">
<term
>&settings-configure-kleopatra;</term>

<listitem>
<para
><action
>Öffnet den Konfigurationsdialog von &kleopatra;.</action
></para>

<para
>Näheres finden Sie in <xref linkend="configuration"/>.</para>
</listitem>
</varlistentry>

<varlistentry id="settings-configure-gpgme-backend">
<term
>&settings-configure-gpgme-backend;</term>

<listitem>
<para
><action
>Öffnet einen Dialog, in dem Sie sämtliche Einstellungen von &gpgsm; und anderen Backend-Modulen einstellen können.</action
></para>

<para
>Dieser Dialog wird dynamisch aus der Ausgabe des Hilfsprogramms &gpgconf; aufgebaut und kann sich daher ändern, wenn sich die Backend-Module ändern.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menuhelp"
><title
>Das Hilfe-Menü</title>


<para
>Das <guimenu
>Hilfe</guimenu
>-Menü enthält das Standard-&kde;-Hilfemenü.</para>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="commandline-options"
><title
>Referenz der Kommandozeilenoptionen</title>

<para
>Hier werden nur die &kleopatra;-spezifischen Optionen aufgez&auml;hlt. Wie bei allen &kde;-Applikationen können Sie durch Aufrufen von <userinput
><command
>kleopatra <option
>--help</option
></command
></userinput
> eine vollständige Liste aller Optionen bekommen.</para>

<variablelist>

<varlistentry id="commandline-option-external">
<term
>&commandline-option-external;</term>

<listitem>
<para
><action
>Legt fest, dass &commandline-option-query; entfernt anstatt im lokalen Schlüsselspeicher suchen soll.</action
></para>
</listitem>
</varlistentry>

<varlistentry id="commandline-option-query">
<term
>&commandline-option-query;</term>

<listitem>
<para
><action
>Legt fest, dass &kleopatra; mit dem angegebenen Abfragetext starten soll, anstatt den gesamten lokalen Schlüsselspeicher anzuzeigen.</action
></para>
</listitem>
</varlistentry>

<varlistentry id="commandline-option-import-certificate">
<term
>&commandline-option-import-certificate;</term>

<listitem>
<para
><action
>Gibt eine Datei oder URL an, aus der Zertifikate (oder geheime Schlüssel) importiert werden sollen.</action
></para>

<para
>Dies ist das Kommandozeilen-Gegenstück zu <xref linkend="file-import-certificates"/>.</para>
</listitem>
</varlistentry>

</variablelist>

</chapter>

<chapter id="configuration"
><title
>&kleopatra; konfigurieren</title>

<para
>Sie erreichen den Konfigurationsdialog von &kleopatra; über <xref linkend="settings-configure-kleopatra"/>.</para>

<para
>Sämtliche Seiten dieses Dialogs werden in den folgenden Abschnitten beschrieben.</para>

<sect1 id="configuration-directory-services"
><title
>Verzeichnisdienste konfigurieren</title>

<para
>Auf dieser Seite können Sie konfigurieren, in welchen LDAP-Servern nach Zertifikaten gesucht weden soll. Außerdem können Sie die Suchreihenfolge festlegen, sowie einige ausgewählte LDAP-Einstellungen vornehmen, die aus dem über <xref linkend="settings-configure-gpgme-backend"/> verfügbaren dynamischen Konfigurationsdialog des Backends stammen.</para>

<para
>Um einen neuen Server hinzuzuf&uuml;gen, klicken Sie auf die Schaltfläche <guilabel
>Dienst hinzufügen ...</guilabel
>. Im dann erscheinenden Dialog können Sie den <guilabel
>Servername</guilabel
>n, den <guilabel
>Port</guilabel
> (voreingestellt ist der Default-LDAP-Port), den <guilabel
>Basis-DN</guilabel
> (manchmal auch als Suchwurzel oder Suchbasis bezeichnet), den <guilabel
>Benutzername</guilabel
>n und das <guilabel
>Passwort</guilabel
> einstellen; die letzteren beiden werden nur benötigt, wenn der Server Authentifizierung verlangt. Sobald Sie auf <guilabel
>OK</guilabel
> klicken, werden die Angaben zum Server zur Liste der Server hinzugefügt; mit <guilabel
>Abbrechen</guilabel
> kann die Eingabe verworfen werden.</para>

<para
>Um einen Server aus der Suchliste zu entfernen, wählen Sie ihn in der Liste aus und betätigen dann die Schaltfläche <guilabel
>Dienst entfernen</guilabel
>.</para>

<para
>Um die relative Suchreihenfolge der Server zu ändern, wählen Sie einen davon aus und verschieben ihn mit den Pfeil-Schaltfl&auml;chen rechts neben der Liste.</para>

<para
>Mit dem Eingabefeld <guilabel
>LDAP-Timeout</guilabel
> können Sie den LDAP-Timeout einstellen, also die maximale Zeit, die das Backend auf die Antwort eines Servers warten soll.</para>

<para
>Wenn einer Ihrer Server eine so große Datenbank enthält, dass selbst sinnvolle Suchanfragen wie <userinput
>Schmidt</userinput
> die <guilabel
>Maximale Anzahl zurückgegebener Treffer</guilabel
> überschreiten, dann können Sie diese Begrenzung heraufsetzen. Sie können leicht feststellen, wenn das der Fall ist, weil ein Dialog erscheinen wird, der Ihnen mitteilt, dass die Suchergebnisse verkürzt worden sind.</para>

<note
><para
>Einige Server haben eigene Beschränkungen, wieviele Einträge sie in einer Abfrage zurückgeben. In diesem Fall führt das Heraufsetzen der Begrenzung in diesem Dialog natürlich zu keiner Änderung.</para
></note>

</sect1>

<sect1 id="configuration-appearance"
><title
>Visuelle Einstellungen konfigurieren</title>

<para
>Sie können in &kleopatra; die Darstellung (überprüfter) Schlüssel in der Schlüsselliste konfigurieren. Dazu gehören die Vordergrund- (Text-) und Hintergrundfarbe sowie der Zeichensatz.</para>

<para
>Jeder <guilabel
>Schlüsselkategorie</guilabel
> auf der linken Seite ist ein Satz von Farben und ein Zeichensatz zugeordnet, in denen die Schlüssel, die zu dieser Kategorie gehören, dargestellt werden. Die Kategorieliste dient auch als Vorschau für die Einstellungen. Der Systemverwalter oder erfahrene Benutzer können die Kategorien frei definieren; siehe dazu <xref linkend="admin-key-filters"/> in <xref linkend="admin"/>.</para>

<para
>Um die Text- (Vordergrund-) Farbe einer Kategorie zu ändern, wählen Sie die Kategorie in der Liste aus und klicken auf <guilabel
>Textfarbe einstellen..</guilabel
>. Der Standard-Farbdialog von &kde; erscheint, indem Sie eine Farbe auswählen oder eine neue erstellen können.</para>

<para
>Die Hintergrundfarbe wird auf die gleiche Weise geändert, verwenden Sie hier die Schaltfläche <guilabel
>Hintergrundfarbe einstellen ...</guilabel
>.</para>

<para
>Sie haben zwei Möglichkeiten, den Zeichensatz einzustellen:</para>

<orderedlist>
<listitem
><para
>Verändern Sie den Standard-Zeichensatz, der für alle Listenanzeigen in &kde; verwendet wird.</para
></listitem>
<listitem
><para
>Verwenden Sie einen benutzerdefinierten Zeichensatz.</para
></listitem>
</orderedlist>

<para
>Die erste Option hat den Vorteil, dass der Zeichensatz Ihren &kde;-weiten Stileinstellungen folgen wird, während Sie bei der letzteren Möglichkeit die volle Kontrolle über den zu verwendenden Zeichensatz haben. Die Wahl liegt bei Ihnen.</para>

<para
>Um den Standard-Zeichensatz zu verändern, wählen Sie die Kategorie in der Liste und ändern Sie die Modifikatoren <guilabel
>Kursiv</guilabel
>, <guilabel
>Fett</guilabel
> und/oder <guilabel
>Durchgestrichen</guilabel
>. Sie können den Effekt auf den Zeichensatz in der Kategorienliste unmittelbar sehen.</para>

<para
>Um einen benutzerdefinierten Zeichensatz einzustellen, klicken Sie auf die Schaltfläche <guilabel
>Zeichensatz einstellen ...</guilabel
>. Der Standard-Zeichensatzdialog von &kde; erscheint, in dem Sie den neuen Zeichensatz einstellen können. Beachten Sie, dass Sie die Modifikatoren weiterhin verwenden können; genau wie beim Standard-Zeichensatz.</para>

<para
>Um auf den Standard-Zeichensatz zurückzuschalten, verwenden Sie die Schaltfläche <guilabel
>Default-Aussehen</guilabel
>.</para>

</sect1>

<sect1 id="configuration-dn-order"
><title
>Die Anzeigereihenfolge der DN-Attribute konfigurieren</title>

<para
>&dn;s sind zwar hierarchisch, aber die Reihenfolge der einzelnen Komponenten (auch relative &dn;s (RDNs) oder &dn;-Attribute genannt) ist nicht definiert. Die Reihenfolge, in der die Attribute angezeigt werden, ist daher eine Frage des persönlichen Geschmacks oder von Firmenvorgaben, weswegen Sie diese Reihenfolge in &kleopatra; konfigurieren können.</para>

<note
><para
>Diese Einstellung gilt nicht nur für &kleopatra;, sondern für alle Applikationen, die &kleopatra;-Technologie verwenden. Dazu gehören derzeit KMail, KAddressBook und natürlich &kleopatra; selbst.</para
></note>

<para
>Diese Konfigurationsseite besteht im wesentlichen aus zwei Listen, eine für die bekannten Attribute (<guilabel
>Verfügbare Attribute</guilabel
>) und eine, die die <guilabel
>Aktuelle Attributreihenfolge</guilabel
> beschreibt.</para>

<para
>Beide Listen enthalten Einträge, die sowohl durch die Kurzform des Attributs (z. B. <guilabel
>CN</guilabel
>) als auch durch die ausgeschriebene Form (<guilabel
>Allgemeiner Name</guilabel
>) beschrieben werden.</para>

<para
>Die Liste der verfügbaren Attribute ist immer alphabetisch sortiert, während die Reihenfolge der Liste der aktuellen Attributreihenfolge die konfigurierte Reihenfolge der &dn;-Attribute wiederspiegelt; das erste Attribut in dieser Liste wird auch als erstes angezeigt.</para>

<para
>Nur Attribute, die explizit in der Liste der aktuellen Attributreihenfolge aufgeführt sind, werden überhaupt angezeigt. Der Rest ist defaultmäßig unsichtbar.</para>

<para
>Wenn aber der Platzhalter <guilabel
>_X_</guilabel
> (<guilabel
>Alle anderen</guilabel
>) in der <quote
>aktuellen</quote
> Liste steht, dann werden alle nicht aufgeführten Attribute (ob bekannt oder nicht) an der Position des <guilabel
>_X_</guilabel
> in ihrer ursprünglichen relativen Reihenfolge eingefügt.</para>

<para
>Ein kleines Beispiel soll dies deutlicher machen:</para>

<informalexample>
<para
>Im &dn;</para>
<blockquote
> <para
> O=KDE, C=US, CN=Dave Devel, X-BAR=foo, OU=Kleopatra, X-FOO=bar, </para
> </blockquote
> <para
>ergibt die Default-Attributreihenfolge von <quote
>CN, L, _X_, OU, O, C</quote
> den folgenden formatierten &dn;:</para
> <blockquote
> <para
> CN=Dave Devel, X-BAR=foo, X-FOO=bar, OU=Kleopatra, O=KDE, C=US </para
> </blockquote
> <para
>während <quote
>CN, L, OU, O, C</quote
> folgende Ausgabe ergibt:</para
> <blockquote
> <para
> CN=Dave Devel, OU=Kleopatra, O=KDE, C=US </para
> </blockquote
> </informalexample>

<para
>Um ein Attribut zur Anzeigeliste hinzuzufügen, wählen Sie es in der Liste der verfügbaren Attribute aus und klicken auf die Schaltfläche <guilabel
>Zur aktuellen Attributreihenfolge hinzufügen</guilabel
>.</para>

<para
>Um ein Attribut aus der Anzeigeliste zu entfernen, wählen Sie es in dieser aus und klicken auf die Schaltfläche <guilabel
>Von der aktuellen Attributreihenfolge entfernen</guilabel
>.</para>

<para
>Um ein Attribut an den Anfang oder das Ende zu verschieben, wählen Sie es in der Anzeigeliste aus und klicken auf eine der Schaltflächen <guilabel
>Nach ganz oben</guilabel
> oder <guilabel
>Nach ganz unten</guilabel
>.</para>

<para
>Um ein Attribut um eine Position nach oben oder unten zu verschieben, wählen Sie es in der Anzeigeliste aus und klicken auf eine der Schaltflächen <guilabel
>Nach oben</guilabel
> oder <guilabel
>Nach unten</guilabel
>.</para>

</sect1>

</chapter>

<chapter id="admin"
><title
>Handbuch für den Systemverwalter</title>

<para
>Dieses Handbuch für den Systemverwalter beschreibt Möglichkeiten, &kleopatra; zu konfigurieren, die nicht über die grafische Benutzerschnittstelle, sondern nur über Konfigurationsdateien erreichbar sind.</para>

<para
>Wir gehen hier davon aus, dass der Leser mit der Technologie zum Konfigurieren von &kde;-Applikationen vertraut ist. Dazu gehören das Format, die Lage im Dateisystem und das Kaskadieren von Konfigurationsdateien, sowie das KIOSK-System.</para>

<sect1 id="admin-certificate-request-wizard"
><title
>Anpassung des Assistenten zum Erzeugen von Zertifikaten</title>

<para
>Sie können in &kleopatra; die Felder anpassen, die der Benutzer ausfüllen muss, um ein Zertifikat zu erzeugen.</para>

<para
>Legen Sie eine Gruppe namens <literal
>CertificateCreationWizard</literal
> in der systemweiten <filename
>kleopatrarc</filename
>-Datei an. Wenn Sie die Reihenfolge der Attribute verändern wollen, oder nur bestimmte Elemente anzeigen wollen, dann definieren Sie einen Schlüssel namens <varname
>DNAttributeOrder</varname
>. Das Argument besteht aus einem oder mehreren der Elementen <varname
>CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL</varname
>. Wenn Sie Felder mit einem bestimmten Wert initialisieren wollen, dann schreiben Sie Attribut=Wert. Wenn das Attribut obligatorisch sein soll, dann stellen Sie ihm ein Ausrufungszeichen voran (wie in <varname
>CN!,L,OU,O!,C!,EMAIL!</varname
>, der Default-Konfiguration).</para>

<para
>Mit dem <acronym
>KIOSK</acronym
>-Modus-Modifikator <varname
>$e</varname
> können Sie Werte aus Umgebungsvariablen oder einem ausgewerteten Skript oder Binärprogramm verwenden. Wenn Sie außerdem noch das Editieren des entsprechenden Feldes verhindern wollen, verwenden Sie den Modifikator <varname
>$i</varname
>. Wenn Sie die Benutzung der Schaltfläche <guibutton
>Meine Adresse einfügen</guibutton
> verbieten wollen, dann setzen Sie <varname
>ShowSetWhoAmI</varname
> auf false.</para>

<tip
><para
>Aufgrund der Funktionsweise des <acronym
>KIOSK</acronym
>-Systems von &kde;, ist es für den Benutzer unmöglich, den Schalter <varname
>$i</varname
> zu überschreiben. Das ist das beabsichtigte Verhalten. <varname
>$i</varname
> und <varname
>$e</varname
> können auch bei allen anderen Konfigurationsschlüsseln in &kde;-Applikationen verwendet werden.</para
></tip>

<para
>Das folgende Beispiel zeigt mögliche Anpassungen:</para>

<para>
<programlisting
>[CertificateCreationWizard] 
;Persönliche Daten dürfen nicht aus dem Adressbuch kopiert werden;
;lokales Überschreiben ist verboten
ShowSetWhoAmI[$i]=false

;Benutzername mit $USER vordefinieren
CN[$e]=$USER

;Firmenname mit "Meine Firma" vordefinieren; editieren verbieten
O[$i]=Meine Firma

;Den Abteilungsnamen mit dem Rückgabewert eines Skripts vordefinieren
OU[$ei]=$(lookup_dept_from_ip)

; das Land mit DE vordefinieren, aber Änderungen durch den Benutzer zulassen
C=DE
</programlisting>

</para>
</sect1>

    <sect1 id="admin-key-filters">

      <title
>Schlüsselkategorien erzeugen und editieren </title>

      <para
>Sie können in &kleopatra; das <link linkend="configuration-appearance"
>Aussehen</link
> von Schlüsseln auf der Basis eines Konzepts namens <guilabel
>Schlüsselkategorien</guilabel
> verändern. In diesem Abschnitt beschreiben wir, wie Sie die verfügbaren Kategorien editieren und neue hinzufügen können. </para>

      <para
>Um herauszufinden, zu welcher Kategorie ein Schlüssel gehört, versucht &kleopatra;, den Schlüssel mit einer Folge von Schlüsselfiltern abzugleichen, die in der Datei <filename
>libkleopatrarc</filename
> konfiguriert sind. Der erste passende Filter definiert die Kategorie. </para>

      <para
>Jeder Schlüsselfilter ist in einer Konfigurationsgruppe namens <literal
>Key Filter #<replaceable
>n</replaceable
></literal
> definiert, wobei <replaceable
>n</replaceable
> eine Zahl ist, beginnend bei <literal
>0</literal
>. </para>

      <para
>Der einzige obligatorische Schlüssel in einer solchen <literal
>Key Filter #<replaceable
>n</replaceable
></literal
>-Gruppe ist <varname
>Name</varname
>, der den Namen der Kategorie enthält, wie er im <link linkend="configuration-appearance"
>Konfigurationsdialog</link
> angezeigt wird. </para>

      <para
><xref linkend="table-key-filters-appearance"/> führt alle Schlüssel auf, die die Anzeigeeigenschaften von Schlüsseln dieser Kategorie definieren (d.h. die Schlüssel, die im <link linkend="configuration-appearance"
>Konfigurationsdialog</link
> editiert werden können), wohingegen <xref linkend="table-key-filters-criteria"/> alle Schlüssel auflistet, die die Kriterien definieren, anhand denen Filter mit Schlüsseln verglichen werden. </para>

      <table id="table-key-filters-appearance">
	<title
>Schlüsselfilter-Konfigurationsschlüssel, die Anzeigeeigenschaften definieren</title>
	<tgroup cols="3">
	  <colspec colnum="2" align="center"/>
	  <thead>
	    <row>
	      <entry
>Konfigurationsschlüssel</entry>
	      <entry
>Typ</entry>
	      <entry
>Beschreibung</entry>
	    </row>
	  </thead>
	  <!--tfoot/-->
	  <tbody>
	    <row>
	      <entry
><varname
>background-color</varname
></entry>
	      <entry
>Farbe</entry>
	      <entry
>Die zu verwendende Hintergrundfarbe. Wenn dieser Schlüssel nicht vorhanden ist, wird als Vorgabe die global definierte Hintergrundfarbe für Listenansichten verwendet. </entry>
	    </row>
	    <row>
	      <entry
><varname
>foreground-color</varname
></entry>
	      <entry
>Farbe</entry>
	      <entry
>Die zu verwendende Vordergrundfarbe. Wenn dieser Schlüssel nicht vorhanden ist, wird als Vorgabe die global definierte Vordergrundfarbe für Listenansichten verwendet. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font</varname
></entry>
	      <entry
>Zeichensatz</entry>
	      <entry
>Der zu verwendende benutzerdefinierte Zeichensatz. Der Zeichensatz wird auf die für Listenansichten konfigurierte Größe skaliert, und mit Zeichensatzattributen (siehe unten) versehen. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-bold</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>Wenn dieser Schlüssel den Wert <literal
>true</literal
> hat und <varname
>font</varname
> nicht gesetzt ist, dann wird der Default-Listen-Zeichensatz in Fettschrift (so verfügbar) verwendet. Wenn auch <varname
>font</varname
> vorhanden ist, wird dieser Schlüssel ignoriert. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-italic</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>Analog zu <varname
>font-bold</varname
>, aber für kursiven Schriftstil anstelle von fettem. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-strikeout</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>Wenn dieser Schlüssel den Wert <literal
>true</literal
> hat, dann wird eine zentrierte Linie durch den Zeichensatz gezogen. Wird auch dann verwendet, wenn <varname
>font</varname
> gesetzt ist. </entry>
	    </row>
	    <row>
	      <entry
><varname
>icon</varname
></entry>
	      <entry
>Text</entry>
	      <entry
>Der Name eines Icons, das in der ersten Spalte angezeigt wird. Noch nicht implementiert. </entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>

      <table id="table-key-filters-criteria">
	<title
>Schlüsselfilter-Konfigurationsschlüssel, die Filterkriterien definieren</title>
	<tgroup cols="3">
	  <colspec colnum="2" align="center"/>
	  <thead>
	    <row>
	      <entry
>Konfigurationsschlüssel</entry>
	      <entry
>Typ</entry>
	      <entry
>Wenn dieser Schlüssel angegeben ist, passt der Filter, wenn ...</entry>
	    </row>
	  </thead>
	  <!--tfoot/-->
	  <tbody>
	    <row>
	      <entry
><varname
>is-revoked</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel widerrufen worden ist.</entry>
	    </row>
	    <row>
	      <entry
><varname
>is-expired</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel abgelaufen ist.</entry>
	    </row>
	    <row>
	      <entry
><varname
>is-disabled</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel vom Benutzer deaktiviert worden ist (nicht mehr benutzt werden soll). Wird bei S/MIME-Schlüsseln ignoriert. </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-root-certificate</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel ein Wurzelzertifikat ist. Wird bei OpenPGP-Schlüsseln ignoriert. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-encrypt</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel zum Verschlüsseln verwendet werden kann. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-sign</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel zum Signieren verwendet werden kann. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-certify</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel zum Signieren (Zertifizieren) anderer Schlüssel verwendet werden kann. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-authenticate</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel zur Authentifikation (etwa als <acronym
>TLS</acronym
>-Client-Zertifikat) verwendet werden kann. </entry>
	    </row>
	    <row>
	      <entry
><varname
>has-secret-key</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der geheime Schlüssel zu diesem Schlüsselpaar zur Verfügung steht. </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-openpgp-key</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel ein OpenPGP-Schlüssel (<literal
>true</literal
>) oder ein S/MIME-Schlüssel (<literal
>false</literal
>) ist. </entry>
	    </row>
	    <row>
	      <entry
><varname
>was-validated</varname
></entry>
	      <entry
>Bool'scher Wert</entry>
	      <entry
>der Schlüssel überprüft worden ist (siehe <xref linkend="certificates-validate"/>). </entry>
	    </row>
	    <row>
	      <entry
><varname
><replaceable
>pr&auml;fix</replaceable
>-ownertrust</varname
></entry>
	      <entry
>Gültigkeit<footnote
> <para
>Die Gültigkeit ist eine (geordnete) Aufzählung mit den folgenden zulässigen Werten: <literal
>unknown</literal
>, <literal
>undefined</literal
>, <literal
>never</literal
>, <literal
>marginal</literal
>, <literal
>full</literal
> und <literal
>ultimate</literal
>. Eine vollständige Beschreibung finden Sie in den Handbüchern zu &gpg; und &gpgsm;. </para>
		</footnote>
	      </entry>
	      <entry
>der Schlüssel hat genau (<replaceable
>pr&auml;fix</replaceable
>&nbsp;=&nbsp;<literal
>is</literal
>), hat alle außer (<replaceable
>pr&auml;fix</replaceable
>&nbsp;=&nbsp;<literal
>is-not</literal
>), hat mindestens (<replaceable
>pr&auml;fix</replaceable
>&nbsp;=&nbsp;<literal
>is-at-least</literal
>), oder hat höchstens (<replaceable
>pr&auml;fix</replaceable
>&nbsp;=&nbsp;<literal
>is-at-most</literal
>) den Ownertrust, der als Wert des Konfigurationsschlüssels angegeben ist. Wenn mehr als ein <varname
><replaceable
>pr&auml;fix</replaceable
>-ownertrust</varname
>-Schlüssel (mit unterschiedlichen <replaceable
>pr&auml;fix</replaceable
>-Werten) in einer einzigen Gruppe steht, ist das Verhalten undefiniert. </entry>
	    </row>
	    <row>
	      <entry
><varname
><replaceable
>pr&auml;fix</replaceable
>-validity</varname
></entry>
	      <entry
>Gültigkeit</entry>
	      <entry
>Entsprechend <varname
><replaceable
>pr&auml;fix</replaceable
>-ownertrust</varname
>, aber für die Gültigkeit von Schlüsseln anstelle von Ownertrust. </entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>

      <note>
	<para
>Einige der interessanteren Kriterien wie <varname
>is-revoked</varname
> oder <varname
>is-expired</varname
> funktionieren nur bei <emphasis
>validierten</emphasis
> Schlüsseln, weswegen defaultmäßig nur überprüfte Schlüssel auf Widerruf oder Ablauf geprüft werden, auch wenn es Ihnen frei steht, diese zusätzlichen Abfragen zu entfernen. </para>
      </note>

      <para
>Nicht angegebene Kriterien (Kriterien, deren Konfigurationsschl&uuml;ssel nicht angegeben ist), werden nicht abgefragt. Wenn ein Kriterium angegeben ist, dann wird es abgefragt und muss zutreffen, damit der Filter als Ganzes zutrifft; die einzelnen Kriterien werden also UND-verknüpft. </para>

      <example>
	<title
>Beispiele für Schlüsselfilter </title>
	<para
>Um alle abgelaufenen, aber nicht widerrufenen Wurzel-Zertifikate abzufragen, würden Sie den folgenden Schlüsselfilter verwenden: </para>
<!-- isn't there a better way to not indent this in the output??? -->
	<screen
><!--
-->[Key Filter #<replaceable
>n</replaceable
>]
Name=abgelaufen, aber nicht widerrufen
was-validated=true
is-expired=true
is-revoked=false
is-root-certificate=true<!--
     --></screen>
	<para
>Um alle deaktivierten OpenPGP-Schlüssel (derzeit noch nicht von &kleopatra; unterstützt) mit einem Ownertrust von mindestens <quote
>marginal</quote
> abzudecken, verwenden Sie: </para>
	<screen
><!--
-->[Key Filter #<replaceable
>n</replaceable
>]
Name=deaktivierte OpenPGP-Schlüssel mit einem Ownertrust von marginal oder besser
is-openpgp=true
is-disabled=true
is-at-least-ownertrust=marginal<!--
     --></screen>
      </example>

    </sect1>

  </chapter
> <!-- Administrator's Guide -->

<chapter id="credits-and-license">
<title
>Danksagungen und Lizenz</title>

<para
>&kleopatra; Copyright 2002 Steffen Hansen, Matthias Kalle Dalheimer und Jesper Pedersen, Copyright 2004 Daniel Molkentin, copyright 2004 Klar&auml;lvdalens Datakonsult AB</para>

<para
>Documentation copyright 2002 Steffen Hansen, copyright 2004 Daniel Molkentin, copyright 2004 Klar&auml;lvdalens Datakonsult AB</para>

<itemizedlist>
<title
>Mitwirkende</title>
<listitem>
<para
>Marc Mutz <email
>mutz@kde.org</email
></para>
</listitem>
<listitem>
<para
>David Faure <email
>faure@kde.org</email
></para>
</listitem>
<listitem>
<para
>Steffen Hansen <email
>hansen@kde.org</email
></para>
</listitem>
<listitem>
<para
>Matthias Kalle Dalheimer <email
>kalle@kde.org</email
></para>
</listitem>
<listitem>
<para
>Jesper Pedersen <email
>blackie@kde.org</email
></para>
</listitem>
<listitem>
<para
>Daniel Molkentin <email
>molkentin@kde.org</email
></para>
</listitem>
</itemizedlist>
&underGPL; &underFDL; </chapter>

&documentation.index; 
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
