<?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 uiserver "UiServer">
  <!ENTITY kwatchgnupg "<application
>KWatchGnuPG</application
>">
  <!ENTITY gpgsm "<application
>GpgSM</application
>">
  <!ENTITY gnupg "<application
>GnuPG</application
>">
  <!ENTITY gpg "<application
>GPG</application
>">
  <!ENTITY gpgme "<application
>GpgME</application
>"
> <!--### there's no <library
>-->
  <!ENTITY gpgconf "<application
>GpgConf</application
>">
  <!ENTITY gpgagent "<application
>GpgAgent</application
>">
  <!ENTITY dirmngr "<application
>DirMngr</application
>">
  <!ENTITY scdaemon "<application
>SCDaemon</application
>">
  <!ENTITY pinentry "<application
>PinEntry</application
>">
  <!ENTITY kappname "&kleopatra;">
  <!ENTITY package "kdepim">
  <!ENTITY ldap "<acronym
>LDAP</acronym
>">
  <!ENTITY ldaps "<acronym
>LDAPS</acronym
>">
  <!ENTITY http "<acronym
>HTTP</acronym
>">
  <!ENTITY smime "<acronym
>S/MIME</acronym
>">
  <!ENTITY openpgp "<acronym
>OpenPGP</acronym
>">
  <!ENTITY ascii "<acronym
>ASCII</acronym
>">
  <!ENTITY der "<acronym
>DER</acronym
>">
  <!ENTITY ssl "<acronym
>SSL</acronym
>">
  <!ENTITY x509 "<acronym
>X.509</acronym
>">
  <!ENTITY crl "<acronym
>CRL</acronym
>">
  <!ENTITY ocsp "<acronym
>OCSP</acronym
>">
  <!ENTITY NA "<acronym
>N/A</acronym
>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Dutch "INCLUDE">

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

<book lang="&language;">

<bookinfo>
<title
>De handboek van &kleopatra;</title>

<authorgroup>
<author
><firstname
>Marc</firstname
> <surname
>Mutz</surname
> <affiliation
> <address
><email
>marc@kdab.net</email
></address>
</affiliation>
</author>

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

<othercredit role="developer"
><firstname
>Steffen</firstname
> <surname
>Hansen</surname
> <affiliation
> <address
>&Steffen.Hansen.mail;</address>
</affiliation>
<contrib
>Ontwikkelaar</contrib>
</othercredit>

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

<othercredit role="developer"
><firstname
>Jesper</firstname
> <surname
>Pedersen</surname
> <affiliation
> <address
>&Jesper.Pedersen.mail;</address>
</affiliation>
<contrib
>Ontwikkelaar</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Daniel</firstname
> <surname
>Molkentin</surname
> <affiliation
> <address
>&Daniel.Molkentin.mail;</address>
</affiliation>
<contrib
>Ontwikkelaar</contrib>
</othercredit>

&Freek.de.Kruijf; 
</authorgroup>

<legalnotice
>&GPLNotice;</legalnotice>

<date
>2010-04-27</date>
<releaseinfo
>2.0.14</releaseinfo>

<abstract>
<para
>&kleopatra; is een hulpmiddel voor het beheer van X.509 en OpenPGP-certificaten. </para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>Kapp</keyword>
<keyword
>X509</keyword>
<keyword
>OpenPGP</keyword>
<keyword
>PGP</keyword>
<keyword
>LDAP</keyword>
<keyword
>gpg</keyword>
<keyword
>gpgsm</keyword>
<keyword
>certificaat</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction"
> <title
>Inleiding</title
> 

<para
>&kleopatra; is het &kde; hulpmiddel voor het beheer van X.509 en OpenPGP-certificaten in de &gpg; sleutelkast en voor het ophalen van certificaten uit &ldap; en andere servers voor certificaten.</para>

<para
>&kleopatra; kan gestart worden vanuit het menu van &kmail; <menuchoice
><guimenu
>Hulpmiddelen</guimenu
> <guimenuitem
>Certificatenbeheerder</guimenuitem
></menuchoice
>, evenals vanaf de commandoregel. Het &kleopatra; programma heeft de naam <userinput
><command
>kleopatra</command
></userinput
>.</para>

<note
><para
>Dit programma is genoemd naar Cleopatra, een beroemde vrouwelijke Egyptische farao die leefde in de tijd van Julius Caesar, waarmee ze een kind had, Caesarion, niet erkent als zijn erfgenaam.</para>

<para
>De naam is gekozen omdat dit programma zijn oorsprong heeft in een <ulink url="http://www.gnupg.org/aegypten2/"
>&Auml;gypten Projects</ulink
> (&Auml;gypten is Duits voor Egypte). &kleopatra; is de Duitse spelling van Cleopatra.</para
></note>

</chapter>

<chapter id="functions"
><title
>Hoofdfuncties</title>

<sect1 id="functions-view"
><title
>De lokale sleutelkast bekijken</title>

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

<para
>De hoofd functie van &kleopatra; is het weergeven en bewerken van de inhoud van de lokale sleutelkast, wat gelijk is aan het concept sleutelring van &gpg;, hoewel men deze gelijkenis niet te veel moet doorzetten.</para>

<para
>Het hoofdvenster is opgedeeld in het grote gebied voor het weergeven van de sleutels, die bestaat uit verschillende tabbladen, de menubalk en de <link linkend="functions-search"
>zoekbalk</link
> bovenaan en een statusbalk onderaan.</para>

<para
>Elke regel in de lijst met sleutels komt overeen met één certificaat, geïdentificeerd door de zogenaamde <guilabel
>Onderwerp-&dn;</guilabel
>. &dn; is een acroniem voor <quote
>Distinguished Name</quote
>, een hiërarchische identifier, in grote mate overeenkomend met een pad in een bestandssysteem met een ongebruikelijke syntaxis, waarvan verondersteld wordt dat deze een globaal unieke identiteit geeft aan een gegeven certificaat.</para>

<para
>Om geldig te zijn en dus bruikbaar, moeten (publieke) sleutels door een &ca; (Certification Authority) ondertekend zijn. Deze ondertekeningen worden certificaten genoemd, maar de termen <quote
>certificaat</quote
> en <quote
>(publieke) sleutel</quote
> worden uitwisselbaar gebruikt en we zullen ze ook niet in deze handleiding van elkaar onderscheiden, behalve wanneer expliciet genoemd.</para>

<para
>&ca;'s moeten op hun beurt worden getekend door andere &ca;'s om geldig te zijn. Natuurlijk moet dit ergens eindigen, dus tekent de &ca; op het topniveau (root-&ca;) zijn sleutel met zichzelf (dit wordt zelftekenen genoemd). Root-certificaten moeten dus handmatig geldigheid toegekend worden (gewoonlijk vertrouwen genoemd), &eg; na vergelijking van de vingerafdruk met die op de website van de &ca;. Dit wordt typisch gedaan door de systeembeheerder of de verkoper van een product dat certificaten gebruikt, maar kan ook gedaan worden door de gebruiker via het commandoregelinterface van &gpgsm;.</para>

<para
>Om te zien welke van de certificaten root-certificaten zijn, schakelt u om naar de hiërarchische modus voor de sleutellijst met <xref linkend="view-hierarchical-key-list"/>.</para>

<para
>U kunt de details zien van elk certificaat door er dubbel op te klikken of <xref linkend="view-certificate-details"/> te gebruiken. Deze opent een dialoog die de meest gebruikelijke eigenschappen van het certificaat toont, zijn ketting met certificaten (&ie; de ketting van uitgevers tot op de root-&ca;) en een dump van alle informatie die de backend uit het certificaat kan halen.</para>

<para
>Als u de sleutelkast wijzigt zonder &kleopatra; te gebruiken (&eg; met het commandoregelinterface van &gpgsm;), dan kunt u het beeld vernieuwen met <xref linkend="view-redisplay"/>.</para>

<!-- no longer in kde 4
para
>Since validating a key may take some time (&eg; CRLs might need
to be fetched), the normal keylisting does not attempt to check the
validity of keys. For this, <link linkend="certificates-validate">
<menuchoice
><shortcut
><keycombo action="simul"
>&Shift;<keycap
>F5</keycap
></keycombo>
</shortcut
><guimenu
>Certificates</guimenu
><guimenuitem
>Validate</guimenuitem
></menuchoice
></link
>,
a special variant of <link
linkend="view-redisplay"
><menuchoice
><shortcut
><keycombo action="simul">
<keycap
>F5</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu>
<guimenuitem
>Redisplay</guimenuitem
></menuchoice
></link
>, is provided. It
either checks the selected certificates, or all keys if none are
selected.</para-->

</sect1>

<sect1 id="functions-search"
><title
>Zoeken en importeren van certificaten</title>

<para
>Meestal zult u nieuwe certificaten verkrijgen door handtekeningen in e-mails te verifiëren, omdat certificaten meestal ingebed zijn in de gemaakte handtekeningen. Wanneer u echter een e-mail naar iemand moet zenden, waarmee u nog geen contact hebt gehad, dan moet u het certificaat uit een &ldap;-map (hoewel &gpgsm; dit automatisch kan doen) ophalen of uit een bestand. U moet ook uw eigen certificaat importeren na het ontvangen van het antwoord van de &ca; op uw verzoek om een certificaat.</para>

<para
>Om te zoeken naar een certificaat in een &ldap;-directory, selecteert u <menuchoice
><guimenu
>Bestand</guimenu
><guimenuitem
>Certificaten op server opzoeken</guimenuitem
></menuchoice
> en voert u enige tekst in (&eg; de naam van de persoon waarvan u het certificaat wilt) in het tekstinvoervak van de dialoog <guilabel
>Certificaten opzoeken op de sleutelserver</guilabel
>, klik daarna op de knop <guilabel
>Zoeken</guilabel
>. De resultaten worden getoond in de lijst met sleutels onder de zoekbalk, waar u certificaten selecteert om ze beter te bekijken door te klikken op de knop <guibutton
>Details</guibutton
> of ze download met <guibutton
>Importeren</guibutton
> in de lokale sleutelkast.</para>
<!--
Note that you can also download the certificate from the
details dialog, using the <guilabel
>Import to Local</guilabel>
button.</para>
not found in 4.2
-->

<para
>U kunt de lijst met &ldap;-servers instellen voor het zoeken in de pagina <link linkend="configuration-directory-services"
><guilabel
>Directory Services</guilabel
></link
> van de instellingendialoog van &kleopatra;.</para>

<para
>Als u het certificaat als een bestand ontvangt, probeer dan <xref linkend="file-import-certificates"/>. &gpgsm; moet het formaat van het certificaatbestand begrijpen; kijk in de handleiding van &gpgsm; voor een lijst van ondersteunde bestandsformaten.</para>

<para
>Als u <link linkend="functions-newkey"
>uw eigen sleutelpaar met &gpgsm; aanmaken</link
> niet hebt uitgevoerd, dan moet u ook handmatig de publieke sleutel (evenals de geheime sleutel) importeren uit het PKCS#12-bestand dat u van de &ca; ontving. U kunt dit op de commandoregel doen met <link linkend="commandline-option-import-certificate"
><userinput
><command
>kleopatra <option
>--import-certificate</option
> <filename
>bestandsnaam</filename
></command
></userinput
></link
> of in &kleopatra; met <xref linkend="file-import-certificates"/>, zoals u ook zou doen met <quote
>normale</quote
> certificaten.</para>

</sect1>

<sect1 id="functions-newkey"
><title
>Nieuwe sleutelparen aanmaken</title>

<para
>Het menuitem <xref linkend="file-new-key-pair"/> start de <guilabel
>Assistent voor certificaat aanmaken</guilabel
> die u door een aantal stappen voor het aanmaken van een certificaatverzoek.</para
> 
<para
>Wanneer u klaar bent met een stap in de assistent, druk dan op <guibutton
>Volgende</guibutton
> om naar de volgende stap (of <guibutton
>Terug</guibutton
> om stappen te herzien die al zijn voltooid). Het maken van het certificaatverzoek kan op elk moment worden geannuleerd door op de knop <guibutton
>Annuleren</guibutton
> te drukken. </para>
<para
>Op de eerste pagina van de assistent kiest u welk type certificaat u wilt aanmaken:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Een persoonlijk OpenPGP-sleutelpaar aanmaken</guilabel
></term>
<listitem
><para
>OpenPGP sleutelparen worden lokaal aangemaakt en gecertificeerd door uw vrienden en bekenden. Er is geen centrale certificatieautoriteit; in plaats daarvan kan elk individu een persoonlijk "Web van vertrouwen" door andere sleutelparen te certificeren met zijn eigen certificaat.</para>
<para
>U moet een <guilabel
>Naam</guilabel
>, <guilabel
>E-mailadres</guilabel
> en optioneel <guilabel
>Commentaar</guilabel
> invoeren.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Een persoonlijk X.509-sleutelpaar en certificatieverzoek aanmaken</guilabel
></term>
<listitem>
<para
>X.509 sleuteparen worden lokaal aangemaakt, maar centraal gecertificeerd door een certificatieautoriteit (&ca;). Een &ca; kan een andere &ca; certificeren, waardoor een centrale, hiërarchische keten van vertrouwen ontstaat.</para>
<para
>De volgende stap in de assistent is het invoeren van uw persoonlijke gegevens voor het certificaat. De in te vullen velden zijn: <itemizedlist>
<listitem>
<para
><guilabel
>Common Name (CN): </guilabel
>Uw naam;</para>
</listitem>
<listitem>
<para
><guilabel
>E-mailadres (EMAIL):</guilabel
> Uw e-mailadres; let er goed op dat dit juist is&mdash;dit zal worden gebruikt als het adres waar mensen e-mail naar zenden wanneer ze uw certificaat gebruiken.</para>
</listitem>
<listitem>
<para
><guilabel
>Locatie (L):</guilabel
> Het dorp of de stad waarin u woont;</para>
</listitem>
<listitem>
<para
><guilabel
>Organizational unit (OU):</guilabel
> De eenheid in uw organisatie waarin u zich bevindt (bijvoorbeeld, "Administratie");</para
> 
</listitem>
<listitem>
<para
><guilabel
>Organization (O):</guilabel
> De organisatie die u vertegenwoordigt (bijvoorbeeld, het bedrijf waarvoor u werkt);</para>
</listitem>
<listitem>
<para
><guilabel
>Country code (C):</guilabel
> De tweeletterige code voor het land waarin u woont (bijvoorbeeld, "NL");</para>
</listitem>
</itemizedlist>
</para
><para
>De volgende stap in de assistent is het selecteren of het certificaat in een bestand moet worden opgeslagen of direct verzenden naar een &ca;. U zult de bestandsnaam of het e-mailadres, waarnaar het certificaatverzoek verzonden moet worden, moeten specificeren. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>


<!-- hopelessly outdated
<sect1 id="functions-keybox-management"
><title
>Keybox Management</title>

<para
>In addition to <link linkend="functions-view"
>list and
validate</link
>, <link linkend="functions-search"
>search and
import</link
> certificates and <link
linkend="functions-newkey"
>creating new ones</link
>, &kleopatra; also
has some less often used functions that help you manage your local
keybox.</para>

<para
>These functions include deleting certificates from the local
keybox with <xref linkend="certificates-delete"/>, as well 
as manual handling of CRLs (<xref linkend="certificates-refresh-x509"/>,
<xref linkend="crls-clear-crl-cache"/>, <xref linkend="crls-dump-crl-cache"/>).
</para>

</sect1>
-->

</chapter>

<chapter id="menu"
><title
>Menureferentie</title>

<sect1 id="menufile"
><title
>Menu Bestand</title>

<variablelist>

<varlistentry id="file-new-key-pair">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Bestand</guimenu
><guimenuitem
>Nieuw certificaat...</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Maakt een nieuw sleutelpaar (publiek en privé) aan</action
> en stelt u in staat om het publieke deel naar een certificatieautoriteit te sturen (&ca;) ter certificering. Het resulterende certificaat wordt dan naar u teruggezonden of opgeslagen in een &ldap;-server zodat u het kunt downloaden in uw lokale sleutelkast, waar u het kan gebruiken om te signeren en e-mails te ontcijferen.</para>

<para
>Deze manier van werken wordt <quote
>gedecentraliseerde sleutelgeneratie</quote
> genoemd, omdat alle sleutels lokaal worden aangemaakt. &kleopatra; (en &gpgsm;) ondersteunen geen directe <quote
>gecentraliseerde sleutelgeneratie</quote
>, maar u kunt het publieke/geheime sleutelpaar dat u ontvangt van de &ca; in het formaat PKCS#12 via <xref linkend="file-import-certificates"/> importeren.</para>
</listitem>
</varlistentry>

        <varlistentry id="file-lookup-certificates">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Bestand</guimenu
><guimenuitem
>Certificaten opzoeken op de server...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Zoekt naar en importeert certificaten op servers voor certificaten naar de lokale sleutelkast.</action
> Zie <xref linkend="functions-search"/> voor details. </para>
            <para
>U moet servers voor certificaten hebben geconfigureerd om dit te laten werken. Zie <xref linkend="configuration-directory-services"/> voor meer details. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="file-import-certificates">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>I</keycap
></keycombo
></shortcut
> <guimenu
>Bestand</guimenu
><guimenuitem
>Certificaten importeren...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Importeert certificaten en/of geheime sleutels uit bestanden in de lokale sleutelkast.</action
> Zie <xref linkend="functions-search"/> voor details. </para>
            <para
>Het formaat van het certificaat moet worden ondersteund door &gpgsm;/&gpg;. Kijk in de handleiding van &gpgsm; en &gpg; voor een lijst van ondersteunde bestandsformaten. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="file-export-certificates">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>Bestand</guimenu
><guimenuitem
>Certificaten exporteren...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Exporteert de geselecteerde certificaten naar een bestand.</action>
            </para>
            <para
>De extensie van de bestandsnaam die u koos voor het exporteren bepaalt het formaat van het exportbestand: </para>
            <itemizedlist>
              <listitem>
                <para
>Voor OpenPGP certificaten, resulteren <filename class="extension"
>gpg</filename
> en <filename class="extension"
>pgp</filename
> in een binair bestand, terwijl <filename class="extension"
>asc</filename
> resulteert in een &ascii; file. </para>
              </listitem>
              <listitem>
                <para
>Voor &smime; certificaten, resulteert <filename class="extension"
>der</filename
> in een binair, &der;-gecodeerd bestand, terwijl <filename class="extension"
>pem</filename
> resulteert in een &ascii; bestand. </para>
              </listitem>
            </itemizedlist>
            <para
>Tenzij meerdere certificaten zijn geselecteerd, zal &kleopatra; <filename
><replaceable
>vingerafdruk</replaceable
>.{asc,pem}</filename
> als de naam van het te exporteren bestand voorstellen. </para>
            <para
>Deze functie is alleen beschikbaar wanneer een of meer certificaten zijn geselecteerd. </para>
            <note>
              <para
>Deze functie exporteert alleen de publieke sleutels, zelfs als de geheime sleutel beschikbaar is . Gebruik <xref linkend="file-export-secret-key"/> om zowel de publieke als de geheime sleutels in een bestand te exporteren, maar let er op dat dat bijna altijd een slecht idee is. </para>
            </note>
          </listitem>
        </varlistentry>

        <varlistentry id="file-export-secret-key">
          <term>
            <menuchoice
><guimenu
>Bestand</guimenu
><guimenuitem
>Geheime sleutels exporteren...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Exporteert beiden, de publieke en geheime sleutel, naar een bestand.</action>
            </para>
            <para
>In de geopende dialoog kunt u een <guilabel
>Uitvoerbestand</guilabel
>snaam kiezen, en of een binair of &ascii;-bestand (<guilabel
>ASCII-bewapend</guilabel
>) voor export moet worden aangemaakt. Bij exporteren van &smime; geheime sleutels kunt u ook de <guilabel
>Tekenset van de wachtwoordzin</guilabel
> kiezen. Zie de discussie van de optie <option
>--p12-charset&nbsp;<replaceable
>tekenset</replaceable
></option
> in het handboek van &gpgsm; voor meer details. </para>
            <para
>Deze functie is alleen beschikbaar wanneer precies één certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is. </para>
            <warning>
              <para
>Het zou zelden nodig moeten zijn om deze functie te gebruiken, en als dat zo is, dan zou het zorgvuldig gepland moeten worden. De migratie van een geheime sleutel bevat een keuze van het transportmedium en de veilige verwijdering van de sleutelgegevens op de oude machine, evenals die onder andere op het transportmedium. </para>
            </warning>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>Bestand</guimenu
><guimenuitem
>Certificaten naar server exporteren...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Publiceer de geselecteerde certificaten op een sleutelserver</action
> (alleen &openpgp;). </para>
            <para
>Het certificaat wordt verzonden naar de server voor certificaten geconfigureerd voor &openpgp; (cf.&nbsp;<xref linkend="configuration-directory-services"/>), als die is ingesteld, anders naar <systemitem class="systemname"
>keys.gnupg.net</systemitem
>. </para>
            <para
>Deze functie is alleen beschikbaar als minstens een &openpgp; (en geen &smime;) certificaten zijn geselecteerd. </para>
            <note>
              <!-- also appears in message box in -->
              <!-- commands/exportopenpgpcertificatestoserver.cpp -->
              <para
>Wanneer OpenPGP-certificaten naar een publieke directory-server geëxporteerd zijn, is het bijna onmogelijk om ze weer te verwijderen. Maak een intrekkingscertificaat aan, voordat u uw certificaten naar de publieke directory-server exporteert, zodat u ze indien nodig later weer kan intrekken. </para>
            </note>
            <note>
              <para
>De meeste publieke &openpgp; servers voor certificaten synchroniseren deze onder elkaar, zodat er weinig reden is ze naar meer dan een server te sturen. </para>
              <para
>Het kan zijn dat zoeken op een certificatenserver geen resultaten oplevert zelfs als u zojuist uw certificaat daarheen hebt opgestuurd. Dit is vanwege het feit dat publieke sleutelserveradressen round-robin uit de <acronym
>DNS</acronym
>-server komen om de belasting te balanceren over meerdere machines. Deze machines synchroniseren zich met elkaar, maar gewoonlijk slechts ongeveer elke 24 uur. </para>
            </note>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice
><guimenu
>Bestand</guimenu
><guimenuitem
>Ontcijfer/verifieer bestanden...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Ontcijfert bestanden en/of verifieert handtekeningen</action
> over bestanden. </para>
<!--
            <para>
              See <xref linkend="function-decrypt-verify-files"/> for details.
            </para>
-->
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice
><guimenu
>Bestand</guimenu
><guimenuitem
>Onderteken/versleutel bestanden...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Ondertekent en/of versleutelt bestanden.</action>
            </para>
<!--
            <para>
              See <xref linkend="function-sign-encrypt-files"/> for details.
            </para>
-->
          </listitem>
        </varlistentry>
<!--
Create Checksum Files...
Verify Checksum Files...
  missing-->
        <varlistentry>
          <term>
            <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>W</keycap
></keycombo
> </shortcut
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Sluiten</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Sluit het hoofdvenster van &kleopatra;.</action
> U kunt het op elk moment herstellen met het pictogram in het systeemvak. </para>
          </listitem>
        </varlistentry>

<varlistentry id="file-quit">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Afsluiten</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>&kleopatra; wordt beëindigd.</action
></para>
</listitem>
</varlistentry>

</variablelist>

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



<sect1 id="menuview"
><title
>Menu Beeld</title>

      <variablelist>

        <varlistentry id="view-redisplay">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
><keycap
>F5</keycap
></keycombo
></shortcut
> <guimenu
>Beeld</guimenu
><guimenuitem
>Opnieuw tonen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Ververst de certificatenlijst.</action>
            </para>
            <para
>Het gebruik van deze functie is gewoonlijk niet nodig, omdat &kleopatra; het bestandssysteem monitort op wijzigingen en automatisch de certificatenlijst ververst indien nodig. </para>
          </listitem>
        </varlistentry>


        <varlistentry id="view-stop-operation">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
>&Esc;</keycombo
></shortcut
> <guimenu
>Beeld</guimenu
><guimenuitem
>Bewerking stoppen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Stopt (annuleert) alle gaande acties,</action
> &eg; een zoekopdracht, lijst met sleutels tonen of een download. </para>
            <para
>Deze functie is alleen beschikbaar als minstens een actie actief is. </para>
            <note>
              <para
>Vanwege beperkingen in de backend, hangen bewerkingen soms op zo'n manier dat deze functie ze niet direct kan annuleren of zelfs helemaal niet. </para>
              <para
>In zulke gevallen is de enige manier om de orde te herstellen het killen van de processen &scdaemon;, &dirmngr;, &gpgsm; en &gpg;, in die volgorde, via de systeemhulpmiddelen (<command
>top</command
>, venstertakenbeheerder, &etc;), totdat de bewerking niet geblokkeerd is. </para>
            </note>
          </listitem>
        </varlistentry>


<varlistentry id="view-certificate-details">
<term
><menuchoice
><guimenu
>Beeld</guimenu
><guimenuitem
>Details van certificaat</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Toont de details van het geselecteerde certificaat.</action
></para>

<para
>Deze functie is alleen beschikbaar wanneer precies één certificaat is geselecteerd.</para>

<para
>Deze functie is ook beschikbaar door direct te dubbelklikken op het overeenkomstige item in de getoonde lijst.</para>

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


<varlistentry id="view-hierarchical-key-list">
<term
><menuchoice
><guimenu
>Beeld</guimenu
><guimenuitem
>Hiërarchische certificatenlijst</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Wisselt tussen een hiërarchische en platte modus van de certificatenlijst. </action
></para>

<para
>In de hiërarchische modus zijn certificaten gerangschikt in de relatie uitgever/onderwerp, zodat is gemakkelijk is te zien tot welke hiërarchie een gegeven certificaat behoort, maar een gegeven certificaat is initieel moeilijker te vinden (hoewel u natuurlijk de <link linkend="functions-search"
>zoekbalk</link
> kunt gebruiken).</para>

<para
>In platte modus worden alle certificaten in een platte lijst getoond, alfabetisch gesorteerd. In deze modus is een gegeven certificaat gemakkelijk te vinden, maar het is niet direct duidelijk tot welk root-certificaat het behoort.</para>

            <para
>Deze functie wisselt de hiërarchische modus per tabblad, &ie; elk tabblad heeft zijn eigen hiërarchiestatus. Dit is omdat u zowel een platte als een hiërarchische lijst bij hand kunt hebben, elk in zijn eigen tabblad. </para>

            <note>
              <para
>Hiërarchische weergave is nu alleen geïmplementeerd voor &smime;-certificaten. Er is onder de ontwikkelaars onenigheid over de juiste manier om &openpgp;-certificaten hiërarchisch weer te geven (in wezen, <quote
>ouder &equals; ondertekenaar</quote
> of <quote
>ouder &equals; ondertekende</quote
>). </para>
            </note>

</listitem>
</varlistentry>


<varlistentry id="view-expand-all">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>.</keycap
> </keycombo
></shortcut
><guimenu
>Beeld</guimenu
><guimenuitem
>Alles uitvouwen</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Vouwt alle items in de lijst in de lijstweergave van de certificaten uit,</action
> &ie; maakt alle items zichtbaar.</para>

<para
>Dit is de standaard bij het binnengaan in de modus hiërarchische sleutellijst.</para>

<para
>U kunt natuurlijk nog steeds elk individueel item invouwen of uitklappen.</para>

<para
>Deze functie is alleen beschikbaar wanneer <xref linkend="view-hierarchical-key-list"/> aan is.</para>

</listitem>
</varlistentry>

<varlistentry id="view-collapse-all">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>,</keycap
> </keycombo
></shortcut
><guimenu
>Beeld</guimenu
><guimenuitem
>Alles invouwen</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Vouwt alle items in de lijst met certificaten in,</action
> &ie; verbergt alles behalve het bovenste gedeelte van de items.</para>

<para
>U kunt natuurlijk nog steeds elk individueel item invouwen of uitklappen.</para>

<para
>Deze functie is alleen beschikbaar wanneer <xref linkend="view-hierarchical-key-list"/> aan is.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menucertificates"
><title
>Menu met certificaten</title>

      <variablelist>

        <varlistentry id="certificates-change-owner-trust">
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Eigenaarvertrouwen wijzigen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Wijzigt het vertrouwen in de eigenaar van het geselecteerde &openpgp;-certificaat.</action>
<!--
              See <xref linkend="functions-manage-wot"/> for details.
-->
            </para>
            <para
>Deze functie is alleen beschikbaar wanneer precies één &openpgp;-certificaat is geselecteerd. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-trust-root">
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Hoofdcertificaat vertrouwen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Markeert dit (&smime;)-hoofdcertificaat als vertrouwd.</action>
            </para>
            <para
>Op een bepaalde manier is dit het equivalent van <xref linkend="certificates-change-owner-trust"/> voor &smime;-hoofdcertificaten. U kunt echter alleen kiezen tussen&mdash;in &openpgp; termen&mdash;<quote
>volledig</quote
> vertrouwen en <quote
>geen vertrouwen</quote
>. </para>
            <note>
              <para
>De backend (via &gpgagent;) zal op het moment van het importeren van het hoofdcertificaat of het geïmporteerde hoofdcertificaat is te vertrouwen. Die functie moet expliciet worden ingeschakeld in instellingen van de backend (<option
>allow-mark-trusted</option
> in <filename
>gpg-agent.conf</filename
> of ofwel <menuchoice
><guimenu
>GnuPG-systeem</guimenu
> <guisubmenu
> GPG-agent</guisubmenu
> <guimenuitem
>Sta clients toe om sleutels als "vertrouwd" te markeren</guimenuitem
></menuchoice
> ofwel <link linkend="configuration-smime-validation-allow-mark-trusted"
><menuchoice
><guimenu
>S/MIME-validatie</guimenu
> <guimenuitem
>Sta toe hoofdcertificaten als vertrouwd te markeren</guimenuitem
></menuchoice
></link
> onder <xref linkend="settings-configure-kleopatra"/>). </para>
              <para
>Die functionaliteit in de backend inschakelen kan leiden tot popups van &pinentry; op ongewenste tijden (&eg; bij het verifiëren van handtekeningen) en kan dus onbewaakte e-mailverwerking blokkeren. Daarom en omdat het gewenst is om in staat te zijn een vertrouwd hoofdcertificaat opnieuw te <emphasis
>wantrouwen</emphasis
>, staat &kleopatra; handmatig instellen van vertrouwen toe. </para>
            </note>
            <warning>
              <para
>Vanwege het ontbreken van ondersteuning voor deze functie door een backend, is het nodig dat &kleopatra; direct op de vertrouwensdatabase (<filename
>trustlist.txt</filename
>) van &gpgsm; werkt. Bij het gebruiken van deze functie moet u er zeker van zijn dat er geen andere versleutelingsbewerkingen bezig zijn die concurreren met &kleopatra; voor wijzigingen in die database. </para>
            </warning>
            <para
>Deze functie is alleen beschikbaar wanneer precies één &smime;-hoofdcertificaat is geselecteerd en dat certificaat nog niet vertrouwd wordt. </para>
            <para
>Gebruik <xref linkend="certificates-distrust-root"/> om deze functie ongedaan te maken. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-distrust-root">
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Wantrouw hoofdcertificaat</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Markeert dit &smime;-hoofdcertificaat als niet vertrouwd.</action>
            </para>
            <para
>Deze functie is alleen beschikbaar wanneer precies één &smime;-hoofdcertificaat is geselecteerd en dat certificaat wordt nu vertrouwd. </para>
            <para
>Gebruikt om <xref linkend="certificates-trust-root"/> ongedaan te maken. Zie aldaar voor details. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-certify">
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Certificeer certificaat...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Stelt u in staat om een ander &openpgp;-certificaat te certificeren.</action>
<!-- ### xref
              See <xref linkend="functions-manage-wot"/> for details.
-->
            </para>
            <para
>Deze functie is alleen beschikbaar als precies één &openpgp;-certificaat is geselecteerd. </para>
          </listitem>
        </varlistentry>


<!--no longer in kde4
<para
>This is similar to <link
linkend="view-redisplay"
><menuchoice
><shortcut
><keycombo action="simul">
<keycap
>F5</keycap
></keycombo
></shortcut
><guimenu
>View</guimenu>
<guimenuitem
>Redisplay</guimenuitem
></menuchoice
></link
>, but
performs a validation of the (selected) keys. Validation here means
that all relevant CRLs are fetched, and the certificate chain is
checked for correctness. As a result, invalid or expired keys will be
marked according to your color and font preferences set in the <link
linkend="configuration-appearance-certificate-filters"
><guilabel
>Appearance</guilabel>
page</link
> of &kleopatra;'s <link linkend="configuration"
>configure
dialog</link
>.</para>

<warning
><para
>You can only rely on information from validated keys,
and, since any of them may be revoked at any time, even validation is
only ever a snapshot of the current state of the local keyring. This
is why the backend normally performs such checks whenever the keys
are used (&eg; for signing, signature verification, encryption or
decryption).</para
></warning>
</listitem>
</varlistentry>
-->
<!--not in 4.2
varlistentry id="certificates-refresh-crls">
<term
><menuchoice
><guimenu
>Certificates</guimenu
><guimenuitem
>Refresh CRLs</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Fetches the current CRLs for all selected keys,</action>
even though they would normally not be fetched when using the
key.</para>

<para
>This function only has an effect on certificates which define a
CRL distribution point. Depending on the backend used, certificates
configured to perform checks using OCSP will not be updated.</para>

<para
>You may use this &eg; if you have sideband knowledge that a key
has been revoked, and you want the backend to reflect this
<emphasis
>now</emphasis
> instead of relying on this to automatically
happen at the next scheduled CRL update.</para>

<warning
><para
>Excessive use of this function might put a high load on
your provider's or company's network, since CRLs of large
organizations can be surprisingly big (several megabytes are not
uncommon).</para>

<para
>Use this function scarcely.</para
></warning>
</listitem>
</varlistentry-->

        <varlistentry>
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Vervaldatum wijzigen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Stelt u in staat om de vervaldatum van uw &openpgp;-certificaat te wijzigen.</action>
            </para>
            <para
>Gebruik deze functie om de leeftijd van uw &openpgp;-certificaten, als alternatief voor ofwel een nieuwe aanmaken of een onbeperkte leeftijd te gebruiken (<quote
>vervalt nooit</quote
>). </para>
            <para
>Deze functie is alleen beschikbaar als precies één certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is. </para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Wachtwoordzin wijzigen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Stelt u in staat om de wachtwoordzin van uw geheime sleutel te wijzigen.</action>
            </para>
            <para
>Deze functie is alleen beschikbaar als precies één certificaat is geselecteerd en de geheime sleutel beschikbaar is voor dat certificaat. Het vereist een erg recente backend, omdat we de implementatie van het direct aanroepen van &gpg; en &gpgsm; hebben gewijzigd tot een op &gpgme; gebaseerde. </para>
            <note>
              <para
>Uit veiligheidsredenen, wordt zowel de oude als de nieuwe wachtwoordzin gevraagd door &pinentry;, een separaat proces. Afhankelijk van het platform waarop u werkt en de kwaliteit van de implementatie van &pinentry; op dat platform, kan het zijn dat het venster van &pinentry; opkomt in de achtergrond. Dus als u deze functie selecteert en er gebeurt niets, controleer dan taakbalk van het besturingssyteem in geval een venster van &pinentry; geopend is in de achtergrond. </para>
            </note>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Gebruikers-id toevoegen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Stelt u in staat om een nieuwe gebruikers-id aan uw &openpgp;-certificaat toe te voegen.</action>
            </para>
            <para
>Gebruik dit om nieuwe identiteiten aan een bestaand certificaat toe te voegen als alternatief voor het aanmaken van een nieuw sleutelpaar. Een &openpgp; gebruikers-id heeft de volgende vorm: </para>
            <programlisting
><replaceable
>Echte&nbsp;naam</replaceable
>&nbsp;<optional
>(<replaceable
>Commentaar</replaceable
>)</optional
>&nbsp;&lt;<replaceable
>E-mailadres</replaceable
>&gt;</programlisting>
            <para
>In de dialoog die verschijnt wanneer u deze functie selecteert, zal &kleopatra; u apart vragen naar elk van de drie parameters (<replaceable
>Echte&nbsp;naam</replaceable
>, <replaceable
>Commentaar</replaceable
> en <replaceable
>E-mailadres</replaceable
>) en het resultaat aan u tonen. </para>
            <note>
              <para
>Deze parameters zijn onderworpen aan dezelfde beheerdersbeperkingen als in nieuwe certificaten. Zie <xref linkend="functions-newkey"/> en <xref linkend="admin-certificate-request-wizard"/> voor details. </para>
            </note>
            <para
>Deze functie is alleen beschikbaar als precies één &openpgp;-certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-delete">
          <term>
            <menuchoice
><shortcut
><keycombo action="simul"
><keycap
>Del</keycap
></keycombo
></shortcut
> <guimenu
>Certificaten</guimenu
><guimenuitem
>Verwijderen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Verwijdert de geselecteerde certificaten</action
> uit de lokale sleutelring. </para>
            <para
>Gebruik deze functie om ongebruikte sleutels uit uw lokale sleutelkast te verwijderen. Certificaten zijn typisch vastgemaakt aan ondertekende e-mails, verifiëren van een e-mail kan er in resulteren dat de zojuist verwijderde weer de kop op steekt in de lokale sleutelkast. Het is dus waarschijnlijk het beste om deze functie zo min mogelijkheid te gebruiken. Als u zich verloren voelt, gebruik dan de <link linkend="functions-search"
>zoekbalk</link
> of de functie <xref linkend="view-hierarchical-key-list"/> om de controle terug te krijgen over de meeste certificaten. </para>
            <warning>
              <para
>Er is één uitzondering op het bovenstaande: Als u een van uw eigen certificaten verwijdert, dan verwijdert u daarmee ook de geheime sleutel. Dat betekent dat u niet in staat zult zijn om vroeger met dit certificaat versleutelde communicatie te lezen, tenzij u nog ergens een reservekopie hebt. </para>
              <para
>&kleopatra; zal u waarschuwen wanneer u een geheime sleutel probeert te verwijderen. </para>
            </warning>
            <para
>Vanwege de hiërarchische natuur van &smime;-certificaten is het zo dat, als u een &smime;-certificaat van een uitgever (&ca;-certificaat) verwijdert, alle afgeleiden ook worden verwijderd.<footnote
><para
>Dit is hetzelfde als een bestandssysteem: wanneer u een map verwijdert, verwijdert u ook alle bestanden en mappen erin.</para
></footnote>
            </para>
            <para
>Natuurlijk is deze functie alleen beschikbaar als u minstens één certificaat hebt geselecteerd. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-dump-certificate">
          <term>
            <menuchoice
><guimenu
>Certificaten</guimenu
><guimenuitem
>Certificaat dumpen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Toont alle informatie die &gpgsm; heeft over het geselecteerde (&smime;-) certificaat.</action>
            </para>
            <para
>Zie de discussie over <option
>--dump-key&nbsp;<replaceable
>sleutel</replaceable
></option
> in het handboek van &gpgsm; voor details over de uitvoer. </para>
          </listitem>
        </varlistentry>

<!--not in 4.2
varlistentry id="certificates-download">
<term
><menuchoice
><guimenu
>Certificates</guimenu
><guimenuitem
>Download</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Downloads the selected certificate(s) from the &ldap; to the local keybox.</action
></para>
</listitem>
</varlistentry-->

</variablelist>

</sect1>

<sect1 id="menutools"
><title
>Menu hulpmiddelen</title>

<variablelist>

        <varlistentry id="tools-gnupg-log-viewer">
          <term>
            <menuchoice
><guimenu
>Hulpmiddelen</guimenu
> <guimenuitem
>GnuPG-logweergave...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Start <ulink url="help:/kwatchgnupg/index.html"
>&kwatchgnupg;</ulink
></action
>, een hulpmiddel om de debuguitvoer van &gnupg; toepassingen te tonen. Als ondertekenen, versleutelen of verifiëren mysterieus stop met werken, dan kunt misschien vinden waarom door in de log te kijken. </para>
            <para
>Deze functie is niet beschikbaar onder Windows, omdat de onderliggende mechanismen niet in de backend op dat platform zijn geïmplementeerd. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-refresh-openpgp">
          <term>
            <menuchoice
><guimenu
>Hulpmiddelen</guimenu
><guimenuitem
>OpenPGP-certificaten verversen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Alle &openpgp;-certificaten verversen</action
> door het uitvoeren van <programlisting
><command
>gpg&nbsp;<option
>--refresh-keys</option
></command
></programlisting
> Na succesvolle uitvoering van het commando, bevat uw lokale sleutelbos de laatste wijzigingen met betrekking tot de geldigheid van &openpgp;-certificaten. </para>
            <para
>Zie de opmerking onder <xref linkend="certificates-refresh-x509"/> voor enige valkuilen. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="certificates-refresh-x509">
          <term>
            <menuchoice
><guimenu
>Hulpmiddelen</guimenu
><guimenuitem
>X.509-certificaten verversen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Alle &smime;-certificaten verversen</action
> door het uitvoeren van <programlisting
><!--
                --><command
>gpgsm&nbsp;<!--
                  --><option
>-k</option
>&nbsp;<!--
                  --><option
>--with-validation</option
>&nbsp;<!--
                  --><option
>--force-crl-refresh</option
>&nbsp;<!--
                  --><option
>--enable-crl-checks</option
><!--
                  --></command
></programlisting
> Na succesvolle uitvoering van het commando bevat uw lokale sleutelbos de laatste wijzigingen met betrekking tot de geldigheid van &smime;-certificaten. </para>
            <note>
              <para
>Het verversen van &x509; of &openpgp; certificaten houdt in het downloaden van alle certificaten en &crl;'s, om te controleren of ze intussen zijn ingetrokken. </para>
              <para
>Dit kan een zware belasting zijn voor uw eigen en andermans netwerk en kan meer dan een uur duren, afhankelijk van de netwerkverbinding en het aantal te controleren certificaten. </para>
            </note>
          </listitem>
        </varlistentry>

        <varlistentry id="file-import-crls">
          <term>
            <menuchoice
><guimenu
>Hulpmiddelen</guimenu
><guimenuitem
>CRL uit een bestand importeren...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Laat u handmatig &crl;'s uit bestanden importeren.</action>
            </para>
            <para
>Normaal worden 'Certificate Revocation Lists' (&crl;'s) transparent afgehandeld door de backend, maar soms kan het nuttig zijn om een &crl; handmatig te importeren in de lokale &crl;-cache. </para>
            <note>
              <para
>Om het importeren van &crl; te laten werken moet het hulpmiddel &dirmngr; in <envar
>PATH</envar
> zijn te vinden. Als dit menu-item is uitgeschakeld, dan zou u contact met de systeembeheerder moeten opnemen en hem vragen &dirmngr; te installeren. </para>
            </note>
          </listitem>
        </varlistentry>

<!-- no longer provided 
that is wrong
"Clear CRL Cache"+"Dump CRL Cache" are still in the gui of 4.5 + trunk
-->
<varlistentry id="crls-clear-crl-cache">
<term
><menuchoice
><guimenu
>Hulpmiddelen</guimenu
><guimenuitem
>CRL-cache wissen</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Wist de CRL-cache van &gpgsm;.</action
></para>

<para
>U hebt dit waarschijnlijk nooit nodig. U kunt het verversen van de CRL-cache forceren door alle certificaten te selecteren en in plaatst daarvan <xref linkend="certificates-refresh-x509"/> te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry id="crls-dump-crl-cache">
<term
><menuchoice
><guimenu
>Hulpmiddelen</guimenu
><guimenuitem
>CRL-cache dumpen</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Toont de gedetailleerde inhoud van de CRL-cache van &gpgsm;.</action
></para>
</listitem>
</varlistentry>
<!-- no longer provided
<varlistentry id="settings-configure-gpgme-backend">
<term
><menuchoice
><guimenu
>Tools</guimenu
><guimenuitem
>Configure GnuPG Backend...</guimenuitem
></menuchoice
></term>

<listitem>
<para
><action
>Opens a dialog that allows you to configure every aspect of
&gpgsm; and other backend modules.</action
></para>

<para
>This dialog is dynamically built from the output of the
&gpgconf; utility and may thus change when backend modules are
updated.</para>
</listitem>
</varlistentry>
-->

</variablelist>

</sect1>

<sect1 id="menusettings"
><title
>Menu Instellingen</title>

      <variablelist>

        <varlistentry id="settings-self-test">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>Zelftest uitvoeren</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Een set zelftesten uitvoeren en hun resultaat laten zien.</action>
            </para>
            <para
>Dit is dezelfde set testen die bij opstarten standaard worden uitgevoerd. Als u de zelftesten bij opstarten hebt uitgeschakeld, dan kunt u ze hier weer aanzetten. </para>
<!-- ### xref
            <para>
              See <xref linkend="function-selftest"/> for details.
            </para>
-->
          </listitem>
        </varlistentry>

        <varlistentry id="settings-toolbars">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
><guisubmenu
>Getoonde werkbalken</guisubmenu
></menuchoice
></term>
          <listitem>
            <para>
              <action
>&kleopatra; werkbalken tonen/verbergen.</action>
            </para>
            <para
>&kleopatra; heeft twee werkbalken: <orderedlist>
                <listitem>
                  <para>
                    <guilabel
>Hoofdwerkbalk</guilabel>
                  </para>
                  <para
>Deze werkbalk bevat een selectie van algemene functies. U kunt instellen welke functies u hier wilt zien met <xref linkend="settings-configure-toolbars"/>. </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel
>Zoekbalk</guilabel>
                  </para>
                  <para
>Deze werkbalk bevat de zoek- en filterbesturing. </para>
                </listitem>
              </orderedlist>
            </para>
          </listitem>
        </varlistentry>

        <varlistentry id="settings-show-statusbar">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>Statusbalk tonen</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Schakelt de zichtbaarheid van de onderste statusbalk aan/uit.</action>
            </para>
          </listitem>
        </varlistentry>

        <varlistentry id="settings-configure-shortcuts">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>Sneltoetsen instellen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Opent de standaard &kde; sneltoetsen-configuratie-dialoog, waarmee u sneltoetsen kunt definiëren en verwijderen voor alle menu-items.</action>
            </para>
          </listitem>
        </varlistentry>

        <varlistentry id="settings-configure-toolbars">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalken instellen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para
><action
>Opent de standaard dialoog voor het configureren van de &kde;-werkbalk,</action
> waarin u kunt kiezen welke acties in de werkbalken van &kleopatra; moeten komen. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="settings-configure-kleopatra">
          <term>
            <menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>&kleopatra; instellen...</guimenuitem
> </menuchoice>
          </term>
          <listitem>
            <para>
              <action
>Opent de configuratiedialoog van &kleopatra;.</action>
            </para>
            <para
>Zie <xref linkend="configuration"/> voor details. </para>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect1
> <!-- Settings Menu -->

<sect1 id="menuwindow"
><title
>Venstermenu</title>
<para
>Het menu <guimenu
>Venster</guimenu
> stelt u in staat om de tabbladen te beheren. Met de items in dit menu kunt u een tabblad hernoemen, toevoegen, het huidige tabblad dupliceren, sluiten en naar links of rechts verplaatsen.</para>

<para
>Door met de &RMB; op een tabblad te klikken opent u een contextmenu, waarin u ook dezelfde acties kunt selecteren.</para>
</sect1>

<sect1 id="menuhelp"
><title
>Menu Help</title>

<para
>Het menu <guimenu
>Help</guimenu
> bevat het standaard &kde;-helpmenu.</para>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="commandline-options"
><title
>Naslag van opties op de commandoregel</title>

<para
>Alleen de opties die specifiek zijn voor &kleopatra; worden hier weergegeven. Zoals met alle &kde;-toepassingen, kunt u een complete lijst met opties krijgen met het commando <userinput
><command
>kleopatra <option
>--help</option
></command
></userinput
>.</para>

<variablelist>

<varlistentry>
<term
><option
>--external</option
></term>
<listitem>
<para
>Alleen UI-server uitvoeren, hoofdvenster verbergen</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-p</option
> <option
>--openpgp</option
></term>
<listitem>
<para
>OpenPGP voor de volgende actie gebruiken</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-c</option
> <option
>--cms</option
></term>
<listitem>
<para
>CMS (X.509, S/MIME) voor de volgende actie gebruiken</para>
</listitem>
</varlistentry>

<varlistentry id="commandline-option-import-certificate">
<term
><option
>-i</option
> <option
>--import-certificate</option
></term>
<listitem>
<para
><action
>Specificeert een bestand of &URL; waar vandaan certificaten (of geheime sleutels) geïmporteerd moeten worden.</action
></para>

<para
>Dit is het equivalent op de commandoregel van <xref linkend="file-import-certificates"/>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-e</option
> <option
>--encrypt</option
></term>
<listitem>
<para
>Bestand(en) versleutelen</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-s</option
> <option
>--sign</option
></term>
<listitem>
<para
>Bestand(en) ondertekenen</para>
</listitem>
</varlistentry>
<!-- comment for 4.5-->
<varlistentry>
<term
><option
>-E</option
> <option
>--encrypt-sign</option
></term>
<listitem>
<para
>Versleutel en/of onderteken bestand(en). Zelfde als <option
>--sign-encrypt</option
>, niet gebruiken</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-d</option
> <option
>--decrypt</option
></term>
<listitem>
<para
>Bestand(en) ontcijferen</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-V</option
> <option
>--verify</option
></term>
<listitem>
<para
>Bestand/ondertekening verifiëren </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><option
>-D</option
> <option
>--decrypt-verify</option
></term>
<listitem>
<para
>Bestand(en) ontcijferen en/of verifiëren</para>
</listitem>
</varlistentry>

</variablelist>

</chapter>

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

    <para
>De dialoog voor instellen van &kleopatra; is toegankelijk via <xref linkend="settings-configure-kleopatra"/>. </para>
    <para
>Elk van zijn pagina's wordt in de secties hieronder beschreven. </para>

    <sect1 id="configuration-directory-services">
      <title
>Directory Services instellen</title>

      <para
>Op deze pagina kunt u instellen welke &ldap;-servers te gebruiken voor het zoeken naar &smime;-certificaten en welke sleutelservers te gebruiken voor zoeken naar &openpgp;-certificaten. </para>
      <note>
        <para
>Dit is eenvoudig een meer gebruikersvriendelijke versie van dezelfde instellingen die u ook vindt in <xref linkend="configuration-gnupg-system"/>. Alles wat u hier in kan stellen, kunt u ook daar instellen. </para>
      </note>
      <note>
        <title
>Een opmerking over Proxy-instellingen</title>
        <para
>Proxy settings can be configured for &http; and &ldap; in <xref linkend="configuration-smime-validation"/>, but only for &gpgsm;. For &gpg;, due to the complexity of keyserver options in &gpg; and lack of proper support for them in &gpgconf;, you currently need to modify the config file <filename
>gpg.conf</filename
> directly. Please refer to the &gpg; manual for details. &kleopatra; will preserve such settings, but does not yet allow to modify them in the &GUI;. </para>
      </note>
      <para
>The <guilabel
>Directory services</guilabel
> table shows which servers are currently configured. Double-click on a cell in the table to change parameters of existing server entries. </para>
      <para
>De betekenis van de kolommen in de tabel is als volgt: </para>
      <variablelist>
        <varlistentry id="configuration-directory-services-scheme">
          <term
><guilabel
>Schema</guilabel
></term
> <!-- linebreak here'd show up in xref text :/ -->
          <listitem>
            <para
>Determines the network protocol which is used to access the server. Often-used schemes include <guilabel
>ldap</guilabel
> (and its &ssl;-secured sibling <guilabel
>ldaps</guilabel
>) for &ldap; servers (common protocol for &smime;; the only one supported by &gpgsm;), and <guilabel
>hkp</guilabel
>, the Horowitz Keyserver Protocol, nowadays usually &http; Keyserver Protocol, a &http;-based protocol that virtually all public &openpgp; keyservers support. </para>
            <para
>Kijk in de handleiding van &gpg; en &gpgsm; voor een lijst van ondersteunde schema's. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-server-name">
          <term
><guilabel
>Servernaam</guilabel
></term>
          <listitem>
            <para
>The domain name of the server, &eg; <systemitem class="systemname"
>keys.gnupg.net</systemitem
>. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-server-port">
          <term
><guilabel
>Poort van server</guilabel
></term>
          <listitem>
            <para
>De netwerkpoort waarop de server luistert. </para>
            <para
>This changes automatically to the default port when you change the <xref linkend="configuration-directory-services-scheme"/>, unless it was set to some non-standard port to begin with. If you changed the default port and cannot get it back, try setting <xref linkend="configuration-directory-services-scheme"/> to <userinput
>http</userinput
> and <xref linkend="configuration-directory-services-server-port"/> to <userinput
>80</userinput
> (the default for &http;), then take it from there. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-base-dn">
          <term
><guilabel
>Base DN</guilabel
></term>
          <listitem>
            <para
>The Base-&dn; (only for &ldap; and &ldaps;), &ie; the root of the &ldap; hierarchy to start from. This is often also called <quote
>search root</quote
> or <quote
>search base</quote
>. </para>
            <para
>It usually looks like <userinput
>c=de,o=Foo</userinput
>, given as part of the &ldap; &URL;. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-user-name">
          <term
><guilabel
>Gebruikersnaam</guilabel
></term>
          <listitem>
            <para
>The user name, if any, to use for logging into the server. </para>
            <para
>This column is only shown if the option <guilabel
>Show user and password information</guilabel
> (below the table) is checked. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-password">
          <term
><guilabel
>Wachtwoord</guilabel
></term>
          <listitem>
            <para
>The password, if any, to use for logging into the server. </para>
            <para
>This column is only shown if the option <guilabel
>Show user and password information</guilabel
> (below the table) is checked. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-x509">
          <term
><guilabel
>X.509</guilabel
></term>
          <listitem>
            <para
>Check this column if this entry should be used for &x509; (&smime;) certificate searches. </para>
            <para
>Only &ldap; (and &ldaps;) servers are supported for &smime;. </para>
          </listitem>
        </varlistentry>
        <varlistentry id="configuration-directory-services-openpgp">
          <term
><guilabel
>OpenPGP</guilabel
></term>
          <listitem>
            <para
>Check this column if this entry should be used for &openpgp; certificate searches. </para>
          </listitem>
        </varlistentry>
      </variablelist>
      <para
>You can configure as many &smime; (&x509;) servers as you want, but only one &openpgp; server is allowed at any time. The &GUI; will enforce this. </para>
      <para
>To add a new server, click on the <guibutton
>New</guibutton
> button. This duplicates the selected entry, if any, or else inserts a default &openpgp; server. Then you can set the <xref linkend="configuration-directory-services-server-name"/>, the <xref linkend="configuration-directory-services-server-port"/>, the <xref linkend="configuration-directory-services-base-dn"/>, and the usual <xref linkend="configuration-directory-services-password"/> and <xref linkend="configuration-directory-services-user-name"/>, both of which are only needed if the server requires authentication. </para>
      <para
>To directly insert an entry for &x509; certificates, use <menuchoice
><guimenu
>New</guimenu
><guimenuitem
>X.509</guimenuitem
></menuchoice
>; use <menuchoice
><guimenu
>New</guimenu
><guimenuitem
>OpenPGP</guimenuitem
></menuchoice
> for &openpgp;. </para>
      <para
>To remove a server from the search list, select it in the list, then press the <guibutton
>Delete</guibutton
> button. </para>
<!-- not in 4.2
<para
>To change the relative search order of servers, select one of
them and move it up or down with the arrow buttons right next to the
list.</para>
-->
      <para
>To set the &ldap; timeout, &ie; the maximum time the backend will wait for a server to respond, simply use the corresponding input field labeled <guilabel
>LDAP timeout (minutes:seconds)</guilabel
>. </para>
      <para
>If one of your servers has a large database, so that even reasonable searches like <userinput
>Smith</userinput
> hit the <guilabel
>maximum number of items returned by query</guilabel
>, you might want to increase this limit. You can find out easily if you hit the limit during a search, since a dialog box will pop up in that case, telling you that the results have been truncated. </para>
      <note>
        <para
>Some servers may impose their own limits on the number of items returned from a query. In this case, increasing the limit here will not result in more returned items. </para>
      </note>
    </sect1>

    <sect1 id="configuration-appearance">
      <title
>Configuring Appearance</title>

      <sect2 id="configuration-appearance-tooltips">
          <title
>Configuring <guilabel
>Tooltips</guilabel
></title>

        <para
>In the main certificate list, &kleopatra; can show details about a certificate in a tooltip. The information displayed is the same as in the <guilabel
>Overview</guilabel
> tab of the <guilabel
>Certificate Details</guilabel
> dialog. Tooltips, however, can be restricted to show only a subset of information for a less verbose experience. </para>
        <note>
          <para
>The <guilabel
>Key-ID</guilabel
> is <emphasis
>always</emphasis
> shown. This is to ensure that tooltips for different certificates do, in fact, differ (this is especially important if only <xref linkend="tooltips-validity"/> has been selected). </para>
        </note>
        <para
>You can independently enable or disable the following information sets: </para>
        <variablelist>
          <varlistentry id="tooltips-validity">
            <term
><guilabel
>Geldigheid tonen</guilabel
></term>
            <listitem>
              <para
>Shows information about the validity of a certificate: its current status, issuer-&dn; (&smime; only), expiry dates (if any) and certificate usage flags. </para>
              <para
>Voorbeeld: <programlisting
><!--
                  -->This certificate is currently valid.
<!--              -->Issuer:            CN=Test-ZS 7,O=Intevation GmbH,C=DE
<!--              -->Validity:          from 25.08.2009 10:42 through 19.10.2010 10:42
<!--              -->Certificate usage: Signing EMails and Files, Encrypting EMails and Files
<!--              -->Key-ID:            DC9D9E43<!--
                  --></programlisting>
              </para>
            </listitem>
          </varlistentry>
          <varlistentry id="tooltips-owner">
            <term
><guilabel
>Eigenaarsinformatie tonen</guilabel
></term>
            <listitem>
              <para
>Shows information about the owner of the certificate: subject-&dn; (&smime; only), user-IDs (including emails addresses) and ownertrust (&openpgp; only). </para>
              <para
>&openpgp; example: <programlisting
><!--
                  -->User-ID:           Gpg4winUserA &lt;gpg4winusera@test.hq&gt;
<!--              -->Key-ID:            C6BF6664
<!--              -->Ownertrust:        ultimate<!--
                  --></programlisting
> &smime; example: <programlisting
><!--
                  -->Subject:           CN=Gpg4winTestuserA,OU=Testlab,O=Gpg4win Project,C=DE
<!--              -->a.k.a.:            Gpg4winUserA@test.hq
<!--              -->Key-ID:            DC9D9E43<!--
                  --></programlisting>
              </para>
            </listitem>
          </varlistentry>
          <varlistentry id="tooltips-details">
            <term
><guilabel
>Technische details tonen</guilabel
></term>
            <listitem>
              <para
>Shows technical information about the certificate: serial number (&smime; only), type, fingerprint and storage location. </para>
              <para
>Voorbeeld: <programlisting
><!--
                  -->Serial Number:     27
<!--              -->Certificate type:  1,024-bit RSA (secret certificate available)
<!--              -->Key-ID:            DC9D9E43
<!--              -->Fingerprint:       854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
<!--              -->Stored:            on this computer<!--
                  --></programlisting>
              </para>
            </listitem>
          </varlistentry>
        </variablelist>

      </sect2>

      <sect2 id="configuration-appearance-certificate-filters">
        <title
><guilabel
>Certificaatcategorieën</guilabel
> instellen</title>

        <para
>&kleopatra; allows you to customize the appearance of certificates in the list view. This includes showing a small icon, but you can also influence the foreground (text) and background colors, as well as the font. </para>
        <para
>Each certificate category in the list is assigned a set of colors, an icon (optional) and a font in which certificates from that category are displayed. The category list also acts as a preview of the settings. Categories can be freely defined by the administrator or the power user, see <xref linkend="admin-key-filters"/> in <xref linkend="admin"/>. </para>
        <para
>To set or change the icon of a category, select it in the list, and press the <guibutton
>Set Icon...</guibutton
> button. The standard &kde; icon selection dialog will appear where you can select an existing icon from the &kde; collection, or load a custom one. </para>
        <para
>To remove an icon again, you need to press the <guibutton
>Default Appearance</guibutton
> button. </para>
        <para
>To change the text (&ie; foreground) color of a category, select it in the list, and press the <guibutton
>Set Text Color...</guibutton
> button. The standard &kde; color selection dialog will appear where you can select an existing color or create a new one. </para>
        <para
>Changing the background color is done in the same way, just press <guibutton
>Set Background Color...</guibutton
> instead. </para>
        <para
>To change the font, you basically have two options: </para>
        <orderedlist>
          <listitem>
            <para
>Modify the standard font, used for all list views in &kde;. </para>
          </listitem>
          <listitem>
            <para
>Use a custom font. </para>
          </listitem>
        </orderedlist>
        <para
>The first option has the advantage that the font will follow whichever style you choose &kde;-wide, whereas the latter gives you full control over the font to use. The choice is yours. </para>
        <para
>To use the modified standard font, select the category in the list, and check or uncheck the font modifiers <guilabel
>Italic</guilabel
>, <guilabel
>Bold</guilabel
>, and/or <guilabel
>Strikeout</guilabel
>. You can immediately see the effect on the font in the category list. </para>
        <para
>To use a custom font, press the <guibutton
>Set Font...</guibutton
> button. The standard &kde; font selection dialog will appear where you can select the new font. </para>
        <note>
          <para
>You can still use the font modifiers to change the custom font, just as for modifying the standard font. </para>
        </note>
        <para
>To switch back to the standard font, you need to press the <guibutton
>Default Appearance</guibutton
> button. </para>

      </sect2>

      <sect2 id="configuration-dn-order">
        <title
>Configuring <guilabel
>DN-Attribute Order</guilabel
></title>

<para
>Although &dn;s are hierarchical, the order of the individual components (called relative &dn;s (RDNs), or &dn; attributes) is not defined. The order in which the attributes are shown is thus a matter of personal taste or company policy, which is why it is configurable in &kleopatra;.</para>

<note
><para
>This setting does not only apply to &kleopatra;, but to all applications using &kleopatra; Technology. At the time of this writing, these include &kmail;, &kaddressbook;, as well as &kleopatra; itself, of course.</para
></note>

<para
>This configuration page basically consists of two lists, one for the known attributes (<guilabel
>Available attributes</guilabel
>), and one describing the <guilabel
>Current attribute order</guilabel
>.</para>

<para
>Both lists contain entries described by the short from of the attribute (&eg; <guilabel
>CN</guilabel
>) as well as the spelled-out form (<guilabel
>Common Name</guilabel
>).</para>

<para
>The <guilabel
>Available attributes</guilabel
> list is always sorted alphabetically, while the <guilabel
>Current attribute order</guilabel
> list's order reflects the configured &dn; attribute order: the first attribute in the list is also the one displayed first.</para>

<para
>Only attributes explicitly listed in the <guilabel
>Current attribute order</guilabel
> list are displayed at all. The rest is hidden by default.</para>

<para
>However, if the placeholder entry <guilabel
>_X_</guilabel
> (<guilabel
>All others</guilabel
>) is in the <quote
>current</quote
> list, all unlisted attributes (whether known or not), are inserted at the point of <guilabel
>_X_</guilabel
>, in their original relative order.</para>

<para
>A small example will help to make this more clear:</para>

<informalexample>
<para
>Given the &dn;</para>
<blockquote>
<para
>O=&kde;, C=US, CN=Dave Devel, X-BAR=foo, OU=&kleopatra;, X-FOO=bar, </para>
</blockquote>
<para
>the default attribute order of <quote
>CN, L, _X_, OU, O, C</quote
> will produce the following formatted &dn;:</para>
<blockquote>
<para
>CN=Dave Devel, X-BAR=foo, X-FOO=bar, OU=&kleopatra;, O=&kde;, C=US </para>
</blockquote>
<para
>while <quote
>CN, L, OU, O, C</quote
> will produce</para>
<blockquote>
<para
>CN=Dave Devel, OU=&kleopatra;, O=&kde;, C=US </para>
</blockquote>
</informalexample>

<para
>To add an attribute to the display order list, select it in the <guilabel
>Available attributes</guilabel
> list, and press the <guilabel
>Add to current attribute order</guilabel
> button.</para>

<para
>To remove an attribute from the display order list, select it in the <guilabel
>Current attribute order</guilabel
> list, and press the <guilabel
>Remove from current attribute order</guilabel
> button.</para>

<para
>To move an attribute to the beginning (end), select it in the <guilabel
>Current attribute order</guilabel
> list, and press the <guilabel
>Move to top</guilabel
> (<guilabel
>Move to bottom</guilabel
>) button.</para>

<para
>To move an attribute up (down) one slot only, select it in the <guilabel
>Current attribute order</guilabel
> list, and press the <guilabel
>Move one up</guilabel
> (<guilabel
>Move one down</guilabel
>) button.</para>

      </sect2>

    </sect1>

    <sect1 id="configuration-crypto-operations">
      <title
>Configuring Crypto Operations</title>

      <sect2 id="configuration-crypto-operations-email">
        <title
>Configuring <guilabel
>EMail Operations</guilabel
></title>

        <para
>Here you can configure some aspects of the email operations of &kleopatra;'s &uiserver;. Currently, you can only configure whether to use <quote
>Quick Mode</quote
> for signing and encrypting emails, respectively. </para>
        <para
>Met <quote
>Snellemodus </quote
>geactiveerd, wordt er geen dialoog getoond bij respectievelijk ondertekening (versleuteling) van e-mails, tenzij er een conflict is dat handmatig oplossen vereist. </para>

      </sect2>

      <sect2 id="configuration-crypto-operations-file">
        <title
><guilabel
>Bestandsbewerkingen</guilabel
> instellen</title>

        <para
>Hier kunt u enkele aspecten van de bestandsbewerkingen van &kleopatra;'s &uiserver; instellen. Op dit moment kunt u alleen het te gebruiken controlesomprogramma voor <command
>CHECKSUM_CREATE_FILES</command
> kiezen. </para>
        <para
>Gebruik <guilabel
>Te gebruiken controlesomprogramma</guilabel
> om te kiezen welk van de geconfigureerde controlesomprogramma 's gebruikt zou moeten worden bij het aanmaken van controlsombestanden. </para>
        <para
>Bij het verifiëren van controlesommen wordt het te gebruiken programma automatisch gevonden, gebaseerd op de gevonden controlesombestanden. </para>
        <note>
          <para
>The administrator and power user can completely define which checksum programs to make available to &kleopatra; through so-called <quote
>Checksum Definitions</quote
> in the config file. See <xref linkend="admin-checksum-definitions"/> in <xref linkend="admin"/> for details. </para>
        </note>

      </sect2>

    </sect1>

    <sect1 id="configuration-smime-validation">
    <!-- keep in sync with section configure-security-smime-validation from kmail configure.docbook
    both apps have the same page in settings-->
      <title
>Aspecten van S/MIME-validatie instellen</title>

      <para
>Op deze pagina kunt u bepaalde aspecten van de validatie van &smime;-certificaten instellen. </para>
      <note>
        <para
>Dit is grotendeels eenvoudig een meer gebruikersvriendelijke versie van dezelfde instellingen die u ook vindt in <xref linkend="configuration-gnupg-system"/>. Alles wat u hier in kan stelen, kunt u ook daar met uitzindering van <xref linkend="configuration-smime-validation-refresh-interval"/>, wat specifiek voor &kleopatra; is. </para>
      </note>
      <para
>De betekenis van de opties is als volgt: </para>

      <sect2 id="configuration-smime-validation-interval-checking">
        <title
>Configuring interval certificate checking</title>

        <variablelist>
          <varlistentry id="configuration-smime-validation-refresh-interval">
            <term
><guilabel
>Geldigheid van certificaat elke <replaceable
>N</replaceable
> uren controleren</guilabel
></term>
            <listitem>
              <para
>This option enables interval checking of certificate validity. You can also choose the checking interval (in hours). The effect of interval checking is the same as <xref linkend="view-redisplay"/>; there is no provision for interval scheduling of <xref linkend="certificates-refresh-openpgp"/> or <xref linkend="certificates-refresh-x509"/>. </para
> 
              <note>
                <para
>Validation is performed implicitly whenever significant files in <filename
>~/.gnupg</filename
> change. This option, just like <xref linkend="certificates-refresh-openpgp"/> and <xref linkend="certificates-refresh-x509"/>, therefore only affects external factors of certificate validity. </para>
              </note>
            </listitem>
          </varlistentry>
        </variablelist>

      </sect2>

      <sect2 id="configuration-smime-validation-method">
        <title
>Validatiemethode instellen</title>

        <variablelist>
          <varlistentry id="configuration-smime-validation-use-crls">
            <term
><guilabel
>Certificaten met CRL's valideren</guilabel
></term>
            <listitem>
              <para
>If this option is selected, &smime; certificates are validated using Certificate Revocation Lists (&crl;s). </para>
              <para
>See <xref linkend="configuration-smime-validation-use-ocsp"/> for alternative method of certificate validity checking. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-use-ocsp">
            <term
><guilabel
>Certificaten online valideren (OCSP)</guilabel
></term>
            <listitem>
              <para
>If this option is selected, &smime; certificates are validated online using the Online Certificates Status Protocol (&ocsp;). </para>
              <warning>
                <para
>When choosing this method, a request is sent to the server of the &ca; more or less each time you send or receive a cryptographic message, thus theoretically allowing the certificate issuing agency to track whom you exchange (&eg;) mails with. </para>
              </warning>
              <para
>To use this method, you need to enter the &URL; of the &ocsp; responder into <xref linkend="configuration-smime-validation-ocsp-url"/>. </para>
              <para
>See <xref linkend="configuration-smime-validation-use-ocsp"/> for a more traditional method of certificate validity checking that does not leak information about whom you exchange messages with. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-ocsp-url">
            <term
><guilabel
>URL-adres OCSP-dienst</guilabel
></term>
            <listitem>
              <para
>Voer hier het adres in van de server die de certificaten online valideert (&ocsp;-dienst). Het &URL;-adres begint doorgaans met <literal
>http://</literal
>. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-ocsp-signature">
            <term
><guilabel
>Handtekening OCSP-dienst</guilabel
></term>
            <listitem>
              <para
>Hier het certificaat kiezen waarmee de &ocsp;-server zijn antwoorden ondertekend. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-ocsp-ignore-service-url">
            <term
><guilabel
>Service-URL van certificaten negeren</guilabel
></term>
            <listitem>
              <para
>Each &smime; certificate usually contains the &URL; of its issuer's &ocsp; responder (<xref linkend="certificates-dump-certificate"/> will reveal whether a given certificate contains it). </para>
              <para
>Checking this option makes &gpgsm; ignore those &URL;s and only use the one configured above. </para>
              <para
>Dit &eg; gebruiken om het gebruik van een organisatie-brede &ocsp; proxy af te dwingen. </para>
            </listitem>
          </varlistentry>

        </variablelist>

      </sect2>

      <sect2 id="configuration-smime-validation-options">
        <title
>Validatieopties instellen</title>

        <variablelist>
          <varlistentry id="configuration-smime-validation-dont-check-cert-policy">
            <term
><guilabel
>Certificaatbeleid niet controleren</guilabel
></term>
            <listitem>
              <para
>By default, &gpgsm; uses the file <filename
>~/.gnupg/policies.txt</filename
> to check if a certificate policy is allowed. If this option is selected, policies are not checked. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-never-consult-crl">
            <term
><guilabel
>Nooit een CRL raadplegen</guilabel
></term>
            <listitem>
              <para
>Als deze optie ingeschakeld is, worden Certificate Revocation Lists nooit gebruikt om &smime;-certificaten te valideren. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-allow-mark-trusted">
            <term
><guilabel
>Sta toe om het hoofdcertificaat als vertrouwd te markeren</guilabel
></term>
            <listitem>
            <para
>If this option is checked while a root &ca; certificate is being imported, you will be asked to confirm its fingerprint and to state whether or not you consider this root certificate to be trusted. </para>
              <para
>A root certificate needs to be trusted before the certificates it certified become trusted, but lightly allowing trusted root certificates into your certificate store will undermine the security of the system. </para>
              <note>
                <para
>Enabling this functionality in the backend can lead to popups from &pinentry; at inopportune times (&eg; when verifying signatures), and can thus block unattended email processing. For that reason, and because it is desirable to be able to <emphasis
>distrust</emphasis
> a trusted root certificate again, &kleopatra; allows manual setting of trust using <xref linkend="certificates-trust-root"/> and <xref linkend="certificates-distrust-root"/>. </para>
                <para
>This setting here does not influence the &kleopatra; function. </para>
              </note>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-fetch-missing-issuers">
            <term
><guilabel
>Ontbrekende uitgevercertificaten ophalen</guilabel
></term>
            <listitem>
              <para
>If this option is checked, missing issuer certificates are fetched when necessary (this applies to both validation methods, &crl;s and &ocsp;). </para>
            </listitem>
          </varlistentry>
        </variablelist>

      </sect2>

      <sect2 id="configuration-smime-validation-http-options">
        <title
>Configuring &http; request options</title>

        <variablelist>
          <varlistentry id="configuration-smime-validation-disable-http">
            <term
><guilabel
>Geen HTTP-verzoeken uitvoeren</guilabel
></term>
            <listitem>
              <para
>Schakelt het gebruik van &http; voor &smime; geheel uit. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-ignore-http-dp">
            <term
><guilabel
>HTTP CRL-distributiepunt van certificaten negeren</guilabel
></term>
            <listitem>
              <para
>When looking for the location of a &crl;, the to-be-tested certificate usually contains what are known as <quote
>&crl; Distribution Point</quote
> (<acronym
>DP</acronym
>) entries, which are &URL;s describing the way to access the &crl;. The first-found <acronym
>DP</acronym
> entry is used. </para>
              <para
>With this option, all entries using the &http; scheme are ignored when looking for a suitable <acronym
>DP</acronym
>. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-honor-http-proxy">
            <term
><guilabel
>HTTP-proxy van systeem gebruiken</guilabel
></term>
            <listitem>
              <para
>Wanneer deze optie is geselecteerd zal de &http;-proxy, die rechts wordt getoond, gebruikt worden bij elk &http;-verzoek. (De waarde hiervan komt uit de omgevingsvariabele <envar
>http_proxy</envar
>). </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-custom-http-proxy">
            <term
><guilabel
>Deze proxy voor HTTP-verzoeken gebruiken</guilabel
></term>
            <listitem>
              <para
>If no system proxy is set, or you need to use a different proxy for &gpgsm;, you can enter its location here. </para>
              <para
>It will be used for all HTTP requests relating to S/MIME. </para>
              <para
>The syntax is <userinput
><replaceable
>host</replaceable
><literal
>:</literal
><replaceable
>port</replaceable
></userinput
>, &eg; <userinput
>myproxy.nowhere.com:3128</userinput
>. </para>
            </listitem>
          </varlistentry>
        </variablelist>

      </sect2>

      <sect2 id="configuration-smime-validation-ldap-options">
        <title
>Configuring &ldap; request options</title>

        <variablelist>
          <varlistentry id="configuration-smime-validation-disable-ldap">
            <term
><guilabel
>Geen LDAP-verzoeken uitvoeren</guilabel
></term>
            <listitem>
              <para
>Schakelt het gebruik van &ldap; voor &smime; geheel uit. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-ignore-ldap-dp">
            <term
><guilabel
>LDAP CRL-distributiepunt van certificaten negeren</guilabel
></term>
            <listitem>
              <para
>When looking for the location of a &crl;, the to-be-tested certificate usually contains what are known as "&crl; Distribution Point" (<acronym
>DP</acronym
>) entries, which are &URL;s describing the way to access the &crl;. The first found <acronym
>DP</acronym
> entry is used. </para>
              <para
>With this option, all entries using the &ldap; scheme are ignored when looking for a suitable <acronym
>DP</acronym
>. </para>
            </listitem>
          </varlistentry>
          <varlistentry id="configuration-smime-validation-custom-ldap-proxy">
            <term
><guilabel
>Primaire host voor LDAP-verzoeken</guilabel
></term>
            <listitem>
              <para
>Entering an &ldap; server here will make all &ldap; requests go to that server first. More precisely, this setting overrides any specified <replaceable
>host</replaceable
> and <replaceable
>port</replaceable
> part in an &ldap; &URL; and will also be used if <replaceable
>host</replaceable
> and <replaceable
>port</replaceable
> have been omitted from the &URL;. </para>
              <para
>Other &ldap; servers will be used only if the connection to the <quote
>proxy</quote
> failed. The syntax is <userinput
><replaceable
>host</replaceable
></userinput
> or <userinput
><replaceable
>host</replaceable
><literal
>:</literal
><replaceable
>port</replaceable
></userinput
>. If <replaceable
>port</replaceable
> is omitted, port 389 (standard &ldap; port) is used. </para>
            </listitem>
          </varlistentry>
        </variablelist>

      </sect2>

    </sect1>

    <sect1 id="configuration-gnupg-system">
    <!-- kleopatra + kmail have the this page in settings-->

      <title
>Configuring the GnuPG System</title>

      <para
>This part of the dialog is auto-generated from the output of <command
>gpgconf <option
>--list-components</option
></command
> and, for each <replaceable
>component</replaceable
> that the above command returns, the output of <command
>gpgconf <option
>--list-options</option
> <replaceable
>component</replaceable
></command
>. </para>
      <note>
        <para
>The most useful of these options have been duplicated as separate pages in the &kleopatra; config dialog. See <xref linkend="configuration-directory-services"/> and <xref linkend="configuration-smime-validation"/> for the two dialog pages which contain selected options from this part of the dialog. </para>
      </note>
      <para
>The exact content of this part of the dialog depends on the version of the &gnupg; backend you have installed and, potentially, the platform you run on. Thus, we will only discuss the general layout of the dialog, including the mapping from &gpgconf; option to &kleopatra; &GUI; control. </para>
      <para
>&gpgconf; returns configuration information for multiple components. Inside each component, individual options are combined into groups. </para>
      <para
>&kleopatra; displays one tab per component reported by &gpgconf;; groups are headed by a horizontal line displaying the group name as returned from &gpgconf;. </para>
      <para
>Each &gpgconf; option has a type. Except for certain well-known options which &kleopatra; backs with specialised controls for a better user experience, the mapping between &gpgconf; types and &kleopatra; controls is as follows: </para>
      <table id="table-gpgconf-types">
	<title
>Mapping From &gpgconf; Types To &GUI; Controls</title>
	<tgroup cols="3">
          <colspec colname="type"/>
	  <colspec colname="lists" align="center"/>
          <colspec colname="non-lists" align="center"/>
	  <thead>
	    <row>
	      <entry morerows="1"
>&gpgconf; type</entry>
              <entry namest="lists" nameend="non-lists"
>Besturing van &kleopatra;</entry>
            </row>
            <row>
	      <entry
>voor lijsten</entry>
	      <entry
>for non-lists</entry>
	    </row>
	  </thead>
	  <!--tfoot/-->
	  <tbody>
	    <row>
	      <entry
><literal
>geen</literal
></entry>
	      <entry
>Spinbox (<quote
>count</quote
>-semantics)</entry>
	      <entry
>Keuzevakje</entry>
	    </row>
            <row>
              <entry
><literal
>tekenreeks</literal
></entry>
              <entry
>&NA;</entry>
              <entry
>Lineedit</entry>
            </row>
            <row>
              <entry
><literal
>int32</literal
></entry>
              <entry morerows="1"
>Lineedit (unformatted)</entry>
              <entry morerows="1"
>Draaiveld</entry>
            </row>
            <row>
              <entry
><literal
>uint32</literal
></entry>
            </row>
            <row>
              <entry
><literal
>pathname</literal
></entry>
              <entry
>&NA;</entry>
              <entry
>specialised control</entry>
            </row>
            <row>
              <entry
><literal
>LDAP-server</literal
></entry>
              <entry
>specialised control</entry>
              <entry
>&NA;</entry>
            </row>
            <row>
              <entry
><literal
>key fingerprint</literal
></entry>
              <entry morerows="3" namest="lists" nameend="non-lists"
>&NA;</entry>
            </row>
            <row>
              <entry
><literal
>pub key</literal
></entry>
            </row>
            <row>
              <entry
><literal
>sec key</literal
></entry>
            </row>
            <row>
              <entry
><literal
>alias list</literal
></entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para
>See the &gpgconf; manual for more information about what you can configure here, and how. </para>

    </sect1>

</chapter>

<chapter id="admin"
><title
>Administrator's Guide</title>

<para
>This Administrator's Guide describes ways to customize &kleopatra; that are not accessible via the &GUI;, but only via config files.</para>

<para
>It is assumed that the reader is familiar with the technology used for &kde; application configuration, including layout, file system location and cascading of &kde; config files, as well as the KIOSK framework.</para>

<sect1 id="admin-certificate-request-wizard"
><title
>Customization of the Certificate-Creation Wizard</title>

<sect2 id="admin-certificate-request-wizard-dn"
><title
>Customizing the DN fields</title>

<para
>&kleopatra; allows you to customize the fields that the user is allowed to enter in order to create their certificate.</para>

<para
>Create a group called <literal
>CertificateCreationWizard</literal
> in the system-wide <filename
>kleopatrarc</filename
>. If you want a custom order of attributes or if you only want certain items to appear, create a key called <varname
>DNAttributeOrder</varname
>. The argument is one or more of <varname
>CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL</varname
> If you want to initialize fields with a certain value, write something like Attribute=value. If you want the attribute to be treated as a required one, append an exclamation mark (e.g. <varname
>CN!,L,OU,O!,C!,EMAIL!</varname
>, which happens to be the default configuration).</para>

<para
>Using the <acronym
>KIOSK</acronym
> mode modifier <varname
>$e</varname
> allows to retrieve the values from environment variables or from an evaluated script or binary. If you want to disallow editing of the respective field in addition, use the modifier <varname
>$i</varname
>. If you want to disallow the use <guibutton
>Insert My Address</guibutton
> button, set <varname
>ShowSetWhoAmI</varname
> to false.</para>

<tip
><para
>Due to the nature of the &kde; <acronym
>KIOSK</acronym
> framework, using the immutable flag (<varname
>$i</varname
>) makes it impossible for the user to override the flag. This is intended behavior. <varname
>$i</varname
> and <varname
>$e</varname
> can be used with all other config keys in &kde; applications as well.</para
></tip>

<para
>The following example outlines possible customizations:</para>

<para>
<programlisting
>[CertificateCreationWizard] 
;Disallow to copy personal data from the addressbook, do not allow local override
ShowSetWhoAmI[$i]=false

;sets the user name to $USER
CN[$e]=$USER

;sets the company name to "My Company", disallows editing
O[$i]=My Company

;sets the department name to a value returned by a script
OU[$ei]=$(lookup_dept_from_ip)

; sets country to DE, but allows for changes by the user
C=DE
</programlisting>
</para>

</sect2>

      <sect2 id="admin-certificate-request-wizard-keys">

        <title
>Restricting the Types of Keys a User is Allowed to Create</title>

        <para
>&kleopatra; also allows to restrict which type of certificates a user is allowed to create. Note, however, that an easy way around these restrictions is to just create one on the command line. </para>

        <sect3 id="admin-certificate-request-wizard-keys-type">

          <title
>Public Key Algorithms</title>

          <para
>To restrict the public key algorithm to use, add the config key <varname
>PGPKeyType</varname
> (and <varname
>CMSKeyType</varname
>, but only <acronym
>RSA</acronym
> is supported for <acronym
>CMS</acronym
> anyway) to the <literal
>CertificateCreationWizard</literal
> section of <filename
>kleopatrarc</filename
>. </para>

          <para
>The allowed values are <literal
>RSA</literal
> for <acronym
>RSA</acronym
> keys, <literal
>DAS</literal
> for <acronym
>DSA</acronym
> (sign-only) keys, and <literal
>DSA+ELG</literal
> for a <acronym
>DSA</acronym
> (sign-only) key with an Elgamal subkey for encryption. </para>

          <para
>The default is read from &gpgconf; or else <literal
>RSA</literal
> if &gpgconf; doesn't provide a default. </para>

        </sect3>

        <sect3 id="admin-certificate-request-wizard-keys-size">

          <title
>Public Key Size</title>

          <para
>To restrict the available keys sizes for a public algorithm, add the config key <varname
><replaceable
>&lt;ALG&gt;</replaceable
>KeySizes</varname
> (where <replaceable
>ALG</replaceable
> may be <literal
>RSA</literal
>, <literal
>DSA</literal
> or <literal
>ELG</literal
>) to the <literal
>CertificateCreationWizard</literal
> section of <filename
>kleopatrarc</filename
>, containing a comma-separated list of keysizes (in bits). A default may be indicated by prefixing the keysize with a hyphen (<literal
>-</literal
>). </para>

          <para>
            <programlisting
>RSAKeySizes = 1536,-2048,3072
            </programlisting>
          </para>
              

          <para
>The above would restrict allowed <acronym
>RSA</acronym
> key sizes to 1536, 2048 and 3072, with 2048 the default. </para>

          <para
>In addition to the sizes themselves, you may also specify labels for each of the sizes. Simply set the config key <varname
><replaceable
>ALG</replaceable
>KeySizeLabels</varname
> to a comma-separated list of labels. </para>

          <para>
            <programlisting
>RSAKeySizeLabels = weak,normal,strong
            </programlisting>
          </para>

          <para
>The above, in connection with the previous example, would print something like the following options for selection: <programlisting
>weak (1536 bits)
              normal (2048 bits)
              strong (3072 bits)
            </programlisting>
          </para>

          <para
>The defaults are as if the following was in effect: <programlisting
>RSAKeySizes = 1536,-2048,3072,4096
              RSAKeySizeLabels =
              DSAKeySizes = -1024,2048
              DSAKeySizeLabels = v1,v2
              ELGKeySizes = 1536,-2048,3072,4096
            </programlisting>
          </para>

        </sect3>

      </sect2>

    </sect1>

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

      <title
>Creating and Editing Key Categories</title>

      <para
>&kleopatra; allows the user to configure the <link linkend="configuration-appearance-certificate-filters"
>visual appearance</link
> of keys based on a concept called <guilabel
>Key Categories</guilabel
>. <guilabel
>Key Categories</guilabel
> are also used to filter the list of certificates. This section describes how you can edit the available categories and add new ones. </para>

      <para
>When trying to find the category a key belongs to, &kleopatra; tries to match the key to a sequence of key filters, configured in the <filename
>libkleopatrarc</filename
>. The first one to match defines the category, based on a concept of <emphasis
>specificity</emphasis
>, explained further below. </para>

      <para
>Each key filter is defined in a config group named <literal
>Key Filter #<replaceable
>n</replaceable
></literal
>, where <replaceable
>n</replaceable
> is a number, starting from <literal
>0</literal
>. </para>

      <para
>The only mandatory keys in a <literal
>Key Filter #<replaceable
>n</replaceable
></literal
> group are <varname
>Name</varname
>, containing the name of the category as displayed in the <link linkend="configuration-appearance-certificate-filters"
>config dialog</link
>, and <varname
>id</varname
>, which is used as a reference for the filter in other configuration sections (such as <literal
>View #<replaceable
>n</replaceable
></literal
>). </para>

      <para
><xref linkend="table-key-filters-appearance"/> lists all keys that define the display properties of keys belonging to that category (&ie; those keys that can be adjusted in the <link linkend="configuration-appearance-certificate-filters"
>config dialog</link
>), whereas <xref linkend="table-key-filters-criteria"/> lists all keys that define the criteria the filter matches keys against. </para>

      <table id="table-key-filters-appearance">
	<title
>Key-Filter Configuration Keys Defining Display Properties</title>
	<tgroup cols="3">
	  <colspec colnum="2" align="center"/>
	  <thead>
	    <row>
	      <entry
>Config Key</entry>
	      <entry
>Type</entry>
	      <entry
>Beschrijving</entry>
	    </row>
	  </thead>
	  <!--tfoot/-->
	  <tbody>
	    <row>
	      <entry
><varname
>achtergrondkleur</varname
></entry>
	      <entry
>kleur</entry>
	      <entry
>The background color to use. If missing, defaults to whichever background color is defined globally for list views. </entry>
	    </row>
	    <row>
	      <entry
><varname
>voorgrondkleur</varname
></entry>
	      <entry
>kleur</entry>
	      <entry
>The foreground color to use. If missing, defaults to whichever foreground color is defined globally for list views. </entry>
	    </row>
	    <row>
	      <entry
><varname
>lettertype</varname
></entry>
	      <entry
>lettertype</entry>
	      <entry
>The custom font to use. The font will be scaled to the size configured for list views, and any font attributes (see below) will be applied. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-bold</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>If set to <literal
>true</literal
> and <varname
>font</varname
> is not set, uses the default list view font with bold font style added (if available). Ignored if <varname
>font</varname
> is also present. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-italic</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>Analogous to <varname
>font-bold</varname
>, but for italic font style instead of bold. </entry>
	    </row>
	    <row>
	      <entry
><varname
>font-strikeout</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>If <literal
>true</literal
>, draws a centered line over the font. Applied even if <varname
>font</varname
> is set. </entry>
	    </row>
	    <row>
	      <entry
><varname
>pictogram</varname
></entry>
	      <entry
>tekst</entry>
	      <entry
>The name of an icon to show in the first column. Not yet implemented. </entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>

      <table id="table-key-filters-criteria">
	<title
>Key-Filter Configuration Keys Defining Filter Criteria</title>
	<tgroup cols="3">
	  <colspec colnum="2" align="center"/>
	  <thead>
	    <row>
	      <entry
>Config Key</entry>
	      <entry
>Type</entry>
	      <entry
>If specified, filter matches when...</entry>
	    </row>
	  </thead>
	  <!--tfoot/-->
	  <tbody>
	    <row>
	      <entry
><varname
>is-revoked</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>de sleutel is teruggetrokken.</entry>
	    </row>
	    <row>
	      <entry
><varname
>match-context</varname
></entry>
	      <entry
>context<footnote
> <para
>Context is an enumeration with the following allowed values: <literal
>appearance</literal
>, <literal
>filtering</literal
> and <literal
>any</literal
>. </para>
                </footnote>
              </entry>
	      <entry
>the context in which this filter matches.</entry>
	    </row>
	    <row>
	      <entry
><varname
>is-expired</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>de sleutel is verlopen.</entry>
	    </row>
	    <row>
	      <entry
><varname
>is-uitgeschakeld</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key has been disabled (marked for not using) by the user. Ignored for &smime; keys. </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-root-certificate</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key is a root certificate. Ignored for OpenPGP keys. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-encrypt</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key can be used for encryption. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-sign</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key can be used for signing. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-certify</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key can be used for signing (certifying) other keys. </entry>
	    </row>
	    <row>
	      <entry
><varname
>can-authenticate</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key can be used for authentication (&eg; as an <acronym
>TLS</acronym
> client certificate). </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-qualified</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key can be used to make Qualified Signatures (as defined by the German Digital Signature Law). </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-cardkey</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key material is stored on a smartcard (instead of on the computer). </entry>
	    </row>
	    <row>
	      <entry
><varname
>has-secret-key</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the secret key for this key pair is available. </entry>
	    </row>
	    <row>
	      <entry
><varname
>is-openpgp-key</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key is an OpenPGP key (<literal
>true</literal
>), or an &smime; key (<literal
>false</literal
>). </entry>
	    </row>
	    <row>
	      <entry
><varname
>was-validated</varname
></entry>
	      <entry
>boolean</entry>
	      <entry
>the key has been validated. </entry>
	    </row>
	    <row>
	      <entry
><varname
><replaceable
>prefix</replaceable
>-ownertrust</varname
></entry>
	      <entry
>geldigheid<footnote
> <para
>Validity is an (ordered) enumeration with the following allowed values: <literal
>unknown</literal
>, <literal
>undefined</literal
>, <literal
>never</literal
>, <literal
>marginal</literal
>, <literal
>full</literal
>, <literal
>ultimate</literal
>. See the &gpg; and &gpgsm; manuals for a detailed explanation. </para>
		</footnote>
	      </entry>
	      <entry
>the key has exactly (<replaceable
>prefix</replaceable
>&nbsp;=&nbsp;<literal
>is</literal
>), has anything but (<replaceable
>prefix</replaceable
>&nbsp;=&nbsp;<literal
>is-not</literal
>), has at least (<replaceable
>prefix</replaceable
>&nbsp;=&nbsp;<literal
>is-at-least</literal
>), or has at most (<replaceable
>prefix</replaceable
>&nbsp;=&nbsp;<literal
>is-at-most</literal
>) the ownertrust given as the value of the config key. If more than one <varname
><replaceable
>prefix</replaceable
>-ownertrust</varname
> keys (with different <replaceable
>prefix</replaceable
> values) are present in a single group, the behavior is undefined. </entry>
	    </row>
	    <row>
	      <entry
><varname
><replaceable
>prefix</replaceable
>-validity</varname
></entry>
	      <entry
>geldigheid</entry>
	      <entry
>Analogous to <varname
><replaceable
>prefix</replaceable
>-ownertrust</varname
>, but for key validity instead of ownertrust. </entry>
	    </row>
	  </tbody>
	</tgroup>
      </table>

      <note>
	<para
>Some of the more interesting criteria, such as <varname
>is-revoked</varname
> or <varname
>is-expired</varname
> will only work on <emphasis
>validated</emphasis
> keys, which is why, by default, only validated keys are checked for revocation and expiration, although you are free to remove these extra checks. </para>
      </note>

      <para
>In addition to the config keys listed above, a key filter may also have an <varname
>id</varname
> and <varname
>match-contexts</varname
>. </para>

      <para
>Using the filter's <varname
>id</varname
>, which defaults to the filter's config group name if not given or empty, you can reference the key filter elsewhere in the configuration, &eg; in &kleopatra;'s View configurations. The <varname
>id</varname
> is not interpreted by &kleopatra;, so you can use any string you like, as long as it's unique. </para>

      <para
>The <varname
>match-contexts</varname
> limits the applicability of the filter. Two contexts are currently defined: The <literal
>appearance</literal
> context is used when defining coloring and font properties for the views. The <literal
>filtering</literal
> context is used to selectively include (and exclude) certificate from views. <literal
>any</literal
> can be used to signify all currently defined contexts, and is the default if <varname
>match-contexts</varname
> is not given, or otherwise produces no contexts. This ensures that no key filter can end up <quote
>dead</quote
>, &ie; with no contexts to apply it in. </para>

      <para
>The format of the entry is a list of tokens, separated by non-word characters. Each of the tokens is optionally prefixed by an exclamation point (<literal
>!</literal
>), indicating negation. The tokens act in order on an internal list of contexts, which starts out empty. This is best explained by an example: <literal
>any !appearance</literal
> is the same as <literal
>filtering</literal
>, and <literal
>appearance !appearance</literal
> is producing the empty set, as is <literal
>!any</literal
>. However, the last two will be internally replaced by <literal
>any</literal
>, since they produce no contexts at all. </para>

      <para
>In general, criteria not specified (&ie; the config entry is not set) are not checked for. If a criterion is given, it is checked for and must match for the filter as a whole to match, &ie; the criteria are AND'ed together. </para>

      <para
>Each filter has an implied <quote
>specificity</quote
> that is used to rank all matching filters. The more specific filter wins over less specific ones. If two filters have the same specificity, the one that comes first in the config file wins. A filter's specificity is proportional to the number of criteria it contains. </para>

      <example>
	<title
>Examples of key filters</title>
	<para
>To check for all expired, but non-revoked root certificates, you would use a key filter defined as follows: </para>
<!-- isn't there a better way to not indent this in the output??? -->
	<screen
><!--
-->[Key Filter #<replaceable>n</replaceable>]
Name=expired, but not revoked
was-validated=true
is-expired=true
is-revoked=false
is-root-certificate=true
; ( specificity 4 )<!--
     --></screen>
	<para
>To check for all disabled OpenPGP keys (not yet supported by &kleopatra;) with ownertrust of at least <quote
>marginal</quote
>, you would use: </para>
	<screen
><!--
-->[Key Filter #<replaceable>n</replaceable>]
Name=disabled OpenPGP keys with marginal or better ownertrust
is-openpgp=true
is-disabled=true
is-at-least-ownertrust=marginal
; ( specificity 3 )<!--
     --></screen>
      </example>

    </sect1>

    <sect1 id="admin-archive-definitions">

      <title
>Configuring Archivers for Use with Sign/Encrypt Files</title>

      <para
>&kleopatra; allows the administrator (and power-user) to configure the list of archivers that are presented in the Sign/Encrypt Files dialog. </para>

      <para
>Each archiver is defined in <filename
>libkleopatrarc</filename
> as a separate <literal
>Archive&nbsp;Definition&nbsp;#<replaceable
>n</replaceable
></literal
> group, with the following mandatory keys: </para>

      <variablelist>

        <varlistentry id="archive-definition-extensions">
          <term
><literal
>extensies</literal
></term>
          <listitem>
            <para
>A comma-separated list of filename extensions that usually indicate this archive format. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="archive-definition-id">
          <term
><literal
>id</literal
></term>
          <listitem>
            <para
>A unique ID used to identify this archiver internally. If in doubt, use the name of the command. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="archive-definition-Name">
          <term
><literal
>Name</literal
> (translated)</term>
          <listitem>
            <para
>The user-visible name of this archiver, as shown in the corresponding drop-down menu of the Sign/Encrypt Files dialog. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="archive-definition-pack-command">
          <term
><literal
>pack-command</literal
></term>
          <listitem>
            <para
>The actual command to archive files. You can use any command, as long as no shell is required to execute it. The program file is looked up using the <envar
>PATH</envar
> environment variable, unless you use an absolute file path. Quoting is supported as if a shell was used: <programlisting
>pack-command="/opt/ZIP v2.32/bin/zip" -r -</programlisting>
            </para>
          </listitem>
        </varlistentry>

      </variablelist>

      <note id="backslashes-in-config-keys">
        <para
>Since backslash (<literal
>\</literal
>) is an escape character in KDE config files, you need to double them when they appear in path names: <programlisting
>pack-command=C:\\Programs\\GNU\\tar\\gtar.exe&nbsp;...</programlisting
> However, for the command itself (as opposed to its arguments), you may just use forward slashes (<literal
>/</literal
>) as path separators on all platforms: <programlisting
>pack-command=C:/Programs/GNU/tar/gtar.exe&nbsp;...</programlisting
> This is not supported in arguments, as most Windows programs use the forward slash for options. For example, the following will not work, since <literal
>C:/myarchivescript.bat</literal
> is an argument to <command
>cmd.exe</command
>, and <literal
>/</literal
> is not converted to <literal
>\</literal
> in arguments, only commands: <programlisting
>pack-command=cmd.exe C:/myarchivescript.bat</programlisting
> This needs, instead, to be written as: <programlisting
>pack-command=cmd.exe C:\\myarchivescript.bat</programlisting>
        </para>
      </note>

      <sect2 id="admin-archive-definitions-filename-passing">

      <title
>Input Filename Passing for <literal
>pack-command</literal
></title>

      <para
>There are three ways to pass filenames to the pack command. For each of these, <literal
>pack-command</literal
> provides a particular syntax: </para>

      <orderedlist>

        <listitem>
          <para
>As command-line arguments.</para>
            <para
>Example (tar): <programlisting
>pack-command=tar cf -</programlisting
> Example (zip): <programlisting
>pack-command=zip -r - %f</programlisting
> In this case, filenames are passed on the command line, just like you would when using the command prompt. &kleopatra; does not use a shell to execute the command. Therefore, this is a safe way of passing filenames, but it might run into command line length restrictions on some platforms. A literal <literal
>%f</literal
>, if present, is replaced by the names of the files to archive. Otherwise, filenames are appended to the command line. Thus, the zip Example above could equivalently be written like this: <programlisting
>pack-command=zip -r -</programlisting>
            </para>
        </listitem>

        <listitem>
          <para
>Via standard-in, separated by newlines: prepend <literal
>|</literal
>.</para>
            <para
>Example (GNU-tar): <programlisting
>pack-command=|gtar cf - -T-</programlisting
> Example (ZIP): <programlisting
>pack-command=|zip -@ -</programlisting
> In this case, filenames are passed to the archiver on <acronym
>stdin</acronym
>, one per line. This avoids problems on platforms which place a low limit on the number of command line arguments that are allowed, but fails when filenames, in fact, contain newlines. </para>
            <note>
              <para
>&kleopatra; currently only supports <acronym
>LF</acronym
> as a newline separator, not <acronym
>CRLF</acronym
>. This might change in future versions, based on user feedback. </para>
            </note>
        </listitem>

        <listitem>
          <para
>Via standard-in, separated by NUL-bytes: prepend <literal
>0|</literal
>.</para>
            <para
>Example (GNU-tar): <programlisting
>pack-command=0|gtar cf - -T- --null</programlisting
> This is the same as above, except that NUL bytes are used to separate filenames. Since NUL bytes are forbidden in filenames, this is the most robust way of passing filenames, but not all archivers support it. </para>
        </listitem>

      </orderedlist>

      </sect2
> <!-- Input Filename Passing for pack-command -->

    </sect1
> <!-- Archive Definitions -->

    <sect1 id="admin-checksum-definitions">

      <title
>Configuring Checksum Programs for Use with Create/Verify Checksums</title>

      <para
>&kleopatra; allows the administrator (and power-user) to configure the list of checksum programs that the user can choose from in the config dialog and that &kleopatra; is able to auto-detect when asked to verify a given file's checksum. </para>

      <note>
        <para
>To be usable by &kleopatra;, output of checksum programs (both the written checksum file, as well as the output on <acronym
>stdout</acronym
> when verifying checksums) needs to be compatible with <acronym
>GNU</acronym
> <command
>md5sum</command
> and <command
>sha1sum</command
>. </para>

        <para
>Specifically, the checksum file needs to be line-based with each line having the following format: <programlisting
><replaceable>CHECKSUM</replaceable> ' ' ( ' ' | '*' ) <replaceable>FILENAME</replaceable></programlisting
> where <replaceable
>CHECKSUM</replaceable
> consists of hex-characters only. If <replaceable
>FILENAME</replaceable
> contains a newline character, the line must instead read: <programlisting
>\<replaceable>CHECKSUM</replaceable> ' ' ( ' ' | '*' ) <replaceable>ESCAPED-FILENAME</replaceable></programlisting
> where <replaceable
>ESCAPED-FILENAME</replaceable
> is the filename with newlines replaced by <literal
>\n</literal
>s, and backslashes doubled (<literal
>\</literal
>&#x21A6;<literal
>\\</literal
>). </para>

        <para
>Similarly, the output of <xref linkend="checksum-definition-verify-command"/> must be of the form <programlisting
><replaceable>FILENAME</replaceable> ( ': OK' | ': FAILED' )</programlisting
> separated by newlines. Newlines and other characters are <emphasis
>not</emphasis
> escaped in the output.<footnote
> <para
>Ja, deze programma's zijn niet geschreven met een grafisch frontend in gedachten, zodat het &kleopatra; niet zal lukken om op de juiste manier pathologische bestandsnamen die ":&nbsp;OK" plus nieuwe-regel bevatten, te gebruiken. </para>
          </footnote>
        </para>
      </note>

      <para
>Elk programma voor controlesommen is gedefinieerd in <filename
> libkleopatrarc</filename
> als een aparte <literal
>Checksum&nbsp;Definition&nbsp;#<replaceable
>n</replaceable
></literal
> groep, met de volgende verplichte elementen: </para>

      <variablelist>

        <varlistentry id="checksum-definition-file-patterns">
          <term
><literal
>bestandspatronen</literal
></term>
          <listitem>
            <para
>Een lijst met reguliere expressies die beschrijven welke bestanden beschouwd zouden moeten worden als controlesombestanden voor dit programma voor controlesommen. De syntaxis is die voor lijsten tekenreeksen in KDE configuratiebestanden. <note
> <para
> Omdat reguliere expressies gewoonlijk backslashes bevatten, moet zorgvuldig omgegaan worden met het juiste gebruik van escapes in het configuratiebestand. Het gebruik van een bewerkingshulpmiddel voor een configuratiebestand wordt aangeraden. </para
> </note
> Het platform definieert of de patronen behandeld worden met of zonder onderscheid tussen hoofd- en kleine letter. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="checksum-definition-output-file">
          <term
><literal
>uitvoerbestand</literal
></term>
          <listitem>
            <para
>De typische naam van het uitvoerbestand voor dit programma voor controlesommen (zou natuurlijk overeen moeten komen met een van de <xref linkend="checksum-definition-file-patterns"/>). Dit is wat &kleopatra; zal gebruiken als de uitvoerbestandsnaam bij het aanmaken van bestanden met controlesommen van dit type. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="checksum-definition-id">
          <term
><literal
>id</literal
></term>
          <listitem>
            <para
>Een unieke ID gebruikt om dit programma voor controlesommen intern te identificeren. Bij twijfel gebruikt u de naam van het commando. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="checksum-definition-Name">
          <term
><literal
>Name</literal
> (translated)</term>
          <listitem>
            <para
>De voor de gebruiker zichtbare naam van dit programma voor controlesommen, zoals getoond in het afrolmenu in de configuratiedialoog van &kleopatra;. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="checksum-definition-create-command">
          <term
><literal
>create-command</literal
></term>
          <listitem>
            <para
>Het actuele commando waarmee controlesombestanden worden aangemaakt. De syntax, beperkingen en opties voor argumentenoverdracht zijn hetzelfde als beschreven voor <xref linkend="archive-definition-pack-command"/> in <xref linkend="admin-archive-definitions"/>. </para>
          </listitem>
        </varlistentry>

        <varlistentry id="checksum-definition-verify-command">
          <term
><literal
>verify-command</literal
></term>
          <listitem>
            <para
>Hetzelfde als <xref linkend="checksum-definition-create-command"/>, echter voor verificatie van de controlesom. </para>
          </listitem>
        </varlistentry>

      </variablelist>

      <para
>Hier is een volledig voorbeeld: <programlisting
>[Checksum Definition #1]
          file-patterns=sha1sum.txt
          output-file=sha1sum.txt
          id=sha1sum-gnu
          Name=sha1sum (GNU)
          Name[de]=sha1sum (GNU)
          ...
          create-command=sha1sum -- %f
          verify-command=sha1sum -c -- %f
        </programlisting>
      </para>

    </sect1
> <!-- Checksum Definition -->

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

<chapter id="credits-and-license">
<title
>Dankbetuiging en licentie</title>

<para
>&kleopatra; copyright 2002 &Steffen.Hansen;, &Matthias.Kalle.Dalheimer; en &Jesper.Pedersen;., copyright 2004 &Daniel.Molkentin;, copyright 2004, 2007, 2008, 2009, 2010 Klar&auml;lvdalens Datakonsult AB</para>

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

<itemizedlist>
<title
>Medewerkers</title>
<listitem>
<para
>&Marc.Mutz; &Marc.Mutz.mail;</para>
</listitem>
<listitem>
<para
>&David.Faure; &David.Faure.mail;</para>
</listitem>
<listitem>
<para
>&Steffen.Hansen; <email
>hansen@kde.org</email
></para>
</listitem>
<listitem>
<para
>&Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail;</para>
</listitem>
<listitem>
<para
>&Jesper.Pedersen; &Jesper.Pedersen.mail;</para>
</listitem>
<listitem>
<para
>&Daniel.Molkentin; &Daniel.Molkentin.mail;</para>
</listitem>
</itemizedlist>

&meld.fouten;&vertaling.freek; 
&underFDL; &underGPL; </chapter>

&documentation.index; 
</book>

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

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