# Het handboek van &kleopatra;

## Inleiding

&kleopatra; is het &kde; hulpmiddel voor het beheer van certificaten volgens &x509; en &openpgp;in de &gpgsm; en &gpg; sleutelringen en voor het ophalen van certificaten uit &ldap; en andere servers voor certificaten.

&kleopatra; kan gestart worden vanuit het menu van &kmail; Hulpmiddelen Certificatenbeheerder, evenals vanaf de commandoregel. Het &kleopatra; programma heeft de naam ``kleopatra``.

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.

De naam is gekozen omdat dit programma zijn oorsprong heeft in een Ägypten Projects (Ägypten is Duits voor Egypte). &kleopatra; is de Duitse spelling van Cleopatra.

## Hoofdfuncties

### De lokale sleutelkast bekijken

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.

Het hoofdvenster is opgedeeld in het grote gebied voor het weergeven van de sleutels, die bestaat uit verschillende tabbladen, de menubalk en de zoekbalk bovenaan en een statusbalk onderaan.

Elke regel in de lijst met sleutels komt overeen met één certificaat, geïdentificeerd door de zogenaamde Onderwerp-&dn;. &dn; is een acroniem voor Distinguished Name, 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.

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 certificaat en (publieke) sleutel worden uitwisselbaar gebruikt en we zullen ze ook niet in deze handleiding van elkaar onderscheiden, behalve wanneer expliciet genoemd.

&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), ⪚ 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;.

Om te zien welke van de certificaten root-certificaten zijn, schakelt u om naar de hiërarchische modus voor de sleutellijst met view-hierarchical-key-list.

U kunt de details zien van elk certificaat door er dubbel op te klikken of 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.

Als u de sleutelkast wijzigt zonder &kleopatra; te gebruiken (⪚ met het commandoregelinterface van &gpgsm;), dan kunt u het beeld vernieuwen met view-redisplay.

### Zoeken en importeren van certificaten

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.

Om te zoeken naar een certificaat in een &ldap;-directory, selecteert u Bestand Certificaten op server opzoeken en voert u enige tekst in (⪚ de naam van de persoon waarvan u het certificaat wilt) in het tekstinvoervak van de dialoog Certificaten opzoeken op de sleutelserver, klik daarna op de knop Zoeken. 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 Details of ze download met Importeren in de lokale sleutelkast.

U kunt de lijst met &ldap;-servers instellen voor het zoeken in de pagina Directory Services van de instellingendialoog van &kleopatra;.

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

Als u uw eigen sleutelpaar met &gpgsm; aanmaken 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 ``kleopatra `--import-certificate` `bestandsnaam``` of in &kleopatra; met file-import-certificates, zoals u ook zou doen met normale certificaten.

### Nieuwe sleutelparen aanmaken

Het menu-item file-new-key-pair start de Assistent voor aanmaken van een sleutelpaar die u door een aantal stappen voor het aanmaken van een certificaatverzoek.

Wanneer u klaar bent met een stap in de assistent, druk dan op Volgende om naar de volgende stap (of Terug om stappen te herzien die al zijn voltooid). Het maken van het certificaatverzoek kan op elk moment worden geannuleerd door op de knop Annuleren te drukken.

Op de eerste pagina van de assistent kiest u welk type certificaat u wilt aanmaken:

Een persoonlijk OpenPGP-sleutelpaar aanmaken

- &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.

  U moet een Naam, E-mailadres en optioneel Commentaar invoeren.

Een persoonlijk X.509-sleutelpaar en certificatieverzoek aanmaken

- Sleuteparen voor &x509; 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.

  De volgende stap in de assistent is het invoeren van uw persoonlijke gegevens voor het certificaat. De in te vullen velden zijn:

  - Algemene naam/Common Name (CN): Uw naam;

  - E-mailadres (EMAIL): Uw e-mailadres; let er goed op dat dit juist is—dit zal worden gebruikt als het adres waar mensen e-mail naar zenden wanneer ze uw certificaat gebruiken.

  - Locatie (L): Het dorp of de stad waarin u woont;

  - Organizational unit (OU): De eenheid in uw organisatie waarin u zich bevindt (bijvoorbeeld, "Administratie");

  - Organisatie (O): De organisatie die u vertegenwoordigt (bijvoorbeeld, het bedrijf waarvoor u werkt);

  - Country code/landencode (C): De tweeletterige code voor het land waarin u woont (bijvoorbeeld, "NL");

  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.

#### Een sleutel intrekken

Een verlopen sleutelpaar kan teruggebracht worden in een operationele status zolang u toegang hebt tot de privé sleutel en de wachtwoordzin. Om een sleutelpaar betrouwbaar onbruikbaar te maken moet u het terugtrekken. Terugtrekken wordt gedaan door een speciale handtekening voor terugtrekken aan de sleutel toe te voegen.

Deze handtekening voor terugtrekken is als een apart bestand opgeslagen. Dit bestand kan later geïmporteerd worden in de sleutelring en wordt dan vastgeplakt aan de sleutel waarmee het onbruikbaar wordt. Merk op dat bij het importeren van deze ondertekening naar de sleutel geen wachtwoord is vereist. Daarom moet u deze ondertekening voor terugtrekken op een veilige plek opslaan, gewoonlijk een plek die verschilt van waar uw sleutelpaar is opgeslagen. Een goed advies is om een plek te kiezen die apart van uw computer is, kopieer deze ofwel naar een externe opslag zoals een USB-stick of druk deze af.

&kleopatra; biedt geen functie voor het aanmaken van zo'n handtekening voor intrekken op welk moment dan ook, maar u kunt dat doen met de &kde;-toepassing &kgpg; door te kiezen Sleutels Sleutel intrekken en, naar keuze, de handtekening voor intrekken direct in uw sleutelring te importeren.

Een alternatieve manier voor het maken van een "revocation certificate" is met gebruik van &gpg; direct vanaf de commandoregel: `gpg --output `revocation_certificate`.asc --gen-revoke `uw_sleutel``. Het argument `uw_sleutel` moet een sleutel specificeren, ofwel de sleutel-ID van uw primaire sleutelpaar of een deel van een gebruikers-ID dat uw sleutelpaar identificeert.

## Menureferentie

### Menu Bestand

&Ctrl;N Bestand Nieuw certificaat...

- Maakt een nieuw sleutelpaar (publiek en privé) aan 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.

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

&Ctrl;&Shift;I Bestand Certificaten opzoeken op de server...

- Zoekt naar en importeert certificaten op servers voor certificaten naar de lokale sleutelkast. Zie functions-search voor details.

  U moet servers voor certificaten hebben geconfigureerd om dit te laten werken. Zie configuration-directory-services voor meer details.

&Ctrl;I Bestand Certificaten importeren...

- Importeert certificaten en/of geheime sleutels uit bestanden in de lokale sleutelkast. Zie functions-search voor details.

  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.

&Ctrl;E Bestand Certificaten exporteren...

- Exporteert de geselecteerde certificaten naar een bestand.

  De extensie van de bestandsnaam die u koos voor het exporteren bepaalt het formaat van het exportbestand:

  - Voor &openpgp;-certificaten, resulteren `gpg` en `pgp` in een binair bestand, terwijl `asc` resulteert in een &ascii; file.

  - Voor &smime; certificaten, resulteert `der` in een binair, &der;-gecodeerd bestand, terwijl `pem` resulteert in een &ascii; bestand.

  Tenzij meerdere certificaten zijn geselecteerd, zal &kleopatra; ``vingerafdruk`.{asc,pem}` als de naam van het te exporteren bestand voorstellen.

  Deze functie is alleen beschikbaar wanneer een of meer certificaten zijn geselecteerd.

  Deze functie exporteert alleen de publieke sleutels, zelfs als de geheime sleutel beschikbaar is . Gebruik file-export-secret-key om de geheime sleutels in een bestand te exporteren.

Bestand Geheim sleutels exporteren...

- Exporteert de geheime sleutel naar een bestand.

  In de geopende dialoog kunt u kiezen om een binair of &ascii;-bestand (ASCII-bewapend) voor export aan te maken. Klik vervolgens op het pictogram van de map aan de rechterkant van het tekstvak van het Uitvoerbestand en selecteer de map en de naam het exportbestand. Bij exporteren van geheime sleutels van &smime; kunt u ook de Tekenset van de wachtwoordzin kiezen. Zie voor meer details de discussie van de optie `--p12-charset `tekenset`` in het handboek van &gpgsm;.

  Deze functie is alleen beschikbaar wanneer precies één certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is.

  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.

&Ctrl;&Shift;E Bestand Certificaten naar server exporteren...

- Publiceer de geselecteerde certificaten op een sleutelserver (alleen &openpgp;).

  Het certificaat wordt verzonden naar de server voor certificaten geconfigureerd voor &openpgp; (cf. configuration-directory-services), als die is ingesteld, anders naar `keys.gnupg.net`.

  Deze functie is alleen beschikbaar als minstens een &openpgp; (en geen &smime;) certificaten zijn geselecteerd.

  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.

  De meeste publieke &openpgp; servers voor certificaten synchroniseren deze onder elkaar, zodat er weinig reden is ze naar meer dan een server te sturen.

  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 DNS-server komen om de belasting te balanceren over meerdere machines. Deze machines synchroniseren zich met elkaar, maar gewoonlijk slechts ongeveer elke 24 uur.

Bestand Ontcijfer/verifieer bestanden...

- Ontcijfert bestanden en/of verifieert handtekeningen over bestanden.

Bestand Onderteken/versleutel bestanden...

- Ondertekent en/of versleutelt bestanden.

&Ctrl;W Bestand Sluiten

- Sluit het hoofdvenster van &kleopatra;. U kunt het op elk moment herstellen met het pictogram in het systeemvak.

&Ctrl;Q Bestand Afsluiten

- &kleopatra; wordt beëindigd.

### Menu Beeld

F5 Beeld Opnieuw tonen

- Ververst de certificatenlijst.

  Het gebruik van deze functie is gewoonlijk niet nodig, omdat &kleopatra; het bestandssysteem monitort op wijzigingen en automatisch de certificatenlijst ververst indien nodig.

&Esc; Beeld Bewerking stoppen

- Stopt (annuleert) alle gaande acties, ⪚ een zoekopdracht, lijst met sleutels tonen of een download.

  Deze functie is alleen beschikbaar als minstens een actie actief is.

  Vanwege beperkingen in de backend, hangen bewerkingen soms op zo'n manier dat deze functie ze niet direct kan annuleren of zelfs helemaal niet.

  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 (`top`, takenbeheerder &etc;), totdat de bewerking niet geblokkeerd is.

Beeld Details van certificaat

- Toont de details van het geselecteerde certificaat.

  Deze functie is alleen beschikbaar wanneer precies één certificaat is geselecteerd.

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

Beeld Hiërarchische certificatenlijst

- Wisselt tussen een hiërarchische en platte modus van de certificatenlijst.

  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 zoekbalk kunt gebruiken).

  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.

  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.

  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, ouder = ondertekenaar of ouder = ondertekende).

&Ctrl;. Beeld Alles uitvouwen

- Vouwt alle items in de lijst in de lijstweergave van de certificaten uit, &ie; maakt alle items zichtbaar.

  Dit is de standaard bij het binnengaan in de modus hiërarchische sleutellijst.

  U kunt natuurlijk nog steeds elk individueel item invouwen of uitvouwen.

  Deze functie is alleen beschikbaar wanneer view-hierarchical-key-list aan is.

&Ctrl;, Beeld Alles invouwen

- Vouwt alle items in de lijst met certificaten in, &ie; verbergt alles behalve het bovenste gedeelte van de items.

  U kunt natuurlijk nog steeds elk individueel item invouwen of uitvouwen.

  Deze functie is alleen beschikbaar wanneer view-hierarchical-key-list aan is.

### Menu met certificaten

Certificaten Eigenaarvertrouwen wijzigen...

- Wijzigt het vertrouwen in de eigenaar van het geselecteerde &openpgp;-certificaat.

  Deze functie is alleen beschikbaar wanneer precies één &openpgp;-certificaat is geselecteerd.

Certificaten Hoofdcertificaat vertrouwen

- Markeert dit (&smime;)-hoofdcertificaat als vertrouwd.

  Op een bepaalde manier is dit het equivalent van certificates-change-owner-trust voor &smime;-hoofdcertificaten. U kunt echter alleen kiezen tussen—in &openpgp; termen—volledig vertrouwen en geen vertrouwen.

  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 (`allow-mark-trusted` in `gpg-agent.conf` of ofwel GnuPG-systeem GPG-agent Sta clients toe om sleutels als "vertrouwd" te markeren ofwel S/MIME-validatie Sta toe hoofdcertificaten als vertrouwd te markeren onder configuration).

  Die functionaliteit in de backend inschakelen kan leiden tot popups van &pinentry; op ongewenste tijden (⪚ 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 wantrouwen, staat &kleopatra; handmatig instellen van vertrouwen toe.

  Vanwege het ontbreken van ondersteuning voor deze functie door een backend, is het nodig dat &kleopatra; direct op de vertrouwensdatabase (`trustlist.txt`) 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.

  Deze functie is alleen beschikbaar wanneer precies één &smime;-hoofdcertificaat is geselecteerd en dat certificaat nog niet vertrouwd wordt.

  Gebruik certificates-distrust-root om deze functie ongedaan te maken.

Certificaten Wantrouw hoofdcertificaat

- Markeert dit &smime;-hoofdcertificaat als niet vertrouwd.

  Deze functie is alleen beschikbaar wanneer precies één &smime;-hoofdcertificaat is geselecteerd en dat certificaat wordt nu vertrouwd.

  Gebruikt om certificates-trust-root ongedaan te maken. Zie aldaar voor details.

Certificaten Certificeer certificaat...

- Stelt u in staat om een ander &openpgp;-certificaat te certificeren.

  Deze functie is alleen beschikbaar als precies één &openpgp;-certificaat is geselecteerd.

Certificaten Vervaldatum wijzigen...

- Stelt u in staat om de vervaldatum van uw &openpgp;-certificaat te wijzigen.

  Gebruik deze functie om de leeftijd van uw &openpgp;-certificaten, als alternatief voor ofwel een nieuwe aanmaken of een onbeperkte leeftijd te gebruiken (vervalt nooit).

  Deze functie is alleen beschikbaar als precies één certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is.

Certificaten Wachtwoordzin wijzigen...

- Stelt u in staat om de wachtwoordzin van uw geheime sleutel te wijzigen.

  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.

  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.

Certificaten Gebruikers-id toevoegen...

- Stelt u in staat om een nieuwe gebruikers-id aan uw &openpgp;-certificaat toe te voegen.

  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:

      Echte naam (Commentaar) <E-mailadres>

  In de dialoog die verschijnt wanneer u deze functie selecteert, zal &kleopatra; u apart vragen naar elk van de drie parameters (`Echte naam`, `Commentaar` en `E-mailadres`) en het resultaat aan u tonen.

  Deze parameters zijn onderworpen aan dezelfde beheerdersbeperkingen als in nieuwe certificaten. Zie functions-newkey en admin-certificate-request-wizard voor details.

  Deze functie is alleen beschikbaar als precies één &openpgp;-certificaat is geselecteerd en de geheime sleutel voor dat certificaat beschikbaar is.

Del Certificaten Verwijderen

- Verwijdert de geselecteerde certificaten uit de lokale sleutelring.

  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 zoekbalk of de functie view-hierarchical-key-list om de controle terug te krijgen over de meeste certificaten.

  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.

  &kleopatra; zal u waarschuwen wanneer u een geheime sleutel probeert te verwijderen.

  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.

  Dit is hetzelfde als een bestandssysteem: wanneer u een map verwijdert, verwijdert u ook alle bestanden en mappen erin.

  Natuurlijk is deze functie alleen beschikbaar als u minstens één certificaat hebt geselecteerd.

Certificaten Certificaat dumpen

- Toont alle informatie die &gpgsm; heeft over het geselecteerde (&smime;-) certificaat.

  Zie de discussie over `--dump-key `sleutel`` in het handboek van &gpgsm; voor details over de uitvoer.

### Menu hulpmiddelen

Hulpmiddelen GnuPG-logweergave...

- Start &kwatchgnupg;, 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.

  Deze functie is niet beschikbaar onder &Windows;, omdat de onderliggende mechanismen niet in de backend op dat platform zijn geïmplementeerd.

Hulpmiddelen OpenPGP-certificaten verversen

- Alle &openpgp;-certificaten verversen door het uitvoeren van

      gpg --refresh-keys

  Na succesvolle uitvoering van het commando, bevat uw lokale sleutelbos de laatste wijzigingen met betrekking tot de geldigheid van &openpgp;-certificaten.

  Zie de opmerking onder certificates-refresh-x509 voor enige valkuilen.

Hulpmiddelen X.509-certificaten verversen

- Alle &smime;-certificaten verversen door het uitvoeren van

      gpgsm -k --with-validation --force-crl-refresh --enable-crl-checks

  Na succesvolle uitvoering van het commando bevat uw lokale sleutelbos de laatste wijzigingen met betrekking tot de geldigheid van &smime;-certificaten.

  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.

  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.

Hulpmiddelen CRL uit een bestand importeren...

- Laat u handmatig &crl;'s uit bestanden importeren.

  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.

  Om het importeren van &crl; te laten werken moet het hulpmiddel &dirmngr; in `PATH` zijn te vinden. Als dit menu-item is uitgeschakeld, dan zou u contact met de systeembeheerder moeten opnemen en hem vragen &dirmngr; te installeren.

Hulpmiddelen CRL-cache wissen

- Wist de &crl;-cache van &gpgsm;.

  U hebt dit waarschijnlijk nooit nodig. U kunt het verversen van de &crl;-cache forceren door alle certificaten te selecteren en in plaatst daarvan certificates-refresh-x509 te gebruiken.

Hulpmiddelen CRL-cache dumpen

- Toont de gedetailleerde inhoud van de &crl;-cache van &gpgsm;.

### Menu Instellingen

&kleopatra; heeft een standaard Instellen-menu voor &kde;, zoals is beschreven in de Basisinformatie van &kde; met één extra item:

Instellingen Zelftest uitvoeren

- Een set zelftesten uitvoeren en hun resultaat laten zien.

  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.

### Venstermenu

Het menu Venster 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.

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

### Menu Help

&kleopatra; heeft een standaard Help-menu voor &kde;, zoals is beschreven in de Basisinformatie van &kde; .

## Naslag van opdracht-opties

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 ``kleopatra `--help```.

`--uiserver-socket` `argument`

- Locatie van de socket waarnaar de ui-server luistert

`--daemon`

- Alleen UI-server uitvoeren, hoofdvenster verbergen

`-p` `--openpgp`

- &openpgp; voor de volgende actie gebruiken

`-c` `--cms`

- CMS (&x509;, S/&MIME;) voor de volgende actie gebruiken

`-i` `--import-certificate`

- Specificeert een bestand of &URL; waar vandaan certificaten (of geheime sleutels) geïmporteerd moeten worden.

  Dit is het equivalent op de commandoregel van file-import-certificates.

`-e` `--encrypt`

- Bestand(en) versleutelen

`-s` `--sign`

- Bestand(en) ondertekenen

`-E` `--encrypt-sign`

- Versleutel en/of onderteken bestand(en). Zelfde als `--sign-encrypt`, niet gebruiken

`-d` `--decrypt`

- Bestand(en) ontcijferen

`-V` `--verify`

- Bestand/ondertekening verifiëren

`-D` `--decrypt-verify`

- Bestand(en) ontcijferen en/of verifiëren

## &kleopatra; instellen

De instellingendialoog van &kleopatra; kan bereikt worden via Instellingen&kleopatra; instellen...

Elk van zijn pagina's wordt in de secties hieronder beschreven.

### Directory Services instellen

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.

Dit is eenvoudig een meer gebruikersvriendelijke versie van dezelfde instellingen die u ook vindt in configuration-gnupg-system. Alles wat u hier in kan stellen, kunt u ook daar instellen.

#### Een opmerking over Proxy-instellingen

Proxy-instellingen kunne worden geconfigureerd voor &http; en &ldap; in configuration-smime-validation, maar alleen voor &gpgsm;. Voor &gpg;, vanwege de complexiteit van de opties voor de keyserver in &gpg; en het ontbreken van voldoende ondersteuning hiervoor in &gpgconf;, moet u het configuratiebestand `gpg.conf` direct wijzigen. Kijk in het handboek van &gpg; voor details. &kleopatra; zal zulke instellingen bewaren, maar laat ze nog niet wijzigen in de &GUI;.

De tabel Directory services toont welke servers op dit moment zijn ingesteld. Dubbelklik op een cel in de tabel om parameters van bestaande servers te wijzigen.

De betekenis van de kolommen in de tabel is als volgt:

Schema

- Bepaalt het te gebruiken netwerkprotocol voor toegang tot de server. Vaak gebruikt schema's omvatten ldap (en zijn &ssl;-beveiligde tweeling ldaps) voor &ldap; servers (algemeen protocol voor &smime;; de enige ondersteund door &gpgsm;) en hkp, het Horowitz Keyserver Protocol, nu is gebruikelijk &http; Keyserver Protocol, een op het &http; protocol gebaseerd dat door vrijwel alle publieke &openpgp; keyservers wordt ondersteund.

  Kijk in de handleiding van &gpg; en &gpgsm; voor een lijst van ondersteunde schema's.

Servernaam

- De domeinnaam van de server, ⪚ `keys.gnupg.net`.

Poort van server

- De netwerkpoort waarop de server luistert.

  Dit verandert automatisch naar de standaard poort wanneer u de configuration-directory-services-scheme, tenzij het eerst was ingesteld op een niet-standaard poort. Als u de standaard poort hebt gewijzigd en niet terug kan gaan, probeer dan configuration-directory-services-scheme naar `http` en configuration-directory-services-server-port naar `80` (de standaard voor &http;) in te stellen en ga dan daar vanaf verder.

Basis-DN

- De basis-&dn; (alleen voor &ldap; en &ldaps;) is, &ie; het begin van de &ldap; hiërarchie om vanaf te starten. Dit wordt vaak ook de zoek-root of zoekbasis genoemd.

  Gewoonlijk lijkt het op `c=nl,o=Foo`, opgegeven als deel van de &ldap; &URL;.

Gebruikersnaam

- De gebruikersnaam, indien nodig, te gebruiken voor aanmelden aan de server.

  Deze kolom wordt alleen getoond als de optie Gebruiker- en wachtwoordinformatie tonen (onder de tabel) is geactiveerd.

Wachtwoord

- De wachtwoord, indien nodig, te gebruiken voor aanmelden aan de server.

  Deze kolom wordt alleen getoond als de optie Gebruiker- en wachtwoordinformatie tonen (onder de tabel) is geactiveerd.

X.509

- Activeer deze kolom als dit item gebruikt moet worden voor zoeken naar &x509; (&smime;) certificaten.

  Alleen &ldap; (en &ldaps;) servers worden voor &smime; ondersteund.

OpenPGP

- Activeer deze kolom als dit item gebruikt moet worden voor zoeken naar &openpgp; certificaten.

U kunt zoveel &smime; (&x509;) servers instellen als u wilt, maar alleen één &openpgp; server is tegelijk toegestaan. De &GUI; zal dat afdwingen.

Om een nieuwe server toe te voegen klikt u op de knop Nieuw. Dit dupliceert het geselecteerde item, indien aanwezig, of voegt een standaard &openpgp; server in. Daarna kunt u de configuration-directory-services-server-name, de configuration-directory-services-server-port, de configuration-directory-services-base-dn en de gebruikelijke configuration-directory-services-password en configuration-directory-services-user-name instellen, die beiden alleen nodig zijn als de server authenticatie vereist.authentication.

Om direct een item voor &x509; certificaten in te voegen, gebruikt u Nieuw X.509; gebruik Nieuw OpenPGP voor &openpgp;.

Om een server uit de zoeklijst te verwijderen, selecteert u deze in de lijst en drukt daarna op de knop Verwijderen.

Om de timeout van &ldap; in te stellen, &ie; de maximum tijd die de backend zal wachten op een antwoord van de server, gebruikt u eenvoudig het overeenkomstige invoerveld met het label LDAP-timeout (minuten:seconden).

Als een van uw servers een grote database heeft, zodat zelfs redelijke zoekopdrachten zoals `Jansen` het maximale aantal per query teruggegeven items overstijgen, dan zou u deze limiet willen vergroten. U kunt gemakkelijk te weten komen of u de limiet bij een zoekopdracht overschrijdt, omdat er in dat geval een dialoogvenster te voorschijn komt, die u vertelt dat de resultaten zijn afgekort.

Sommige servers kunnen hun eigen limieten over het aantal terug te geven items op een query hebben. In dat geval, zal het verhogen van de limiet hier niet resulteren in meer teruggegeven items.

### Het uiterlijk instellen

#### Tekstballonnen instellen

In de hoofdlijst van certificaten kan &kleopatra; details tonen over een certificaat in een tekstballon. De getoonde informatie is dezelfde als in het tabblad Overzicht van de dialoog Details van certificaten. Tekstballonnen kunnen echter beperkt worden om alleen een subset van de informatie te tonen voor een minder uitgebreide ervaring.

De Key-ID wordt altijd getoond. Dit is om te verzekeren dat tekstballonnen voor verschillende certificaten ook echt verschillen (dit is speciaal belangrijk als alleen tooltips-validity zijn geselecteerd).

U kunt onafhankelijk de volgende informatiesets in- of uitschakelen:

Geldigheid tonen

- Toont informatie over de geldigheid van een certificaat: zijn huidige status, uitgever-&dn; (alleen &smime;), verloopdatum (indien aanwezig) en gebruiksvlaggen voor gebruik.

  Voorbeeld:

      Dit certificaat is nu geldig.
      Uitgever:          CN=Test-ZS 7,O=Intevation BV,C=NL
      Geldigheid:        vanaf 25.08.2009 10:42 tot 19.10.2010 10:42
      Certificaatgebruik: E-mails en bestanden, versleuteling e-mails en bestanden
      Key-ID:            DC9D9E43

Eigenaarsinformatie tonen

- Toon informatie over de eigenaar van het certificaat: subject-&dn; (alleen &smime;), gebruiker-ID's (inclusief e-mailadressen) en vertrouwen in eigenaar (alleen &openpgp;).

  &openpgp; voorbeeld:

      Gebruiker-ID:         Gpg4winUserA <gpg4winusera@test.hq>
      Key-ID:               C6BF6664
      Gebruikersvertrouwen: ultimate

  &smime; voorbeeld:

      Subject:           CN=Gpg4winTestuserA,OU=Testlab,O=Gpg4win Project,C=DE
      a.k.a.:            Gpg4winUserA@test.hq
      Key-ID:            DC9D9E43

Technische details tonen

- Toont technische informatie over het certificaat: serienummer (alleen &smime;), type, vingerafdruk en opslaglocatie.

  Voorbeeld:

      Serienummer:       27
      Certificaattype:  1,024-bit RSA (geheime certificaat beschikbaar)
      Key-ID:            DC9D9E43
      Vingerafdruk:       854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Opgeslagen:            op deze computer

#### Certificaatcategorieën instellen

&kleopatra; stelt u in staat om het uiterlijk van certificaten in de lijstweergave aan te passen. Dit omvat het tonen van een klein pictogram, maar u kunt ook de voorgrond (tekst) en achtergrondkleuren beïnvloeden, evenals het lettertype.

Iedere categorie van certificaten in de lijst heeft een set kleuren, een pictogram (optioneel) en een lettertype toegewezen waarin certificaten in die categorie worden weergegeven. De lijst met categorieën fungeert ook als een overzicht van de instellingen. Categorieën kunnen vrij worden gedefinieerd door de beheerder of de zware gebruiker, zie admin-key-filters in admin.

Om het pictogram van een categorie in te stellen of te wijzigen, selecteert u deze in de lijst en drukt op de knop Pictogram instellen.... De standaard dialoog voor selectie van een &kde;-pictogram zal verschijnen, waarin u kunt een bestaand pictogram uit de &kde;-verzameling kunt selecteren of een eigen exemplaar kunt laden.

Om een pictogram opnieuw te verwijderen moet u de knop Standaard uiterlijk indrukken.

Om de tekstkleur (&ie; voorgrond) van een categorie te wijzigen, selecteert u het in de lijst en drukt op de knop Tekstkleur instellen.... De standaard kleurkeuzedialoog van &kde; zal verschijnen waar u een bestaande kleur kiest of een nieuwe aanmaakt.

De achtergrondkleur veranderen wordt op dezelfde manier gedaan, druk in plaats daarvan eenvoudig op Achtergrondkleur instellen....

Om het lettertype te wijzigen hebt u in principe twee opties:

1. Verander het standaard lettertype, dat wordt gebruikt voor alle weergave van lijsten in &kde;.

2. Een aangepast lettertype gebruiken.

De eerste optie heeft het voordeel dat het lettertype elke stijl volgt die u kiest voor geheel &kde;, terwijl de laatste u volledige controle geeft over het te gebruiken lettertype. De keuze is aan u.

Om het gewijzigde standaard lettertype te gebruiken, selecteert u de categorie in de lijst en activeert of deactiveert u de modifiers van lettertypen Cursief, Vet en/of Doorstrepen. U kunt onmiddellijk het effect zien op het lettertype in de lijst met categorieën.

Om een eigen lettertype te gebruiken, drukt u op de knop Lettertype instellen.... De standaard lettertypeselectiedialoog van &kde; zal verschijnen waar u het nieuwe lettertype kunt selecteren.

U kunt nog steeds de lettertype-modifiers gebruiken om het eigen lettertype te wijzigen, net als voor het wijzigen van het standaard lettertype.

Om terug te schakelen naar het standaard lettertype moet u de knop Standaard uiterlijk indrukken.

#### De DN-attribuutvolgorde

Hoewel &dn;'s hiërarchisch zijn, is de volgorde van de individuele componenten (relatieve &dn;'s genoemd (RDNs) of &dn;-attributen) niet gedefinieerd. De volgorde waarin de attributen getoond worden is dus een zaak van persoonlijke smaak of bedrijfsbeleid, dat is waarom het in &kleopatra; is in te stellen.

Deze instelling is niet alleen van toepassing op &kleopatra;, maar op alle toepassen die &kleopatra;-technologie gebruiken. Op het moment van schrijven hiervan omvat dit &kmail;, &kaddressbook;, evenals &kleopatra; zelf, natuurlijk.

Deze configuratiepagina bestaat in de basis uit twee lijsten, een voor de bekende attributen (Beschikbare attributen) en met de beschrijving van Huidige attribuutvolgorde.

Beide lijsten bevatten items beschreven door de korte vorm van het attribuut (⪚ CN) evenals de volledige vorm (Common Name).

De lijst Beschikbare attributen is altijd alfabetisch gesorteerd, terwijl de Huidige attribuutvolgorde de volgorde van de lijst van de ingestelde attribuutvolgorde van &dn; weergeeft: het eerste attribuut in de lijst is ook als eerste weergegeven.

Alleen expliciet in de lijst opgenomen attributen in de lijst met de Huidige attribuutvolgorde worden überhaupt getoond. De rest is standaard verborgen.

Wanneer echter het plaatshouderitem _X_ (Alle anderen) in de huidige lijst staat, worden alle niet in lijst opgenomen attributen (bekend of niet) ingevoegd op het punt van de _X_ in hun originele relatieve volgorde.

Een klein voorbeeld zal helpen dit helderder te maken:

Gegeven de &dn;

> O=&kde;, C=NL, CN=David Ontwikkel, X-BAR=foo, OU=&kleopatra;, X-FOO=bar,

zal de standaard volgorde van attributen CN, L, _X_, OU, O, C de volgende geformatteerde &dn; produceren:

> CN=David Ontwikkel, X-BAR=foo, X-FOO=bar, OU=&kleopatra;, O=&kde;, C=NL

terwijl CN, L, OU, O, C zal produceren

> CN=David Ontwikkel, OU=&kleopatra;, O=&kde;, C=NL

Om een attribuut aan de lijst met weergavevolgorde toe te voegen, wordt het geselecteerd in de lijst Beschikbare attributen en daarna op de knop Aan huidige attribuutvolgorde toevoegen drukken.

Om een attribuut uit de lijst met weergavevolgorde te verwijderen, wordt het geselecteerd in de lijst Huidige attribuutvolgorde en daarna op de knop Uit huidige attribuutvolgorde verwijderen drukken.

Om een attribuut naar het begin (einde) te verplaatsen wordt het geselecteerd in de lijst Huidige attribuutvolgorde en daarna op de knop Naar de top verplaatsen (Naar onderaan verplaatsen) drukken.

Om een attribuut één omhoog (omlaag) te verplaatsen, wordt het geselecteerd in de lijst Huidige attribuutvolgorde en daarna op de knop Één naar boven verplaatsen (Één naar beneden verplaatsen) drukken.

### Cryptografische bewerkingen instellen

#### E-mail bewerkingen instellen

Hier kunt u enige aspecten van de e-mail bewerkingen van de &uiserver; van &kleopatra; instellen. Op dit moment kunt u alleen instellen of u Snelle modus voor ondertekenen en versleutelen van e-mails wilt gebruiken of niet.

Met Snellemodus geactiveerd, wordt er geen dialoog getoond bij respectievelijk ondertekening (versleuteling) van e-mails, tenzij er een conflict is dat handmatig oplossen vereist.

#### Bestandsbewerkingen instellen

Hier kunt u enkele aspecten van de bestandsbewerkingen van &kleopatra;'s &uiserver; instellen. Op dit moment kunt u alleen het te gebruiken controlesomprogramma voor `CHECKSUM_CREATE_FILES` kiezen.

Gebruik Te gebruiken controlesomprogramma om te kiezen welk van de geconfigureerde controlesomprogramma 's gebruikt zou moeten worden bij het aanmaken van controlsombestanden.

Bij het verifiëren van controlesommen wordt het te gebruiken programma automatisch gevonden, gebaseerd op de gevonden controlesombestanden.

De systeeembeheerder en grootgebruiker kunnen volledig definiëren welke programma's voor een controlesom beschikbaar gemaakt wordt aan &kleopatra; via de zogenaamde Controlesomdefinities in het instellingenbestand. Zie admin-checksum-definitions in admin voor details.

### Aspecten van S/&MIME;-validatie instellen

Op deze pagina kunt u bepaalde aspecten van de validatie van &smime;-certificaten instellen.

Dit is grotendeels eenvoudig een meer gebruikersvriendelijke versie van dezelfde instellingen die u ook vindt in configuration-gnupg-system. Alles wat u hier in kan stelen, kunt u ook daar met uitzindering van configuration-smime-validation-refresh-interval, wat specifiek voor &kleopatra; is.

De betekenis van de opties is als volgt:

#### Regelmatige controle van certificaten instellen

Geldigheid van certificaat elke `N` uren controleren

- Deze optie activeert het regelmatig controleren van geldigheid van certificaten. Ook kan het tijdinterval (in uren) ingesteld worden. Het effect van regelmatig controleren is hetzelfde als view-redisplay; er is geen voorziening voor regelmatig controleren van certificates-refresh-openpgp of certificates-refresh-x509.

  Validatie wordt impliciet uitgevoerd wordt wanneer belangrijke bestanden in `~/.gnupg` veranderen. Deze optie, evenals certificates-refresh-openpgp en certificates-refresh-x509, heeft daarom alleen effect bij externe factoren van de geldigheid van een certificaat.

#### Validatiemethode instellen

Certificaten met CRL's valideren

- Wanneer deze optie is geselecteerd, zullen &smime;-certificaten gevalideerd worden met Certificate Revocation Lists (&crl;'s).

  Zie configuration-smime-validation-use-ocsp voor een alternatieve methode van het controleren van de geldigheid van een certificaat.

Certificaten online valideren (OCSP)

- Als deze optie ingeschakeld is, worden &smime;-certificaten gevalideerd met gebruikmaking van het Online Certificates Status Protocol (&ocsp;).

  Bij het kiezen van deze methode wordt er een verzoek naar de server van de &ca; verzonden, meer of minder elke keer dat u een versleuteld bericht verzendt of ontvangt, dus theoretisch stelt u de uitgevende organisatie van uw certificaat in staat om na te gaan met wie u (⪚) e-mails uitwisselt.

  Om deze methode te kunnen gebruiken moet u de &URL; van de &ocsp; server invoeren in configuration-smime-validation-ocsp-url.

  Zie configuration-smime-validation-use-ocsp voor een meer traditionele methode van het controleren van de geldigheid van een certificaat die geen informatie lekt met wie u berichten uitwisselt.

URL-adres OCSP-dienst

- Voer hier het adres in van de server die de certificaten online valideert (&ocsp;-dienst). Het &URL;-adres begint doorgaans met `http://`.

Handtekening OCSP-dienst

- Hier het certificaat kiezen waarmee de &ocsp;-server zijn antwoorden ondertekend.

Service-URL van certificaten negeren

- Elk &smime;-certificaat bevat gewoonlijk de &URL; van de &ocsp; van de server van zijn uitgever (certificates-dump-certificate toont of een gegeven certificaat deze bevat).

  Het activeren van deze optie zorgt ervoor dat &gpgsm; deze &URL;'s negeert en alleen de boven ingestelde gebruikt.

  Dit ⪚ gebruiken om het gebruik van een organisatie-brede &ocsp; proxy af te dwingen.

#### Validatieopties instellen

Certificaatbeleid niet controleren

- Standaard gebruikt &gpgsm; het bestand `~/.gnupg/policies.txt` om te controleren of een certificaatbeleid toegestaan is. Wanneer deze optie is geselecteerd wordt het beleid niet gecontroleerd.

Nooit een CRL raadplegen

- Als deze optie ingeschakeld is, worden Certificate Revocation Lists nooit gebruikt om &smime;-certificaten te valideren.

Sta toe om het hoofdcertificaat als vertrouwd te markeren

- Als deze optie is geactiveerd, terwijl een root-&ca;-certificaat wordt geïmporteerd, zult u worden gevraagd om zijn vingerafdruk te bevestigen en te verklaren of u wel of niet dit root-certificaat vertrouwd.

  Een root-certificaat moet vertrouwd worden voordat de certificaten die het certificeert vertrouwd worden, maar lichtvaardig root-certificaten in uw certificatenopslag vertrouwen zal de veiligheid van het systeem ondermijnen.

  Deze functionaliteit in de backend inschakelen kan leiden tot pop-ups van &pinentry; op ongewenste tijden (⪚ 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 root-certificaat opnieuw te wantrouwen, staat &kleopatra; handmatig instellen van vertrouwen toe met certificates-trust-root en certificates-distrust-root.

  Deze instelling hier heeft geen invloed op het functioneren van &kleopatra;.

Ontbrekende uitgevercertificaten ophalen

- Wanneer deze optie is geactiveerd, zullen ontbrekende uitgevers-certificaten worden opgehaald indien nodig (dit is van toepassing op beide methoden, &crl;'s en &ocsp;).

#### Opties voor &http;-verzoeken instellen

Geen HTTP-verzoeken uitvoeren

- Schakelt het gebruik van &http; voor &smime; geheel uit.

HTTP CRL-distributiepunt van certificaten negeren

- Wanneer u de locatie van een &crl; aan het zoeken bent, zal het te testen certificaat items bevatten onder de naam &crl; Distribution Point (DP). Deze bevatten &URL;'s die het adres van de &crl; beschrijven. Het eerste gevonden DP wordt gebruikt.

  Met deze optie worden alle items met het &http;-schema genegeerd wanneer er gezocht wordt naar een geschikte DP.

HTTP-proxy van systeem gebruiken

- 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 `http_proxy`).

Deze proxy voor HTTP-verzoeken gebruiken

- Als er geen systeemproxy is ingesteld of u moet een andere proxy voor &gpgsm;, gebruiken, dan kunt u hier de locatie invoeren.

  Het zal voor alle &HTTP;-verzoeken gerelateerd aan S/&MIME; worden gebruikt.

  De syntaxis is ``hostnaam``:``poort``, ⪚ `mijnproxy.nergens.nl:3128.`.

#### Opties voor &ldap;-verzoeken instellen

Geen LDAP-verzoeken uitvoeren

- Schakelt het gebruik van &ldap; voor &smime; geheel uit.

LDAP CRL-distributiepunt van certificaten negeren

- Wanneer u de locatie van een &crl; aan het zoeken bent, zal het te testen certificaat items bevatten onder de naam "&crl; Distribution Point" (DP). Deze bevatten &URL;'s die het adres van de &crl; beschrijven. Het eerste gevonden DP wordt gebruikt.

  Met deze optie worden alle items met het &ldap;-schema genegeerd wanneer er gezocht wordt naar een geschikte DP.

Primaire host voor LDAP-verzoeken

- Hier een &ldap;-server invoeren maakt dat alle &ldap;-verzoeken eerst naar die server gaan. Meer precies, deze instelling overschrijft elke gespecificeerde `hostnaam` en `poort` in een &ldap;-&URL; en zal ook worden gebruikt als `hostnaam` en `poort` uit de &URL; zijn weggelaten.

  Andere &ldap;-servers zullen alleen worden gebruikt als de verbinding naar de proxy mislukt. De syntaxis is ``hostnaam`` of ``hostnaam``:``poort``. Als `poort` wordt weggelaten, dan wordt poort 389 (de standaard &ldap;-poort) gebruikt.

### Het &gnupg;-systeem instellen

Dit deel van de dialoog is automatisch gegenereerd uit de uitvoer van `gpgconf `--list-components`` en voor elke `component` die het bovenstaande commando terug geeft, de uitvoer van `gpgconf `--list-options` `component``.

De meest nuttige van deze opties zijn overgenomen als aparte pagina's in de instellingendialoog van &kleopatra;. Zie configuration-directory-services en configuration-smime-validation voor de twee dialoogpagina's die geselecteerde opties bevatten uit dit gedeelte van de dialoog.

De exacte inhoud van dit gedeelte van de dialoog hangt af van de versie van de geïnstalleerde &gnupg;-backend en, in principe, van het platform waarop u werkt. We zullen dus alleen de algemene indeling van de dialoog, inclusief het overeen laten komen van de &gpgconf;-optie met de &GUI; besturing van &kleopatra;.

&gpgconf; geeft configuratie-informatie voor meerdere componenten terug. Binnen elke component worden individuele opties gecombineerd in groepen.

&kleopatra; toont één tabblad per door &gpgconf; gerapporteerde component; groepen krijgen een kop met een horizontale lijn met de groepsnaam zoals teruggeven door &gpgconf;.

Elke optie van &gpgconf; heeft een type. Behalve voor bepaalde welbekende opties, die &kleopatra; ondersteunt met gespecialiseerde besturing voor een betere gebruikerservaring, is de koppeling tussen &gpgconf;-types en besturing van &kleopatra; als volgt:

### Koppeling tussen &gpgconf;-types en &GUI;-besturing

&gpgconf;-type | Besturing van &kleopatra;
voor lijsten | voor niet-lijsten
`geen` | Numeriek keuzeveld (getallen-semantiek) | Keuzevakje
`tekenreeks` | &NA; | Regelinvoer
`int32` | Regelinvoer (ongeformatteerd) | Draaiveld
`uint32`
`padnaam` | &NA; | gespecialiseerde besturing
`LDAP-server` | gespecialiseerde besturing | &NA;
`vingerafdruk van sleutel` | &NA;
`publieke sleutel`
`geheime sleutel`
`aliaslijst`

Zie het handboek van &gpgconf; voor meer informatie over wat u hier in kunt stellen en hoe.

## Systeembeheerdersgids

De systeembeheerdersgids beschrijft de manieren waarop &kleopatra; kan worden aangepast, die niet toegankelijk zijn via de &GUI;, maar alleen via de instellingenbestanden.

De veronderstelling is dat de lezer bekend is met de technologie die wordt gebruikt voor het instellen van &kde; toepassingen, inclusief de indeling, locatie van het bestandssysteem en opstapelen van instellingenbestanden, evenals het KIOSK-framework.

### Aanpassen van de assistent Certificaat aanmaken

#### Aanpassen van de &dn;-velden

&kleopatra; stelt u in staat de velden, die de gebruiker mag invoeren, aan te passen om hun certificaat aan te maken.

Maak een groep genaamd `CertificateCreationWizard` in de systeembrede `kleopatrarc`. Als u een eigen volgorde van attributen wilt of als u alleen bepaalde items wilt laten verschijnen, maak dan een sleutel genaamd `DNAttributeOrder`. Het argument is een of meer uit `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL`. Als u velden met een bepaalde waarde wilt initialiseren, schrijf dan zoiets als Attribuut=waarde. Als u het attribuut als vereist wilt behandelen, voeg dan een uitroepteken achter (bijv. `CN!,L,OU,O!,C!,EMAIL!`, hetwelk de standaard instelling is).

Met gebruik van de KIOSK modus-modifier `$e` kunt u de waarden uit omgevingsvariabelen halen of uit een uitgevoerd script of binair programma. Als u bovendien bewerking van het respectievelijke wilt verbieden, gebruik dan de modifier `$i`. Als u het gebruik van de knop Mijn adres invoegen wilt verbieden, zet `ShowSetWhoAmI` dan op false.

Vanwege de aard van het &kde; KIOSK framework, maakt het gebruik van de niet-te-vervangen vlag (`$i`) het voor de gebruiker onmogelijk om de vlag te negeren. Dit is bewust gedrag. `$i` en `$e` kunnen ook worden gebruikt met alle andere instellingensleutels in &kde; toepassingen.

Het volgende voorbeeld legt uit wat de mogelijke aanpassingen zijn:

    [CertificateCreationWizard]
    ;Sta niet toe persoonlijke gegevens uit het adresboek te kopiëren, evenzo lokaal overschrijven
    ShowSetWhoAmI[$i]=false

    ;stelt de gebruikersnaam in op $USER
    CN[$e]=$USER

    ;stelt de bedrijfsnaam in op "Mijn bedrijf", bewerken niet toegestaan
    O[$i]=Mijn bedrijf

    ;stelt de afdelingsnaam in op een waarde teruggegeven door een script
    OU[$ei]=$(lookup_dept_from_ip)

    ; stel het land in op NL, maar mag door de gebruiker gewijzigd worden
    C=NL

#### Beperken van de types sleutels die een gebruiker mag aanmaken

&kleopatra; kan ook beperken welk type certificaten een gebruiker mag aanmaken. Let op, hier is gemakkelijk omheen te gaan, de gebruiker kan deze nog steeds op de opdrachtregel aanmaken.

##### Algoritmes voor publieke sleutels

Om het te gebruiken algoritme voor de publieke sleutel te beperken, voegt u de configuratiesleutel `PGPKeyType` (en `CMSKeyType`, echter alleen RSA is voor CMS ondersteund) aan de sectie `CertificateCreationWizard` van `kleopatrarc` toe.

De toegestane waarden zijn `RSA` voor RSA-sleutels, `DAS` voor DSA-sleutels (alleen ondertekenen) en `DSA+ELG` voor een DSA-sleutel (alleen ondertekenen) met een Elgamal-subsleutel voor versleuteling.

De standaard wordt gelezen uit &gpgconf; of is anders `RSA` als &gpgconf; geen standaard levert.

##### Grootte publieke sleutel

Om de beschikbare sleutellengtes voor een publiek algoritme te beperken, voegt u de configuratiesleutel ``<ALG>`KeySizes` (waar `ALG` `RSA`, `DSA` of `ELG`) mag zijn, toe aan de sectie `CertificateCreationWizard` van `kleopatrarc`, die een komma-gescheiden lijst van sleutellengtes (in bits) bevat. Een standaard kan worden aangeduid door de sleutellengte te laten voorafgaan door een minteken (`-`).

    RSAKeySizes = 1536,-2048,3072

Het bovenstaande beperkt de toegestane RSA sleutelgrootte tot 1536, 2048 en 3072, met 2048 als de standaard.

Naast de lengtes zelf, mag u labels voor elk van de lengtes specificeren. Stel eenvoudig de configuratiesleutel in op ``ALG`KeySizeLabels` in op een komma-gescheiden lijst van labels.

    RSAKeySizeLabels = weak,normal,strong

Het bovenstaande, in combinatie met het vorige voorbeeld, zou zoiets als de volgende opties voor selectie laten zien:

    weak (1536 bits)
                  normal (2048 bits)
                  strong (3072 bits)

De standaarden zijn zoals het volgende laat zien:

    RSAKeySizes = 1536,-2048,3072,4096
                  RSAKeySizeLabels =
                  DSAKeySizes = -1024,2048
                  DSAKeySizeLabels = v1,v2
                  ELGKeySizes = 1536,-2048,3072,4096

### Sleutelcategorieën aanmaken en bewerken

&kleopatra; stelt de gebruiker in staat om het visuele uiterlijk van toetsen gebaseerd op een concept genaamd Sleutelcategorieën. Sleutelcategorieën worden ook gebruikt om de lijst met certificaten te filteren. Deze sectie beschrijft hoe u de beschikbare categorieën kunt bewerken en nieuwe kan toevoegen.

Bij het proberen om de categorie te vinden waar een sleutel bij hoort, probeert &kleopatra; om de sleutel te laten overeenkomen met een serie sleutelfilters, geconfigureerd in `libkleopatrarc`. De eerste die overeenkomt definieert de categorie, gebaseerd op een concept van meer specifiek, hieronder nader verklaart.

Elke sleutelfilter is gedefinieerd in een configuratiegroep genaamd `Key Filter #`n``, waar `n` een getal is, beginnend bij `0`.

De enige verplichte sleutels in een `Key Filter #`n``-groep zijn `Name`, bevattende de naam van de categorie zoals getoond in de Instellingendialoog en `id`, die wordt gebruikt als een referentie naar het filter in andere instellingensecties (zoals `View #`n``).

table-key-filters-appearance toont alle sleutels die de weergaveeigenschappen van sleutels behorende bij die categorie (&ie; die sleutels die aangepast kunnen worden in de instellingendialoog), terwijl table-key-filters-criteria alle sleutels die de criteria definiëren van het filter waartegen de sleutels worden gehouden.

### Instellingensleutels voor sleutelfilters die weergave-eigenschappen definiëren

Configuratiesleutel | Type | Beschrijving
`background-color` | kleur | De te gebruiken achtergrondkleur. Is standaard de achtergrondkleur die globaal is gedefinieerd voor weergave van lijsten, indien deze ontbreekt.
`foreground-color` | kleur | De te gebruiken voorgrondkleur. Is standaard de voorgrondkleur die globaal is gedefinieerd voor weergave van lijsten, indien deze ontbreekt.
`font` | lettertype | Het aangepaste te gebruiken lettertype. Het lettertype zal worden geschaald tot de grootte ingesteld voor weergave van lijsten en elke attribuut van lettertypes (zie onder) zal worden toegepast.
`font-bold` | boolean | Indien ingesteld op `true` en `font` is niet ingesteld, wordt het standaard lettertype gebruikt voor lijstweergave met de stijl vet toegevoegd (indien beschikbaar). Genegeerd als `font` ook aanwezig is.
`font-italic` | boolean | Analoog aan `font-bold`, maar voor de lettertypestijl cursief in plaats van vet.
`font-strikeout` | boolean | Indien `true`, tekent een gecentreerde lijn over het lettertype. Wordt zelfs toegepast als `font` is ingesteld.
`icon` | tekst | De naam van een pictogram om de eerste kolom te tonen. Nog niet geïmplementeerd.

### Instellingensleutels voor sleutelfilters die filtercriteria definiëren

Configuratiesleutel | Type | Indien gespecificeerd, filter komt overeen wanneer...
`is-revoked` | boolean | de sleutel is ingetrokken.
`match-context` | context Context is een opsomming met de volgende toegestane waarden: `appearance`, `filtering` and `any`. | de context waarin dit filter overeenkomt.
`is-expired` | boolean | de sleutel is verlopen.
`is-disabled` | boolean | de sleutel is uitgeschakeld (gemarkeerd voor niet-gebruiken) door de gebruiker. Genegeerd voor &smime;-sleutels.
`is-root-certificate` | boolean | de sleutel is een root-certificaat. Genegeerd voor &openpgp;-sleutels.
`can-encrypt` | boolean | de sleutel kan gebruikt worden voor versleuteling.
`can-sign` | boolean | de sleutel kan gebruikt worden voor ondertekening.
`can-certify` | boolean | de sleutel kan gebruikt worden voor ondertekening (certificeren) van andere sleutels.
`can-authenticate` | boolean | de sleutel kan gebruikt worden voor authenticatie (⪚ als een TLS client-certificaat).
`is-qualified` | boolean | de sleutel kan gebruikt worden om Qualified Signatures te maken (zoals gedefinieerd door de Duitse Digital Signature Law).
`is-cardkey` | boolean | de sleutel is opgeslagen op een smartcard (in plaats van op de computer).
`has-secret-key` | boolean | de geheime sleutel voor dit sleutelpaar is beschikbaar.
`is-openpgp-key` | boolean | de sleutel is een &openpgp;-sleutel (`true`) of een &smime;-sleutel (`false`).
`was-validated` | boolean | de sleutel is gevalideerd.
``voorloop`-ownertrust` | geldigheid Geldigheid is een (geordende) opsomming met de volgende toegestane waarden: `unknown`, `undefined`, `never`, `marginal`, `full`, `ultimate`. Zie de handboeken van &gpg; en &gpgsm; voor een gedetailleerde uitleg. | de sleutel heeft exact (`voorloop` = `is`), heeft alles behalve (`voorloop` = `is-not`), heeft minstens (`voorloop` = `is-at-least`) of heeft hooguit (`voorloop` = `is-at-most`) het ownertrust gegeven als de waarde van de instellingssleutel. Als meer dan één sleutel ``voorloop`-ownertrust` (met een verschillende `voorloop`-waarde) aanwezig zijn in een enkele groep, dan is het gedrag niet gedefinieerd.
``voorloop`-validity` | geldigheid | Analoog aan ``voorloop`-ownertrust`, maar dan voor de sleutel validity in plaats van ownertrust.

Sommige van de meer interessante criteria, zoals `is-revoked` of `is-expired` zal alleen werken op gevalideerde sleutels, dit is waarom, standaard, alleen gevalideerde sleutels gecontroleerd worden op ingetrokken en verlopen, hoewel u vrij bent om deze extra controles te verwijderen.

Naast de boven weergegeven configuratiesleutels, kan een sleutelfilter ook een `id` en `match-contexts` hebben.

Met het gebruik van het `id` van het filter, die standaard de naam van de configuratiegroep van het filter heeft, indien niet gegeven of leeg, kunt u elders in de configurati aan het sleutelfilter refereren, ⪚ in weergaveinstellingen van &kleopatra;. De `id` wordt door &kleopatra; niet geïnterpreteerd, zodat u elke gewenste tekenreeks kunt gebruiken, als deze maar uniek is.

De `match-contexts` beperkt de toepasbaarheid van het filter. Er zijn nu twee contexten gedefinieerd: De context `appearance` wordt gebruikt bij het definiëren van de kleuren en eigenschappen van lettertypes voor de weergaven. De context `filtering` wordt gebruikt om selectief certificaten mee te nemen (en uit te sluiten) in weergaven. `any` kan worden gebruikt om alle nu gedefinieerde contexten aan te duiden en is de standaard als `match-contexts` niet is gegeven of anders geen contexten oplevert. Dit verzekert dat geen sleutelfilter dead kan eindigen, &ie; zonder dat er een contexts op is toegepast.

Het formaat van het item is een lijst met tokens, gescheiden door niet-woord tekens. Elk van de tokens geeft optioneel een voorloop van een uitroepteken (`!`), hetgeen negatie betekent. De tokens werken in volgorde op een interne lijst met contexten, die leeg beginnen. Dit is het best uitgelegd met een voorbeeld: `any !appearance` is hetzelfde als `filtering` en `appearance !appearance` levert de lege verzameling, evenals `!any`. De laatste twee, echter, zullen intern vervangen worden door `any`, omdat ze helemaal geen contexts opleveren.

In het algemeen worden niet gespecificeerde criteria (&ie; het configuratie-item is niet ingesteld) niet gecontroleerd. Als er een criterium is gegeven, dan wordt er op gecontroleerd en moet als geheel overeenkomen met het filter om overeen te komen, &ie; aan alle criteria moet voldaan (en-functie).

Elk filter heeft een impliciete specificity die wordt gebruikt om alle overeenkomende filters een waardering te geven. Het meer specifieke filter wint boven minder specifieke filters. Als twee filters dezelfde specificity hebben, dan wint degene die als eerste in het instellingenbestand staat. Een specificity is evenredig aan het aantal criteria die het bevat.

#### Voorbeelden van sleutelfilters

Om op alle verlopen, maar niet-ingetrokken root-certificaten, te controleren zou u een sleutelfilter als volgt gedefinieerd kunnen gebruiken:

    [Key Filter #n]
    Name=verlopen, maar niet ingetrokken
    was-validated=true
    is-expired=true
    is-revoked=false
    is-root-certificate=true
    ; ( specificity 4 )

Om te controleren op alle uitgeschakelde &openpgp;-sleutels (nog niet ondersteund door &kleopatra;) met eigenaarsvertrouwen van minstens marginaal, zou u moeten gebruiken:

    [Key Filter #n]
    Name=uitgeschakelde OpenPGP-sleutels met marginale of beter eigenaarsvertrouwen
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

### Archiveerders instellen voor gebruik met ondertekenen/versleutelen van bestanden

&kleopatra; stelt de systeembeheerder (en grootgebruiker) in staat om de lijst met archiveerders, die gepresenteerd worden in de dialoog voor ondertekenen/versleutelen van bestanden, in te stellen.

Elke archiveerder is gedefinieerd in `libkleopatrarc` als een aparte `Archive Definition #`n`` groep, met de volgende verplichte elementen:

`extensies`

- Een komma-gescheiden lijst met bestandsnaamextensies die gewoonlijk dit formaat archief aangeven.

`id`

- Een unieke ID gebruikt om deze archiveerder intern te identificeren. Bij twijfel gebruikt u de naam van het commando.

`Name` (vertaald)

- De naam van deze archiveerder, zichtbaar voor de gebruiker, zoals getoond in het overeenkomende afrolmenu van de dialoog voor ondertekenen/versleutelen van bestanden.

`pack-command`

- Het actuele commando om bestanden te archiveren. U kunt elk commando gebruiken, als er geen shell nodig is om het uit te voeren. Het programmabestand wordt opgezocht met de omgevingsvariabele `PATH`, tenzij u een absoluut bestandspad gebruikt. Gebruik van aanhalingstekens is ondersteund alsof een shell wordt gebruikt:

      pack-command="/opt/ZIP v2.32/bin/zip" -r -

Omdat de backslash (`\`) een escape-teken is in &kde; configuratiebestanden, moet u ze verdubbelen wanneer ze in padnamen verschijnen:

    pack-command=C:\\Programs\\GNU\\tar\\gtar.exe ...

Voor het commando zelf echter (in tegenstelling tot zijn argumenten), mag u gewoon voorwaartse slashes (`/`) op alle platforms als padscheidingstekens gebruiken:

    pack-command=C:/Programs/GNU/tar/gtar.exe ...

Dit wordt niet ondersteund in argumenten, omdat de meeste &Windows;-programma's de voorwaartse slash voor opties gebruiken. Het volgende zal echter niet werken, omdat `C:/myarchivescript.bat` een argument voor `cmd.exe` en `/` niet in argumenten geconverteerd wordt naar `\`, alleen commando's:

    pack-command=cmd.exe C:/myarchivescript.bat

Dit moet, in plaats hiervan, geschreven worden als:

    pack-command=cmd.exe C:\\myarchivescript.bat

#### Doorgeven van bestandsnamen voor invoer aan `pack-command`

Er zijn drie manieren om bestandsnamen door te geven aan het commando pack. Voor elk van deze biedt `pack-command` een specifieke syntaxis:

1. Als argumenten in de opdrachtregel.

   Voorbeeld (tar):

       pack-command=tar cf -

   Voorbeeld (zip):

       pack-command=zip -r - %f

   In dit geval worden bestandsnamen doorgegeven op de opdrachtregel, net zoals u zou doen bij een prompt. &kleopatra; gebruikt geen shell om de opdracht uit te voeren. Daarom is dit een veilige manier om bestandsnamen door te geven, maar op sommige platforms kan dat leiden tot beperkingen van de lengte van deze regel. Een literal `%f`, indien aanwezig, wordt vervangen door de namen van de te archiveren bestanden. Anders worden bestandsnamen achtergevoegd op de opdrachtregel. Dus kan het voorbeeld van zip hierboven ook geschreven worden als:

       pack-command=zip -r -

2. Via standaard-invoer, gescheiden door nieuwe-regels: voeg voor `|`.

   Voorbeeld (&GNU;-tar):

       pack-command=|gtar cf - -T-

   Voorbeeld (ZIP):

       pack-command=|zip -@ -

   In dit geval worden bestandsnamen doorgegeven naar de archiveringstoepassing via stdin, een per regel. Dit vermijdt problemen op platforms die een lage limiet zetten op het aantal toegestane argumenten op de opdrachtregel, maar mislukt wanneer bestandsnamen, in feite nieuwe-regels bevatten.

   &kleopatra; ondersteunt nu alleen LF als een nieuwe-regel scheidingsteken, niet CRLF. Dit kan wijzigen in toekomstige versies, gebaseerd op terugkoppeling van de gebruiker.

3. Via standaard-invoer, gescheiden door NUL-bytes: voeg voor `0|`.

   Voorbeeld (&GNU;-tar):

       pack-command=0|gtar cf - -T- --null

   Dit is hetzelfde als boven, behalve dat NUL-bytes worden gebruikt om bestandsnamen te scheiden. Omdat NUL-bytes verboden zijn in bestandsnamen, dit is de meest robuuste manier van het doorgeven van bestandsnamen, maar niet alle archiveringstoepassingen ondersteunen het.

### Programma's voor controlesommen voor gebruik bij aanmaken/verifiëren van controlesommen

&kleopatra; stelt de beheerder (en power-gebruiker) in staat om de lijst met programma's voor controlesommen in te stellen, waaruit de gebruiker kan kiezen in de instellingendialoog en die &kleopatra; automatisch kan detecteren wanneer deze gevraagd wordt om de controlesom van een gegeven bestand te verifiëren.

Om bruikbaar te zijn voor &kleopatra; moet de uitvoer van programma's voor controlesommen (zowel het geschreven controlesombestand als de uitvoer op stdout bij verifiëren van controlesommen) compatibel zijn met &GNU; `md5sum` en `sha1sum`.

Het controlesombestand moet op regels gebaseerd zijn met in elke regel het volgende formaat:

    CONTROLESOM ' ' ( ' ' | '*' ) BESTANDSNAAM

waar `CONTROLESOM` alleen bestaat uit hex-tekens. Als `BESTANDSNAAM` een teken nieuwe-regel bevat, moet de regel er uit als volgt uitzien:

    \CONTROLESOM ' ' ( ' ' | '*' ) ESCAPED-BESTANDSNAAM

waar `ESCAPED-BESTANDSNAAM` de bestandsnaam is met nieuwe-regel vervangen door `\n` en backslashes verdubbeld (`\`↦`\\`).

Evenzo moet de uitvoer van checksum-definition-verify-command van de vorm

    BESTANDSNAAM ( ': OK' | ': FAILED' )

zijn gescheiden door nieuwe-regels. Nieuwe-regels en andere tekens worden niet escaped in de uitvoer.

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 ": OK" plus nieuwe-regel bevatten, te gebruiken.

Elk programma voor controlesommen is gedefinieerd in `libkleopatrarc` als een aparte `Checksum Definition #`n`` groep, met de volgende verplichte elementen:

`bestandspatronen`

- 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.

  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.

  Het platform definieert of de patronen behandeld worden met of zonder onderscheid tussen hoofd- en kleine letter.

`uitvoerbestand`

- De typische naam van het uitvoerbestand voor dit programma voor controlesommen (zou natuurlijk overeen moeten komen met een van de checksum-definition-file-patterns). Dit is wat &kleopatra; zal gebruiken als de uitvoerbestandsnaam bij het aanmaken van bestanden met controlesommen van dit type.

`id`

- Een unieke ID gebruikt om dit programma voor controlesommen intern te identificeren. Bij twijfel gebruikt u de naam van het commando.

`Name` (vertaald)

- De voor de gebruiker zichtbare naam van dit programma voor controlesommen, zoals getoond in het afrolmenu in de configuratiedialoog van &kleopatra;.

`create-command`

- Het actuele commando waarmee controlesombestanden worden aangemaakt. De syntax, beperkingen en opties voor argumentenoverdracht zijn hetzelfde als beschreven voor archive-definition-pack-command in admin-archive-definitions.

`verify-command`

- Hetzelfde als checksum-definition-create-command, echter voor verificatie van de controlesom.

Hier is een volledig voorbeeld:

    [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

## Dankbetuiging en licentie

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

Documentatie copyright 2002 &Steffen.Hansen;, copyright 2004 &Daniel.Molkentin;, copyright 2004, 2010 Klarälvdalens Datakonsult AB

## Medewerkers

- &Marc.Mutz; &Marc.Mutz.mail;

- &David.Faure; &David.Faure.mail;

- &Steffen.Hansen; hansen@kde.org

- &Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail;

- &Jesper.Pedersen; &Jesper.Pedersen.mail;

- &Daniel.Molkentin; &Daniel.Molkentin.mail;

&meld.fouten;&vertaling.freek; &underFDL; &underGPL;
&documentation.index;