# Handbok &kleopatra;

## Inledning

&kleopatra; är ett &kde;-verktyg för att hantera &x509;- och &openpgp;-certifikat i &gpgsm; och &gpg;, samt för att hämta certifikat från &ldap; och andra certifikatservrar.

&kleopatra; kan startas från &kmail;s meny Verktyg Certifikathantering, samt från kommandoraden. Det körbara programmet &kleopatra; heter ``kleopatra``.

Programmet är uppkallat efter Kleopatra, en berömd kvinnlig egyptisk farao som levde samtidigt som Julius Caesar, med vilken hon hade ett barn, Caesarion, dock inte erkänd som hans arvinge.

Namnet valdes eftersom programmet har sitt ursprung i projektet Ägypten (Ägypten är tyska för Egypten). &kleopatra; stavas också på samma sätt på tyska.

## Huvudfunktioner

### Visa den lokala nyckellådan

&kleopatra;s huvudfunktion är att visa och redigera innehållet i den lokala nyckellådan, vilket liknar konceptet i &gpg; med nyckelringar, även om man inte ska läsa ut för mycket ur jämförelsen.

Huvudfönstret är uppdelat i ett stort område för att lista nycklar som består av flera flikar, menyraden och sökraden längst upp, och en statusrad längst ner.

Varje rad i nyckellistan motsvarar ett certifikat, som identifieras av det så kallade Subjekt &dn;. &dn; är en förkortning som betyder Distinguished Name (särskiljande namn), en hierarkisk identifiering som i mycket liknar en sökväg i filsystemet med en ovanlig syntax, som är avsett att unikt identifiera ett givet certifikat i hela världen.

För att vara giltiga, och sålunda användbara, måste (öppna) nycklar vara signerade av en certifikatutfärdare (&ca;). Signaturerna kallas certifikat, men oftast används begreppen certifikat och (öppen) nyckel omväxlande, och vi skiljer inte heller på dem i den här handboken, utom när det anges explicit.

Certifikatutfärdare måste i sin tur vara signerade av andra certifikatutfärdare för att vara giltiga. Det här måste förstås sluta någonstans, så certifikatutfärdare på toppnivå (rotcertifikatutfärdare) signerar sin nyckel själv (det kallas en självsignatur). Rotcertifikat måste därför tilldelas giltighet (vanligen kallad pålitlighet) för hand, dvs. efter att ha jämfört fingeravtrycket med det som finns på certifikatutfärdarens webbplats. Det görs typiskt av systemadministratören eller leverantören av en produkt som använder certifikat, men kan också göras av användaren via &gpgsm;s kommandoradsgränssnitt.

För att se vilka certifikat som är rotcertifikat, byter du till hierarkiskt läge för nyckellistan med view-hierarchical-key-list.

Du kan se detaljinformation för vilket certifikat som helst genom att dubbelklicka på det, eller använda view-certificate-details. Då öppnas en dialogruta som visar de vanligaste egenskaperna hos certifikatet, dess certifikatkedja (dvs. kedjan av utfärdare upp till rotcertifikatutfärdaren), och en utskrift av all information som gränssnittet kan extrahera från certifikatet.

Om du ändrar nyckellådan utan att använda &kleopatra; (t.ex. genom att använda kommandoradgränssnittet i &gpgsm;), kan du uppdatera vyn med view-redisplay.

### Söka efter och importera certifikat

För det mesta skaffar du nya certifikat genom att kontrollera signaturer i e-post, eftersom certifikat oftast är inbäddade i signaturerna som skapats med dem. Om du dock behöver skicka ett brev till någon som du ännu inte har haft kontakt med, måste du hämta certifikatet från en &ldap;-katalog (även om &gpgsm; kan göra det automatiskt), eller från en fil. Du måste också importera ditt eget certifikat efter att ha tagit emot certifikatutfärdarens svar på din certifikatbegäran.

För att söka efter ett certifikat i en &ldap;-katalog, välj Arkiv Slå upp certifikat på server och skriv in någon text (t.ex. namnet på personen vars certifikat du vill ha) med redigeringsraden i dialogrutan Nyckelserver certifikatuppslagning, och klicka därefter på knappen Sök. Resultaten visas i nyckellistan under sökraden, där du kan markera certifikat för att titta på dem genom att klicka på knappen Detaljinformation eller ladda ner dem till den lokala nyckellådan med Importera.

Du kan ställa in listan med &ldap;-servrar som ska sökas i på sidan Katalogtjänster i &kleopatra;s inställningsdialogruta.

Om du tog emot certifikatet som en fil, försök med file-import-certificates. &gpgsm; måste förstå certifikatfilens format. Se handboken för &gpgsm; för en lista med filformat som stöds.

Om du inte skapade ditt eget nyckelpar med &gpgsm;, måste du också manuellt importera den öppna nyckeln (och den hemliga nyckeln) från PKCS#12-filen du fick från certifikatutfärdaren. Du kan göra det från kommandoraden med ``kleopatra `--import-certificate` `filnamn``` eller inne i &kleopatra; med file-import-certificates, precis som du skulle göra för normala certifikat.

### Skapa nya nyckelpar

Menyalternativet file-new-key-pair startar Guide för att skapa nyckelpar, som leder dig genom ett antal steg för att skapa en begäran om ett certifikat.

Så fort du är klar med ett steg i guiden, tryck på Nästa för att gå till nästa steg (eller Tillbaka för att kontrollera steg som redan är färdiga). Skapandet av begäran om certifikat kan avbrytas när som helst genom att trycka på knappen Avbryt.

Välj vilken typ av certifikat du vill skapa på guidens första sida:

Skapa ett personligt OpenPGP-nyckelpar

- &openpgp;-nyckelpar skapas lokalt, och certifieras av dina vänner och bekanta. Det finns ingen central certifikatutfärdare, istället skapar varje individ ett personligt pålitlighetsnät genom att certifiera andra användares nyckelpar med sitt eget certifikat.

  Du måste skriva in Namn, E-post och en valfri Kommentar.

Skapa ett personligt X.509-nyckelpar och en personlig certifikatbegäran

- &x509;-nyckelpar skapas lokalt, men certifieras centralt av en certifikatutfärdare (&ca;). En &ca; kan certifiera andra certifikatutfärdare, vilket skapar en central hierarkiskt pålitlighetskedja.

  Nästa steget i guiden är att skriva in din personliga data för certifikatet. Fälten som ska fyllas i är:

  - Vanligt namn (CN): Ditt namn.

  - E-postadress (EMAIL): Din e-postadress. Försäkra dig om att du skriver in den rätt — det är adressen som alla skickar brev till när de använder ditt certifikat.

  - Plats (L): Staden eller kommunen du bor i.

  - Avdelning (OU): Enheten i organisationen där du finns (till exempel "Logistik").

  - Organisation (O): Organisationen du representerar (t.ex. företaget du arbetar på).

  - Landskod (C): Koden med två bokstäver för landet du bor i (till exempel "SE").

  Nästa steg i guiden är att välja om certifikatet ska lagras i en fil eller skickas direkt till certifikatutfärdaren. Du måste ange filnamn eller e-postadress dit begäran om certifikatet ska skickas.

#### Återkalla en nyckel

Ett nyckelpar som har utgått kan återställas till användbart skick under förutsättning att du har tillgång till den privata nyckeln och lösenordsfrasen. För att göra en nyckel oanvändbar på ett tillförlitligt sätt måste den återkallas. Att återkalla görs genom att lägga till en särskild återkallelsesignatur i nyckeln.

Denna återkallelsesignatur lagras den i en separat fil. Filen kan senare importeras till nyckelringen och ansluts då till nyckeln och gör den oanvändbar. Observera att inget lösenord krävs för att importera signaturen till nyckeln. Därför bör återkallelsesignaturen lagras på ett säkert ställe, oftast ett som skiljer sig från platsen där nyckelparet lagras. Ett gott råd är att använda en plats som kan kopplas från datorn, genom att antingen kopiera den till en extern lagringsenhet som en USB-sticka eller skriva ut den.

&kleopatra; tillhandahåller inte en funktion för att skapa en sådan återkallelsesignatur när som helst, men du kan göra det med &kde;-programmet &kgpg; genom att välja Nycklar Återkalla nyckel och valfritt importera återkallelsesignaturen till din nyckelring omedelbart.

Ett alternativt sätt att skapa ett återkallelsecertifikat är att använda &gpg; direkt från kommandoraden: `gpg --output `återkallelsecertifikat`.asc --gen-revoke `nyckel``. Argumentet `nyckel` måste vara en nyckelspecifikation, antingen nyckel-id för ditt primära nyckelpar eller någon del av ett användar-id som identifierar ditt nyckelpar.

## Menyreferens

### Menyn Arkiv

&Ctrl;N Arkiv Nytt certifikat...

- Skapar ett nytt nyckelpar (öppen och hemlig) och låter dig skicka den öppna delen till en certifikatutfärdare (&ca;) för signering. Det resulterande certifikatet skickas sedan tillbaka till dig, eller lagras på en &ldap;-server så att du kan ladda ner det till din lokala nyckelserver, där du kan använda den för att signera och avkoda e-post.

  Det här arbetssättet kallas decentraliserad nyckelframtagning, eftersom alla nycklar skapas lokalt. &kleopatra; (och &gpgsm;) stöder inte centraliserad nyckelframtagning direkt, men du kan importera nyckelknippan med öppen och hemlig nyckel som du tog emot från certifikatutfärdaren med PKCS#12-format via file-import-certificates.

&Ctrl;&Shift;I Arkiv Slå upp certifikat på server...

- Söker efter, och importerar certifikat från certifikatservrar till den lokala nyckellådan. Se functions-search för detaljinformation.

  Nyckelservrar måste vara inställda för att det ska fungera. Se configuration-directory-services för mer information.

&Ctrl;I Arkiv Importera certifikat...

- Importerar certifikat och/eller hemliga nycklar från filer till den lokala nyckellådan. Se functions-search för detaljinformation.

  Certifikatfilens format ska vara ett som kan förstås av &gpgsm;/&gpgsm;. Se manualen för &gpgsm; och &gpg; för en lista av format som stöds.

&Ctrl;E Arkiv Exportera certifikat...

- Exporterar markerade certifikat till en fil.

  Filnamnsändelsen som väljes för exportfilen bestämmer exportfilens format:

  - För &openpgp;-certifikat, ger `gpg` och `pgp` en binärfil, medan `asc` ger en &ascii;-bepansrad fil.

  - För &smime; certifikat, ger `der` en binär, &der;-kodad fil, medan `pem` ger en &ascii;-bepansrad fil.

  Om inte flera certifikat är markerade, föreslår &kleopatra; ``fingeravtryck`.{asc,pem}` som exportfilnamn.

  Funktionen är bara tillgänglig om ett eller flera certifikat har markerats.

  Funktionen exporterar bara de öppna nycklarna, även om de hemliga nycklarna är tillgängliga. Använd file-export-secret-key för att exportera den hemliga nyckeln till en fil.

Arkiv Exportera hemliga nycklar...

- Exporterar den hemliga nyckeln till en fil.

  Du kan välja filnamn för Utdatafil, och om en binär eller &ascii;-bepansrad exportfil ska skapas (ASCII-bepansrad), i dialogrutan som öppnas. Klicka därefter på katalogikonen på höger sida om textrutan Utdatafil och välj katalog och namn på den exporterade filen. Vid export av &smime; hemliga nycklar kan du också välja Lösenordsfrasens teckenuppsättning. Se beskrivningen av väljaren `--p12-charset `teckenuppsättning`` i handboken för &gpgsm; för ytterligare detaljinformation.

  Funktionen är bara tillgänglig om exakt ett certifikat har markerats, och certifikatets hemliga nyckel är tillgänglig.

  Det bör sällan vara nödvändigt att använda funktionen, och om det är det, måste det planeras noggrant. Planering av förflyttning av en hemlig nyckel omfattar bland annat val av transportmedia, och säker borttagning av nyckeldata på den gamla datorn, samt på transportmedia.

&Ctrl;&Shift;E Arkiv Exportera certifikat till server...

- Publicera markerade certifikat på en nyckelserver (bara &openpgp;).

  Certifikatet skickas till certifikatservern inställd för &openpgp; (se configuration-directory-services), om det finns någon, annars till `keys.gnupg.net`.

  Funktionen är bara tillgänglig om åtminstone ett &openpgp; (och inget &smime;) certifikat har markerats.

  När &openpgp;-certifikat har exporterats till en öppen katalogserver, är det nästan omöjligt att ta bort dem igen. Innan du exporterar ditt certifikat till en öppen katalogserver, försäkra dig om att du har skapat ett återkallelsecertifikat så att du kan återkalla certifikatet om det senare behövs.

  De flesta öppna &openpgp; certifikatservrar synkroniserar certifikat mellan varandra, så det är rätt meningslöst att skicka till fler än en.

  Det kan inträffa att en sökning på en certifikatserver inte ger något resultat, fastän du just har skickat ditt certifikat dit. Det beror på att de flesta adresser till öppna nyckelservrar använder roterande DNS för att balansera lasten mellan flera datorer. Dessa datorer synkroniseras med varandra, men oftast bara ungefär var 24:e timme.

Arkiv Avkoda och verifiera filer...

- Avkodar filer och/eller verifierar signaturer för filer.

Arkiv Signera och kryptera filer...

- Signerar och/eller krypterar filer.

&Ctrl;W Arkiv Stäng

- Stänger &kleopatra;s huvudfönster. Det kan återställas från ikonen i systembrickan när som helst.

&Ctrl;Q Arkiv Avsluta

- Avslutar &kleopatra;.

### Menyn Visa

F5 Visa Visa igen

- Uppdaterar certifikatlistan.

  Att använda funktionen är oftast inte nödvändigt, eftersom &kleopatra; övervakar filsystemet efter ändringar och automatiskt uppdaterar certifikatlistan vid behov.

Esc Visa Stoppa åtgärd

- Stoppar (avbryter) alla pågående åtgärder, t.ex. en sökning, nyckellistning eller en nerladdning.

  Funktionen är bara tillgänglig om åtminstone en åtgärd är aktiv.

  På grund av begränsningar i gränssnitt, blockeras åtgärder på ett sådant sätt att den här funktionen inte kommer att kunna avbryta dem direkt, eller överhuvudtaget.

  I sådana fall är det enda sättet att återställa ordningen att döda processerna &scdaemon;, &dirmngr;, &gpgsm; och &gpg;, i den ordningen, via operativsystemets verktyg (`top`, aktivitetshanterare, etc.), till blockeringen av åtgärden försvinner.

Visa Certifikatinformation

- Visar detaljinformation om certifikatet som för närvarande är markerat.

  Funktionen är bara tillgänglig om exakt ett certifikat har markerats.

  Funktionen är också tillgänglig genom att direkt dubbelklicka på motsvarande objekt i listvyn.

Visa Hierarkisk certifikatlista

- Byter mellan hierarkiskt och enkelt läge för certifikatlistan.

  I hierarkiskt läge ordnas certifikat enligt förhållandet utfärdare och subjekt, så det är enkelt att se vilken certifikathierarki som ett givet certifikat tillhör, men ett givet certifikat är svårare att hitta från början (även om du förstås kan använda sökraden).

  I enkelt läge visas alla certifikat i en enkel lista, alfabetiskt sorterade. Ett givet certifikat är enkelt att hitta i detta läge, men det är inte direkt klart vilket rotcertifikat det tillhör.

  Funktionen växlar hierarkiskt läge per flik, dvs. varje flik har sitt eget hierarkiska läge. Det är på detta vis så att man kan ha både en listning med enkelt och hierarkiskt läge, var och en under sin egen flik.

  Hierarkisk visning är för närvarande bara implementerat för &smime; certifikat. Utvecklarna är inte överens om det rätta sättet att visa &openpgp; certifikat hierarkiskt (i huvudsak, överliggande certifikat lika med det signerat av utfärdaren eller överliggande certifikat lika med det signerat av användaren).

&Ctrl;. Visa Expandera alla

- Expanderar alla listobjekt i certifikatlistans vy, dvs. gör alla objekt synliga.

  Det här är normalt när hierarkiskt läge väljes för nyckellistan.

  Du kan förstås fortfarande expandera eller dra ihop varje enskild rad för sig.

  Funktionen är bara tillgänglig när view-hierarchical-key-list är på.

&Ctrl;, Visa Dra ihop alla

- Drar ihop alla listobjekt i certifikatlistans vy, dvs. döljer alla utom toppnivåobjekten.

  Du kan förstås fortfarande expandera eller dra ihop varje enskild rad för sig.

  Funktionen är bara tillgänglig när view-hierarchical-key-list är på.

### Menyn Certifikat

Certifikat Ändra ägarens pålitlighet...

- Ändrar ägarens pålitlighet för det markerade &openpgp; certifikatet.

  Funktionen är bara tillgänglig när exakt ett &openpgp; certifikat är markerat.

Certifikat Lita på rotcertifikat

- Markerar det här (&smime;) rotcertifikatet som pålitligt.

  På ett sätt är det ekvivalent med certificates-change-owner-trust för &smime; rotcertifikat. Man kan dock bara välja mellan fullständig pålitlighet och lita aldrig på, enligt terminologin i &openpgp;.

  Gränssnittet frågar om det importerade rotcertifikatet ska anses pålitligt när rotcertifikatet importeras (via &gpgagent;). Dock måste funktionen explicit aktiveras i gränssnittets inställning (`allow-mark-trusted` i `gpg-agent.conf`, eller antingen GnuPG-system GPG-agent Tillåt klienter att markera nycklar som "pålitliga" eller S/MIME Validation Tillåt att rotcertifikat markeras som pålitliga under configuration).

  Att aktivera funktionen i gränssnittet kan orsaka att dialogrutor från &pinentry; dyker upp vid olämpliga tillfällen (t.ex. när signaturer verifieras), och kan på så sätt blockera behandling av brev vid frånvaro. Av den orsaken, och eftersom det är önskvärt att kunna sluta lita på ett pålitligt rotcertifikat igen, tillåter &kleopatra; att pålitlighet ställs in manuellt.

  På grund av att stöd för funktionen saknas i gränssnittet, måste &kleopatra; arbeta direkt med &gpgsm; pålitlighetsdatabas (`trustlist.txt`). Försäkra dig om att inga andra krypteringsåtgärder pågår som skulle kunna tävla med &kleopatra; om att ändra databasen, när funktionen används.

  Funktionen är bara tillgänglig om exakt ett &smime; rotcertifikat har markerats, och certifikatet ännu inte är pålitligt.

  Använd certificates-distrust-root för att ångra funktionen.

Certifikat Lita inte på rotcertifikat

- Markerar det här (&smime;) certifikatet som opålitligt.

  Funktionen är bara tillgänglig om exakt ett &smime; rotcertifikat har markerats, och certifikatet för närvarande är pålitligt.

  Använt för att ångra certificates-trust-root. Se det för detaljinformation.

Certifikat Certifiera certifikat...

- Låter dig certifiera ett annat &openpgp; certifikat.

  Funktionen är bara tillgänglig om exakt ett &openpgp; certifikat är markerat.

Certifikat Ändra utgångsdatum...

- Låter dig ändra ditt &openpgp; certifikats utgångsdatum.

  Använd funktionen för att utöka livslängden hos dina &openpgp; certifikat, som alternativ till att antingen skapa nya, eller använda obegränsad livslängd (går aldrig ut).

  Funktionen är bara tillgänglig om exakt ett &openpgp; certifikat är markerat, och den hemliga nyckeln är tillgänglig för certifikatet.

Certifikat Ändra lösenordsfras...

- Låter dig ändra din hemliga nyckels lösenordsfras.

  Funktionen är bara tillgänglig om exakt ett certifikat är markerat, och den hemliga nyckeln är tillgänglig för certifikatet. Den kräver ett väldigt nytt gränssnitt, eftersom implementeringen har ändrats från att direkt anropa &gpg; och &gpgsm;, till en &gpgme;-baserad.

  Av säkerhetsskäl efterfrågas både den gamla och den nya lösenodsfrasen av &pinentry;, en separat process. Beroende på plattformen du använder och kvaliteten hos implementeringen av &pinentry;, kan det inträffa att &pinentry;s fönster dyker upp i bakgrunden. Så om du väljer funktionen och ingenting händer, kontrollera operativsystemets aktivitetsfält ifall &pinentry;s fönster är öppet i bakgrunden.

Certifikat Lägg till användar-id...

- Låter dig lägga till ett nytt användar-id till ett &openpgp; certifikat.

  Använd det här för att lägga till nya identiteter i ett befintligt certifikat, som alternativ till att skapa ett nytt nyckelpar. Ett &openpgp; användar-id har följande form:

      Verkligt namn (Kommentar) <E-postadress>

  I dialogrutan som dyker upp när funktionen väljes, frågar &kleopatra; dig om var och en av de tre parametrarna (`Verkligt namn`, `Kommentar` och `E-postadress`) separat, och visar resultatet i en förhandsgranskning.

  Dessa parametrar lyder under samma administratörsbegränsningar som för nya certifikat. Se functions-newkey och admin-certificate-request-wizard för detaljinformation.

  Funktionen är bara tillgänglig när exakt ett &openpgp; certifikat är markerat, och den hemliga nyckeln är tillgänglig för certifikatet.

Delete Certifikat Ta bort

- Tar bort markerade certifikat från den lokala nyckelringen.

  Använd funktionen för att ta bort oanvända nycklar från den lokala nyckellådan. Eftersom certifikat typiskt finns som bilagor i signerad e-post, kan dock verifikation av ett brev göra att nyckeln som just tagits bort dyker upp igen i den lokala nyckellådan. Därför är det troligen bäst att undvika att använda funktionen så mycket som möjligt. När du kommit vilse, använd sökraden eller funktionen view-hierarchical-key-list för att återfå kontrollen över hela uppsättningen med certifikat.

  Det finns ett undantag till det ovanstående. När du tar bort ett av dina egna certifikat, tar du också bort den hemliga nyckeln tillsammans med det. Det medför att du inte kommer att kunna läsa tidigare meddelanden krypterade till dig med det här certifikatet, om du inte har en säkerhetskopia någonstans.

  &kleopatra; varnar dig när du försöker ta bort en hemlig nyckel.

  På grund av &smime; certifkatens hierarkiska natur, tas alla underliggande certifikat också bort om du tar bort en &smime;-utfärdares certifikat (certifikatutfärdares certifikat).

  Det är samma sak som i ett filsystem. När du tar bort en katalog, tar du också bort alla filer och kataloger i den.

  Naturligtvis är funktionen bara tillgänglig om du markerat minst ett certifikat.

Certifikat Hämta innehåll i certifikat

- Visar all information som &gpgsm; har om det markerade (&smime;) certifikatet.

  Se beskrivningen av `--dump-key `nyckel`` i handboken för &gpgsm; för detaljinformation om utmatningen.

### Menyn Verktyg

Verktyg GnuPG-loggvisning...

- Startar &kwatchgnupg;, ett verktyg för att visa felsökningsutmatning från &gnupg;-programmen. Om signering, kryptering eller verifikation slutar fungera utan anledning, kan du kanske ta reda på varför genom att titta i loggen.

  Funktionen är inte tillgänglig på &Windows;, eftersom de underliggande mekanismerna inte är implementerade i den plattformens gränssnitt.

Verktyg Uppdatera OpenPGP-certifikat

- Uppdaterar alla &openpgp; certifikat genom att köra

      gpg --refresh-keys

  Efter att kommandot har gjorts färdigt med lyckat resultat, kommer din lokala nyckellåda motsvara de senaste ändringarna med avseende på giltighet hos &openpgp; certifikat.

  Se anmärkningen under certificates-refresh-x509 för några varningar.

Verktyg Uppdatera X.509-certifikat

- Uppdaterar alla &smime; certifikat genom att köra

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

  Efter att kommandot har gjorts färdigt med lyckat resultat, kommer din lokala nyckellåda motsvara de senaste ändringarna med avseende på giltighet hos &smime; certifikat..

  Att uppdatera &x509;- eller &openpgp;-certifikat innebär att ladda ner alla certifikat och certifikatåterkallningslistor, för att kontrollera om någon av dem har återkallats under tiden.

  Det kan orsaka kännbar påfrestning både på din egen och andras nätverksanslutning, och kan ta mer än en timme att göra färdigt, beroende på nätverksanslutning och antal certifikat att kontrollera.

Verktyg Importera CRL från fil...

- Låter dig manuellt importera certifikatåterkallningslistor från filer.

  Normalt hanteras certifikatåterkallningslistor (&crl;:er) transparent av gränssnittet, men det kan ibland vara användbart att importera en &crl; manuellt till den lokala &crl;-cachen.

  För att &crl;-import ska fungera, måste verktyget &dirmngr; finnas i sökvägen `PATH`. Om menyalternativet är inaktiverat, bör du kontakta systemadministratören och be dem installera &dirmngr;.

Verktyg Rensa CRL-cache

- Rensar &gpgsm;s &crl;-cache.

  dDu behöver troligen aldrig det här. Du kan tvinga en uppdatering av &crl;-cachen genom att istället markera alla certifikat och istället använda certificates-refresh-x509.

Verktyg Rensa CRL-cache

- Visar detaljinnehållet i &gpgsm;s &crl;-cache.

### Menyn Inställningar

&kleopatra; har &kde;:s vanliga meny Inställningar som beskrivs i &kde;:s grunder, med ytterligare ett alternativ:

Inställningar Utför självtest

- Utför ett antal självtester och presenterar deras resultat.

  Det här är samma uppsättning tester som normalt körs vid start. Om du inaktiverade självtester vid start, kan du aktivera dem igen här.

### Menyn Fönster

Menyn Fönster låter dig hantera flikarna. Genom att använda alternativen i menyn kan du byta namn på en flik, lägga till en ny flik, duplicera nuvarande flik, stänga nuvarande flik, och flytta nuvarande flik åt vänster eller höger.

Genom att klicka med höger musknapp på en flik öppnas en sammanhangsberoende meny, där man också kan välja samma alternativ.

### Menyn Hjälp

&kleopatra; har &kde;:s vanliga Hjälp-meny som beskrivs i &kde;:s grunder.

## Referens till kommandoradsväljare

Bara väljare som är specifika för &kleopatra; listas här. Som med alla &kde;-program, kan du få en fullständig lista med väljare genom att ge kommandot ``kleopatra `--help```.

`--uiserver-socket` `argument`

- Plats för uttaget som UI-servern lyssnar på

`--daemon`

- Kör bara UI-server, dölj huvudfönster

`-p` `--openpgp`

- Använd &openpgp; för följande åtgärd

`-c` `--cms`

- Använd CMS (&x509;, S/&MIME;) för följande åtgärd

`-i` `--import-certificate`

- Anger en fil eller webbadress som ska användas för att importera certifikat (eller hemliga nycklar).

  Det här är motsvarigheten till file-import-certificates på kommandoraden.

`-e` `--encrypt`

- Kryptera fil(er)

`-s` `--sign`

- Signera fil(er)

`-E` `--encrypt-sign`

- Kryptera och/eller signera fil(er). Samma som `--sign-encrypt`, använd inte

`-d` `--decrypt`

- Avkoda fil(er)

`-V` `--verify`

- Verifiera fil/signatur

`-D` `--decrypt-verify`

- Avkoda och/eller verifiera fil(er)

## Anpassa &kleopatra;

&kleopatra;s inställningsdialogruta kan kommas åt via Inställningar Anpassa &kleopatra;...

Var och en av dess sidor beskrivs i avsnitten nedan.

### Anpassa Katalogtjänster

På den här sidan kan du ställa in vilka &ldap;-servrar som ska användas för sökningar efter &smime; certifikat, och vilka nyckelservrar som ska användas för sökningar efter &openpgp; certifikat.

Det är helt enkelt en mer användarvänlig version av samma inställningar som också finns i configuration-gnupg-system. Allt du kan ställa in här, kan du också ställa in där.

#### En anmärkning om proxy-inställningar

Proxyinställningar kan ställas in för &http; och &ldap; i configuration-smime-validation, men bara för &gpgsm;. För &gpg;, på grund av komplexiteten hos alternativen för nyckelservrar i &gpg; och avsaknad av riktigt stöd för dem i &gpgconf;, måste man för närvarande ändra inställningsfilen `gpg.conf` direkt. Se handboken för &gpg; för detaljinformation. &kleopatra; bevarar sådana inställningar, men tillåter inte ännu att de ändras i det grafiska gränssnittet.

Tabellen Katalogtjänster visar vilka servrar som för närvarande är inställda. Dubbelklicka på en cell i tabellen för att ändra de befintliga serverposternas parametrar.

Kolumnernas betydelse i tabellen är följande:

Schema

- Bestämmer nätverksprotokollet som används för att komma åt servern. Ofta använda metoder omfattar ldap (och dess syskon ldaps, säkrad med &ssl;) för &ldap;-servrar (vanligt protokoll för &smime;, det enda som stöds av &gpgsm;), och hkp, Horowitz nyckelserverprotkoll, nuförtiden oftast &http; nyckelserverprotkoll, ett &http;-baserat protokoll som i stort sett alla öppna &openpgp; nyckelservrar stöder.

  Se manualen för &gpg; och &gpgsm; för en lista av metoder som stöds.

Servernamn

- Serverns domännamn, t.ex. `keys.gnupg.net`.

Serverport

- Nätverksporten som servern lyssnar på.

  Det här ändras automatiskt till standardporten när man ändrar configuration-directory-services-scheme, om det inte var inställt till något annat än en standardport från början. Om man ändrar standardport, och inte kan få tillbaka den, försök ställa in configuration-directory-services-scheme till `http` och configuration-directory-services-server-port till `80` (standardvärdet för &http;), och fortsätta därifrån.

Basdomännamn

- Basdomännamnet (bara för &ldap; och &ldaps;), dvs. roten för &ldap;-hierarkin att starta från. Den kallas ofta också sökroten eller sökbasen.

  Den ser oftast ut som `c=de,o=Foo`, angiven som en del av &ldap; webbadressen.

Användarnamn

- Användarnamnet, om något finns, att använda för att logga in på servern.

  Kolumnen visas bara om alternativet Visa användare och lösenordsinformation (under tabellen) är markerat.

Lösenord

- Lösenordet, om något finns, att använda för att logga in på servern.

  Kolumnen visas bara om alternativet Visa användare och lösenordsinformation (under tabellen) är markerat.

X.509

- Markera kolumnen om posten ska användas för &x509; (&smime;) certifikatsökningar.

  Bara &ldap;- (och &ldaps;)-servrar stöds för &smime;.

OpenPGP

- Markera kolumnen om posten ska användas för &openpgp; certifikatsökningar.

Man kan ställa in så många &smime; (&x509;)-servrar som man vill, men bara en &openpgp;-server tillåts samtidigt. Det grafiska gränssnittet upprätthåller det.

Klicka på knappen Ny för att lägga till en ny server. Det duplicerar den markerade posten, om det finns någon, eller infogar annars en &openpgp; standardserver. Därefter kan man ställa in configuration-directory-services-server-name, configuration-directory-services-server-port, configuration-directory-services-base-dn samt de vanliga configuration-directory-services-password och configuration-directory-services-user-name, vilka båda bara behövs om servern kräver behörighetskontroll.

Använd Ny X.509 för att direkt infoga en post för &x509; certifkat, använd Ny OpenPGP för &openpgp;.

För att ta bort en server från söklistan, markera den i listan och tryck därefter på knappen Ta bort.

För att ställa in tidsgränsen för &ldap;, dvs. den maximala tiden som gränssnittet väntar på att en server ska svara, använd helt enkelt motsvarande inmatningsfält som heter LDAP-tidsgräns (minuter:sekunder).

Om en av dina servrar har en stor databas, så att till och med rimliga sökningar som `Johansson` når maximalt antal objekt som returneras av en fråga, kanske du vill öka gränsen. Du kan enkelt ta reda på om du når gränsen under en sökning, eftersom en dialogruta som talar om för dig att resultatet har avkortats dyker upp, om det är fallet.

Vissa servrar kan införa egna begränsningar på antal objekt som returneras vid en fråga. Om det är fallet, resulterar inte en ökning av gränsen här att flera objekt returneras.

### Anpassning av utseende

#### Anpassning av Verktygstips

I huvudcertifikatlistan kan &kleopatra; visa information om ett certifikat i ett verktygstips. Informationen som visas är samma som under fliken Översikt i dialogrutan Certifikatinformation. Verktygstips kan dock begränsas att bara visa en delmängd av informationen för en mindre detaljerad upplevelse.

Nyckel-ID visas alltid. Det görs för att försäkra att verktygstips för olika certifikat verkligen skiljer sig åt (det är särskilt viktigt om bara tooltips-validity har valts).

Man kan oberoende aktivera eller inaktivera följande informationsmängder:

Visa giltighet

- Visar information om ett certifikats giltighet: dess nuvarande status, utfärdarens domännamn (bara &smime;), utgångsdatum (om det finns något) och användningsflaggor för certifikatet.

  Exempel:

      Certifikatet är för närvarande giltigt.
      Utfärdare:                 CN=Test-ZS 7,O=Intevation GmbH,C=DE
      Giltighet:                   från 2009-08-25 10:42 till och med 2010-10-19 10:42
      Certifikatanvändning: Signering av e-post och filer, Kryptering av e-post och filer
      Nyckel-ID:                 DC9D9E43

Visa ägarinformation

- Visar information om certifikatets ägare: ägar-DN (bara &dn;),

  &openpgp; exempel:

      Användar-id:             Gpg4winUserA <gpg4winusera@test.hq>
      Nyckel-ID:               C6BF6664
      Ägarens pålitlighet:  fullständig

  &smime; exempel:

      Ägare:          CN=Gpg4winTestuserA,OU=Testlab,O=Gpg4win Project,C=DE
      alias:            Gpg4winUserA@test.hq
      Nyckel-ID:     DC9D9E43

Visa teknisk detaljinformation

- Visar teknisk information om certifikatet: serienummer (bara &smime;), typ, fingeravtryck och lagrinsplats.

  Exempel:

      Serienummer:     27
      Certifikattyp:      1,024-bit RSA (hemligt certifikat tillgängligt)
      Nyckel-ID:          DC9D9E43
      Fingeravtryck:    854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Lagrad:             på den här datorn

#### Anpassning av Certifikatkategorier

&kleopatra; låter dig anpassa utseendet hos (kontrollerade) nycklar i listvyn. Det omfattar att visa en liten ikon, men du kan också påverka förgrundsfärgen (textfärgen) och bakgrundsfärgen, samt teckensnittet.

Varje certifikatkategori i listan tilldelas en uppsättning färger, en ikon (valfri) och ett teckensnitt som certifikat tillhörande kategorin visas med. Kategorilistan fungerar också som en förhandsgranskning av inställningarna. Kategorier kan fritt definieras av en administratör eller en avancerad användare, se admin-key-filters under admin.

För att ändra ikonen för en kategori, markera den i listan och tryck på knappen Ange ikon.... &kde;:s vanliga ikonvalsdialogruta visas, där du kan välja en befintlig ikon i &kde;s samling, eller läsa i en egen.

För att ta bort en ikon igen, måste du trycka på knappen Förvalt utseende.

För att ändra textfärgen (dvs. förgrundsfärgen) hos en kategori, markera den i listan och tryck på knappen Ange textfärg.... &kde;:s vanliga färgvalsdialogruta visas, där du kan välja färg eller skapa en ny färg.

Att ändra bakgrundsfärg görs på samma sätt, klicka bara på Ange bakgrundsfärg istället.

För att ändra teckensnitt har du egentligen två alternativ:

1. Ändra standardteckensnitt som används för alla listvyer i &kde;.

2. Använd ett eget teckensnitt.

Det första alternativet har fördelen att teckensnittet följer vilken stil du än väljer i hela &kde;, medan den senare ger dig fullständig kontroll över teckensnittet som används. Valet är ditt.

För att använda det ändrade förvalda teckensnittet, markera kategorin i listan och markera eller avmarkera teckenegenskaperna kursiv, fetstil och/eller överstruken. Du ser omedelbart effekten på teckensnittet i kategorilistan.

Tryck på knappen Ange teckensnitt... för att använda ett eget teckensnitt. &kde;:s vanliga teckensnittsdialogruta visas, där du kan välja ett nytt teckensnitt.

Du kan fortfarande använda teckenegenskaper för att ändra det egna teckensnittet, precis som för att ändra förvalt teckensnitt.

För att byta tillbaka till förvalt teckensnitt, måste du trycka på knappen Förvalt utseende.

#### Anpassning av DN-egenskapsordning

Även om en DN är hierarkisk, definieras inte ordningen hos de enskilda komponenterna (som kallas relativa DN, RDN, eller DN egenskaper). Ordningen som egenskaperna visas är därför ett uttryck för personligt tycke eller företagspolicy, vilket är orsaken till att det kan ställas in i &kleopatra;.

Den här inställningen gäller inte bara &kleopatra; utan alla program som använder &kleopatra; teknologin. När det här skrivs omfattar det &kleopatra;, KDE:s adressbok samt förstås &kleopatra; själv.

Den här inställningssidan består i huvudsak av två listor, en för de kända egenskaperna (Tillgängliga egenskaper) och en som beskriver Nuvarande egenskapsordning.

Båda listor innehåller poster som beskrivs av egenskapens korta form (t.ex. CN) samt den utskrivna formen (Vanligt namn).

Listan Tillgängliga egenskaper är alltid sorterad i alfabetisk ordning, medan ordningen i listan Nuvarande egenskapsordning motsvarar den inställda DN-egenskapsordningen: den första egenskapen i listan är också den som visas först.

Bara egenskaper som explicit listas i Nuvarande egenskapsordning visas över huvud taget. Övriga döljs normalt.

Om platsmarkörposten _X_ (Alla andra) dock finns i nuvarande listan, infogas alla egenskaper som inte listas (vare sig de är kända eller inte) på platsen _X_, i sin ursprungliga relativa ordning.

Ett litet exempel hjälper till att klargöra detta:

Givet DN

> O=&kde;, C=US, CN=Dave Devel, X-BAR=foo, OU=&kleopatra;, X-FOO=bar,

förvald egenskapsordning för CN, L, _X_, OU, O, C ger följande formaterade DN:

> CN=Dave Devel, X-BAR=foo, X-FOO=bar, OU=&kleopatra;, O=&kde;, C=US

medan CN, L, OU, O, C ger

> CN=Dave Devel, OU=&kleopatra;, O=&kde;, C=US

För att lägga till en egenskap i listan med egenskapsordning, markera den i listan Tillgängliga egenskaper, och tryck på knappen Lägg till i nuvarande egenskapsordning.

För att ta bort en egenskap från listan med egenskapsordning, markera den i listan Nuvarande egenskapsordning, och tryck på knappen Ta bort från nuvarande egenskapsordning.

För att bara flytta en egenskap till början (eller slutet), markera den i listan Nuvarande egenskapsordning, och tryck på knappen Flytta längst upp (eller Flytta längst ner).

För att bara flytta en egenskap uppåt (eller neråt) ett steg, markera den i listan Nuvarande egenskapsordning, och tryck på knappen Flytta upp ett steg (eller Flytta ner ett steg).

### Anpassning av krypteringsåtgärder

#### Anpassning av E-poståtgärder

Här kan man ställa in vissa aspekter av e-postanvändningen för &kleopatra;s &uiserver;. För närvarande kan man bara anpassa om snabbläge används för att antingen signera eller kryptera e-post eller inte.

När Snabbläge är aktiverat visas ingen dialogruta när brev signeras, eller krypteras, om det inte finns en konflikt som behöver lösas upp manuellt.

#### Anpassning av Filåtgärder

Här kan man ställa in vissa aspekter av filåtgärder för &kleopatra;s &uiserver;. För närvarande kan man bara välja checksummeringsprogrammet att använda för `CHECKSUM_CREATE_FILES`.

Använd Program för checksummering att använda för att välja vilket av de inställda checksummeringsprogrammen som ska användas när checksummeringsfiler skapas.

När checksummor verifieras, hittas programmet att använda automatiskt baserat på de funna checksummeringsfilernas namn.

Administratörer och avancerade användare kan helt och hållet definiera vilka checksummeringsprogram som ska vara tillgängliga i &kleopatra; via så kallade checksummeringsdefinitioner i inställningsfilen. Se admin-checksum-definitions i admin för detaljinformation.

### Anpassning av aspekter rörande S/&MIME;-validering

På den här sidan kan man ställa in vissa aspekter av valideringen av &smime; certifikat.

Till största delen är det helt enkelt en mer användarvänlig version av samma inställningar som också finns i configuration-gnupg-system. Allt du kan ställa in här, kan du också ställa in där, med undantag av configuration-smime-validation-refresh-interval, som är specifik för &kleopatra;.

Alternativens betydelse är följande:

#### Anpassning av intervall mellan certifikatkontroller

Kontrollera certifikatgiltighet var `n:te` timma

- Alternativet aktiverar periodisk kontroll av certifikatens giltighet. Man kan också välja intervall mellan kontroller (i timmar). Effekten av periodisk kontroll är samma som view-redisplay. Det finns ingen möjlighet att schemalägga certificates-refresh-openpgp eller certificates-refresh-x509 periodiskt.

  Validering utförs implicit så fort viktigare filer i `~/.gnupg` ändras. Alternativet påverkar därför bara externa faktorer rörande certifikatens giltighet, precis som certificates-refresh-openpgp och certificates-refresh-x509.

#### Anpassning av valideringsmetod

Validera certifikat med CRL:er

- Om alternativet väljes, valideras &smime; certifikat genom att använda certifikatåterkallningslistor (&crl;:er).

  Se configuration-smime-validation-use-ocsp för ett alternativt sätt att kontrollera certifkatens giltighet.

Direktvalidera certifikat (OCSP)

- Om alternativet är markerat, valideras &smime; certifikat direkt med &ocsp; (Online Certificates Status Protocol).

  När den här metoden är vald, skickas en begäran till certifikatutfärdarens server mer eller mindre varje gång man skickar eller tar emot ett krypterat brev, vilket sålunda i teorin låter certifikatutfärdaren spåra vem man (exempelvis) utbyter brev med.

  För att använda metoden måste man skriva in webbadressen för &ocsp; besvararen i configuration-smime-validation-ocsp-url.

  Se configuration-smime-validation-use-ocsp för ett mer traditionellt sätt att kontrollera certifikatens giltighet, som inte läcker information om vem du utbyter brev med.

Webbadress för OCSP-besvarare

- Skriv in adressen till servern för direktvalidering av certifikat (&ocsp; besvararen). Webbadressen börjar vanligtvis med `http://`.

Signatur för OCSP-besvarare

- Välj certifikatet som &ocsp;-servern signerar sina svar med här.

Ignorera tjänstwebbadress för certifikat

- Varje &smime; certifikat innehåller oftast webbadressen till utfärdarens &ocsp;-besvarare (certificates-dump-certificate avslöjar om ett givet certifikat innehåller den).

  Att markera alternativet gör att &gpgsm; ignorerar dessa webbadresser och bara använder den som är inställd ovan.

  Använd det för att t.ex. tvinga att en företagsomfattande &ocsp;-proxy används.

#### Anpassning av valideringsalternativ

Kontrollera inte certifikatpolicy

- Normalt använder &gpgsm; filen `~/.gnupg/policies.txt` för att kontrollera om en certifikatpolicy är tillåten. Om alternativet är markerat kontrolleras inte policyn.

Konsultera aldrig en CRL

- Om det här alternativet är markerat, används certifikatåterkallningslistor aldrig för att validera &smime; certifikat.

Tillåt att rotcertifikat markeras som pålitliga

- Om alternativet är markerat när rotcertifikat från certifikatutfärdaren importeras, blir du tillfrågad om att bekräfta dess fingeravtryck och tillstånd vare sig du anser att rotcertifikatet är pålitligt eller inte.

  Ett rotcertifikat måste vara pålitligt innan de certifikat som det certifierar kan anses pålitliga, men att lättvindligt tillåta pålitliga rotcertifikat i din certifikatlagring, underminerar systemets säkerhet.

  Att aktivera funktionen i gränssnittet kan orsaka att dialogrutor från &pinentry; dyker upp vid olämpliga tillfällen (t.ex. när signaturer verifieras), och kan på så sätt blockera behandling av brev vid frånvaro. Av den orsaken, och eftersom det är önskvärt att kunna sluta lita på ett pålitligt rotcertifikat igen, tillåter &kleopatra; att pålitlighet ställs in manuellt genom att använda certificates-trust-root och certificates-distrust-root.

  Inställningen här påverkar inte &kleopatra;s funktion.

Hämta saknade utfärdarcertifikat

- Om det här alternativet är markerat, hämtas saknade utgivarcertifikat om nödvändigt (detta gäller båda valideringsmetoderna, &crl;:er och &ocsp;).

#### Anpassning av alternativ för &http;-begäran

Utför inte någon HTTP-begäran

- Inaktiverar användning av &http; för &smime; helt och hållet.

Ignorera HTTP CRL-distributionsställe för certifikat

- Vid sökning efter platsen för en &crl;, innehåller certifikatet som ska testas oftast poster med så kallade &crl;-distributionsställen (DS) vilka är webbadresser som beskriver sättet att komma åt :en &crl;. Den första DS-posten som hittas används.

  Med det här alternativet ignoreras alla poster som använder &http;-metoden vid sökning efter en lämplig DS.

Använd systemets HTTP-proxy

- Om det här alternativet markeras, används värdet på &http;-proxyn som visas till höger (som kommer från miljövariabeln `http_proxy`) för varje &http;-begäran.

Använd denna proxy för HTTP-begäran

- Om ingen systemproxy är inställd, eller om du måste använda en annan proxy för &gpgsm;, kan du skriva in dess plats här.

  Den kommer att användas för varje &HTTP;-begäran som har med S/&MIME; att göra.

  Syntaxen är ``värddator``:``port``, t.ex. `minproxy.någonstans.se:3128`.

#### Anpassning av alternativ för &ldap;-begäran

Utför inte någon LDAP-begäran

- Inaktivera användning av &ldap; för &smime; helt och hållet.

Ignorera LDAP CRL-distributionsställe för certifikat

- Vid sökning efter platsen för en &crl;, innehåller certifikatet som ska testas oftast poster med så kallade "&crl;-distributionsställen" (DS) vilka är webbadresser som beskriver sättet att komma åt &crl;:en. Den första DS-posten som hittas används.

  Med det här alternativet ignoreras alla poster som använder &ldap;-metoden vid sökning efter en lämplig DS.

Huvudvärddator för LDAP-begäran

- Att skriva in en &ldap;-server här gör att varje &ldap;-begäran går först till denna server. Närmare bestämt överskrider inställningen alla specifika `host` och `port` i en &ldap;-webbadress, och används också om `host` och `port` har utelämnats från webbadressen.

  Andra &ldap;-servrar används bara om anslutningen till proxyservern misslyckas. Syntaxen är ``värddator`` eller ``värddator``:``port``. Om `port` utelämnas, används port 389 (&ldap;s standardport).

### Anpassning av &gnupg;-systemet

Den här delen av dialogrutan skapas automatiskt av utdata från `gpgconf `--list-components`` och för varje `komponent` som ovanstående kommando returnerar, utdata från `gpgconf `--list-options` `komponent``.

De mest användbara av dessa alternativ har duplicerats som separata sidor i &kleopatra;s inställningsdialogruta. Se configuration-directory-services och configuration-smime-validation, de två dialogrutorna som innehåller utvalda alternativ från den här delen av dialogrutan.

Det exakta innehållet i den här delen av dialogrutan beror på versionen av &gnupg;-gränssnittet som är installerat, och möjligtvis plattformen som används. Sålunda beskriver vi bara dialogrutans allmänna utläggning, inklusive avbildningen från alternativ i &gpgconf; till det grafiska gränssnittets kontroller i &kleopatra;.

&gpgconf; returnerar inställningsinformation för flera komponenter, inne i varje komponent är enskilda alternativ kombinerade i grupper.

&kleopatra; visar en flik per komponent rapporterad av &gpgconf;. Grupper inleds med en horisontell linje som visar gruppnamnet som returmeras från &gpgconf;.

Varje alternativ i &gpgconf; har en typ. Förutom vissa välkända alternativ som &kleopatra; tar om hand med särskilda kontroller för en bättre användarupplevelse, är avbildningen mellan typer i &gpgconf; och kontroller i &kleopatra; den följande:

### Avbildning från typer i &gpgconf; till grafiska kontroller

typ i &gpgconf; | kontroll i &kleopatra;
för listor | för annat än listor
`none` | Nummerruta (antal) | Kryssruta
`string` | Ej tillämplig | Radeditor
`int32` | Radeditor (oformaterad) | Nummerruta
`uint32`
`pathname` | Ej tillämplig | särskild kontroll
`ldap server` | särskild kontroll | Ej tillämplig
`key fingerprint` | Ej tillämplig
`pub key`
`sec key`
`alias list`

Se handboken för &gpgconf; för mer information om vad man kan ställa in här, och hur.

## Administrationsguide

Administrationsguiden beskriver sätt att anpassa &kleopatra; som inte är tillgängliga via det grafiska gränssnittet, utan bara via inställningsfiler.

Det antas att läsaren känner till teknologin som används för att anpassa &kde;-program, inklusive layout, plats i filsystemet och ordning hos &kde;:s inställningsfiler, samt KIOSK-ramverket.

### Anpassning av guiden för att skapa certifikat

#### Anpassa domännamnsfälten

&kleopatra; låter dig anpassa fälten som användaren får skriva in för att skapa sitt certifikat.

Skapa en grupp som heter `CertificateCreationWizard` i systemets `kleopatrarc`. Om du vill ha en egen ordning av egenskaper eller om du bara vill att vissa poster ska visas, skapa en nyckel som heter `DNAttributeOrder`. Argumentet är en eller flera av `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL` om du vill att fält ska överskridas med ett visst värde, skriv något som liknar Egenskap=Värde. Om du vill att egenskapen ska behandlas som nödvändig, följ den med ett utropstecken (t.ex. `CN!,L,OU,O!,C!,EMAIL!`, som råkar vara förinställt värde).

Genom att använda kiosklägets flaggor `$e` blir det möjligt att hämta värden från miljövariabler eller från utvärdering av ett skript eller ett körbart program. Om du dessutom vill förhindra redigering av respektive fält, använd flaggan `$i`. Om du vill förhindra att knappen Infoga min adress används, ange värdet false för `ShowSetWhoAmI`.

Beroende på naturen hos &kde;:s kiosk-ramverk, blir det omöjligt för användaren att överskrida flaggan för oförändringsbarhet (`$i`) när den används. Det är avsett beteende. `$i` och `$e` kan också användas med vilken annan inställningsnyckel som helst i &kde;-program.

Följande exempel ger en översikt av möjliga anpassningar:

    [CertificateCreationWizard]
    ;Tillåt inte kopiering av personlig data från adressboken, tillåt inte lokal överskridning
    ShowSetWhoAmI[$i]=false

    ;ställer in användarnamnet till $USER
    CN[$e]=$USER

    ;ställer in företagsnamnet till "Mitt företag", tillåter inte redigering
    O[$i]=Mitt företag

    ;ställer in avdelningsnamnet till ett värde som returneras av ett skript
    OU[$ei]=$(lookup_dept_from_ip)

    ;ställer in land till SE, men tillåter ändring av användaren
    C=SE

#### Begränsa typer av nycklar som en användare tillåts skapa

&kleopatra; gör det också möjligt att begränsa vilka typer av certifikat en användare tillåts skapa. Observera dock att ett enkelt sätt att gå runt dessa begränsningar är att skapa ett på kommandoraden.

##### Algoritmer för öppna nycklar

För att begränsa algoritmerna för öppna nycklar som används, lägg till inställningsnyckeln `PGPKeyType` (och `CMSKeyType`, men bara RSA stöds för CMS ändå) under sektionen `CertificateCreationWizard` i `kleopatrarc`.

De tillåtna värdena är `RSA` för RSA-nycklar, `DAS` för DSA-nycklar (bara för signatur), och `DSA+ELG` för en DSA-nyckel (bara för signatur) med en Elgamal-delnyckel för kryptering.

Standardvärden läses från &gpgconf; eller från `RSA` om &gpgconf; inte tillhandahåller något standardvärde.

##### Storlek på öppen nyckel

För att begränsa tillgängliga nyckelstorlekar för en öppen algoritm, lägg till inställningsnyckeln ``<ALG>`KeySizes` (där `ALG` kan vara `RSA`, `DSA` eller `ELG`) under sektionen `CertificateCreationWizard` i `kleopatrarc`, som innehåller en lista med nyckelstorlekar (i bitar) åtskilda av kommatecken. Ett standardvärde kan anges genom att inleda nyckelstorleke med ett tankstreck (`-`).

    RSAKeySizes = 1536,-2048,3072

Ovanstående skulle begränsa tillåtna storlekar för RSA-nycklar till 1536, 2048 och 3072, med 2048 som standardstorlek.

Förutom själva storlekarna, kan du också ange beteckningar för varje storlek. Ställ helt enkelt in inställningsnyckeln ``ALG`KeySizeLabels` till en lista med beteckningar åtskilda av kommatecken.

    RSAKeySizeLabels = svag,normal,stark

Ovanstående tillsammans med föregående exempel, skulle skriva ut något som liknar följande alternativ att välja:

    svag (1536 bitar)
    normal (2048 bitar)
    stark (3072 bitar)

Standardvärden är som om följande gällde:

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

### Skapa och redigera nyckelkategorier

&kleopatra; låter användaren anpassa synligt utseende för nycklar baserat på ett koncept som kallas Nyckelkategorier. Nyckelkategorier används också för att filtrera certifikatlistan. Avsnittet beskriver hur man kan redigera tillgängliga kategorier och lägga till nya.

Vid försök att hitta kategorin som en nyckel hör till, försöker &kleopatra; matcha nyckeln med en följd av nyckelfilter, angivna i filen `libkleopatrarc`. Det första som matchar definierar kategorin, baserat på konceptet säregenhet (eng. specificity), som förklaras närmare nedan.

Varje nyckelfilter definieras i en konfigurationsgrupp som heter `Key Filter #`n``, där `n` är ett tal som börjar på `0`.

Det enda alternativen som krävs i gruppen `Key Filter #`n`` är `Name`, som innehåller namnet på kategorin som den visas i inställningsdialogrutan, och `id` som används för att referera till filtret i andra inställningssektioner (såsom `View #`n``).

table-key-filters-appearance listar alla nycklar som definierar visningsegenskaperna för nycklar som hör till kategorin (dvs. de nycklar som kan ställas in i inställningsdialogrutan), medan table-key-filters-criteria anger alla alternativ som definierar de kriterier som filtret använder för att matcha nycklar.

### Inställningsalternativ för att definiera visningsegenskaper i nyckelfilter

Inställningsalternativ | Typ | Beskrivning
`background-color` | färg | Bakgrundsfärgen som ska användas. Om den saknas får den som standardvärde vilken bakgrundsfärg som än är definierad globalt för listvyer.
`foreground-color` | färg | Förgrundsfärgen som ska användas. Om den saknas får den som standardvärde vilken förgrundsfärg som än är definierad globalt för listvyer.
`font` | teckensnitt | Det egna teckensnittet som ska användas. Teckensnittet skalas till storleken som är inställd för listvyer, och eventuella teckenegenskaper (se nedan) införs.
`font-bold` | boolean | Om angiven som `true` och `font` inte är angiven, används standardteckensnittet i listvyn med teckenstilen fetstil tillagd (om tillgänglig). Ignoreras om `font` också finns med.
`font-italic` | boolean | Motsvarar `font-bold`, men använder kursivstil istället för fetstil.
`font-strikeout` | boolean | Om `true` ritas en centrerad linje över teckensnittet. Gäller även om `font` är angiven.
`ikon` | text | Namnet på en ikon att visa i första kolumnen. Ännu inte implementerat.

### Inställningsalternativ för att definiera filterkriterier i nyckelfilter

Inställningsalternativ | Typ | Om angivet matchar filtret när...
`is-revoked` | boolean | nyckeln har återkallats.
`match-context` | context Context är ett uppräkningsvärde med följande tillåtna värden: `appearance`, `filtering` och `any`. | sammanhanget där filtret matchar.
`is-expired` | boolean | nyckeln har gått ut.
`is-disabled` | boolean | nyckeln har inaktiverats (markerats för att inte användas) av användaren. Ignoreras för &smime;-nycklar.
`is-root-certificate` | boolean | nyckeln är ett rotcertifikat. Ignoreras för &openpgp;-nycklar.
`can-encrypt` | boolean | nyckeln kan användas för kryptering.
`can-sign` | boolean | nyckeln kan användas för signering.
`can-certify` | boolean | nyckeln kan användas för att signera (certifiera) andra nycklar.
`can-authenticate` | boolean | nyckeln kan användas för behörighetskontroll (t.ex. som ett TLS-klientcertifikat).
`is-qualified` | boolean | nyckeln kan användas för att skapa kvalificerade signaturer (enligt definitionen i tysk lag rörande digitala signaturer).
`is-cardkey` | boolean | nyckeln lagras på ett smartkort (istället för på datorn).
`has-secret-key` | boolean | den hemliga nyckeln i det här nyckelparet är tillgänglig.
`is-openpgp-key` | boolean | nyckeln är en &openpgp;-nyckel (`true`), eller en &smime;-nyckel (`false`).
`was-validated` | boolean | nyckeln har validerats.
``prefix`-ownertrust` | validity Giltighet är en (ordnad) uppräkning av följande tillåtna värden: `unknown`, `undefined`, `never`, `marginal`, `full`, `ultimate`. Se handböckerna för &gpg; och &gpgsm; för en detaljerad förklaring. | nyckeln har exakt (`prefix` = `is`), har vad som helst utom (`prefix` = `is-not`), har åtminstone (`prefix` = `is-at-least`), eller har som mest (`prefix` = `is-at-most` ägarpålitligheten som anges som värde i inställningsalternativet. Om mer än en nyckel med ``prefix`-ownertrust` (med olika `prefix` värden) finns i en enstaka grupp, är beteendet odefinierat.
``prefix`-validity` | validity | Motsvarar ``prefix`-ownertrust`, men för nyckelgiltighet istället för ägarpålitlighet.

Några av de mest intressanta kriterierna, som `is-revoked` eller `is-expired` fungerar bara med kontrollerade nycklar, vilket är orsaken till att det normalt bara undersöks att kontrollerade nycklar är återkallade eller utgångna, även om det är fritt att ta bort de extra villkoren.

Förutom de inställningsvärden som listas ovan, kan ett nyckelfilter också ha `id` och `match-contexts`.

Genom att använda filtrets `id`, som normalt är filtrets gruppnamn i inställningarna om det inte anges eller är tomt, kan du referera till nyckelfiltret på andra ställen i inställningarna, t.ex. i &kleopatra;s vyinställningar. Värdet `id` tolkas inte av &kleopatra;, alltså kan du använda vilken sträng som helst, under förutsättning att den är unik.

Värdet `match-contexts` begränsar filtrets tillämplighet. För närvarande är två sammanhang definierade. Sammanhanget `appearance` används när vyernas färgläggnings- och teckensnittsegenskaper definieras. Sammanhanget `filtering` används för att selektivt inkludera (eller exkludera) certifikat från vyer. Värdet `any` kan användas för att ange alla sammanhang som för närvarande är definierade, och är normalvärdet om `match-contexts` inte anges, eller inte anger ett sammanhang på annat sätt. Det försäkrar att inget nyckelfilter kan bli dött, dvs. inte ha något sammanhang där det används.

Postens format är en lista med symboler, åtskilda av tecken som inte ingår i symbolen. Varje symbol inleds av ett valfritt utropstecken (`!`), som anger negering. Symbolerna agerar i tur och ordning på en intern lista med sammanhang, som är tom från början. Det förklaras bäst med ett exempel: `any !apperance` är samma sak som `filtering`, och `appearance !appearance` skapar en tom mängd, vilket också `!any` gör. Dock ersätts de två senaste internt med `any`, eftersom de inte ger något sammanhang alls.

I allmänhet undersöks inte kriterier som inte anges (dvs. om inställningsalternativet inte är med). Om ett kriterium anges, undersöks det och måste matcha för att filtret som helhet ska matcha, dvs. kriterierna sammanfogas med OCH.

Varje filter har en tänkt säregenhet som används för att ranka alla filter som matchar. Filtret med större säregenhet vinner över de med mindre säregenhet. Om två filter har samma säregenhet, vinner det som kommer först i inställningsfilen. Ett filters säregenhet är proportionellt till antalet kriterier det innehåller.

#### Exempel på nyckelfilter

För att söka efter alla utgångna men inte återkallade rotcertifikat, skulle du använda ett nyckelfilter som definieras på följande sätt:

    [Key Filter #n]
    Name=utgångna, men inte återkallade
    was-validated=true
    is-expired=true
    is-revoked=false
    is-root-certificate=true
    ; ( specificity 4 )

För att söka efter alla inaktiverade &openpgp;-nycklar (som ännu inte stöds av &kleopatra;) med åtminstone marginell ägarpålitlighet, skulle du använda:

    [Key Filter #n]
    Name=inaktivera OpenPGP-nycklar med marginell eller bättre ägarpålitlighet
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

### Anpassa arkiveringsverktyg för användning med signerade och krypterade filer

&kleopatra; låter administratör (eller avancerad användare) ställa in listan med arkiveringsverktyg som presenteras i fildlalogrutan Signera/kryptera.

Varje arkiveringsverktyg definieras i `libkleopatrarc` som en separat grupp `Archive Definition #`n``, med följande nödvändiga nycklar:

`extensions`

- En lista med filnamnsändelser åtskilda av kommatecken, som oftast anger arkiveringsformatet.

`id`

- En unik identifierare som används för att identifiera arkiveringsverktyget internt. Om tveksam, använd kommandots namn.

`Namn` (översatt)

- Namnet på arkiveringsverktyget synligt för användaren, som det visas i motsvarande kombinationsmenyn i fildialogrutan Signera/Kryptera.

`pack-command`

- Själva kommandot för att arkivera filer. Vilket kommando som helst kan användas, så länge inget skal krävs för att köra det. Programfilen slås upp med miljövariabeln `PATH`,

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

Eftersom bakstreck (`\`) är ett skyddande tecken i &kde;:s inställningsfiler, måste de dubbleras när de ingår i sökvägar:

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

För själva kommandot (i motsats till dess argument), kan man dock använda vanliga snedstreck (`/`) som avskiljare i sökvägar på alla plattformar:

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

Det stöds inte i argument, eftersom de flesta program på &Windows; använder vanliga snedstreck för väljare. Exempelvis fungerar inte följande, eftersom `C:/myarchivescript.bat` är ett argument till `cmd.exe`, och `/` inte konverteras till `\` i argument, bara kommandon:

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

Det måste istället skrivas som:

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

#### Skicka indatafilnamn till `pack-command`

Det finns tre sätt att skicka filnamn till arkiveringskommandot. För vart och ett av dem, tillhandahåller `pack-command` en speciell syntax.

1. Som kommandoradsväljare.

   Exempel (tar):

       pack-command=tar cf -

   Exempel (zip):

       pack-command=zip -r - %f

   I detta fall skickas filnamn på kommandoraden, precis som man skulle göra vid användning av en terminal. &kleopatra; använder inte ett skal för att köra kommandot. Därför är detta ett säkert sätt att skicka filnamn, men det kan råka ut för begränsningar av kommandoradens längd på vissa plattformar. Teckenföljden `%f`, om den finns, ersätts med namnen på filerna att arkivera. Annars läggs filnamnen till sist på kommandoraden. Sålunda skulle zip-exemplet ovan ekvivalent kunna skrivas så här:

       pack-command=zip -r -

2. Via standardinmatningen, åtskilda med nyrader: lägg till `|` först

   Exempel (&GNU;-tar):

       pack-command=|gtar cf - -T-

   Exempel (ZIP):

       pack-command=|zip -@ -

   I detta fall skickas filnamn till arkiveringsverktyget på standardinmatningen, ett per rad. Det undviker problem på plattformar som har en låg gräns för antal kommandoradsväljare som tillåts, men misslyckas när filnamn faktiskt innehåller nyrader.

   &kleopatra; stöder för närvarande bara LF som nyradstecken, inte CRLF. Det kan komma att ändras i framtida versioner, baserat på återmatning från användare.

3. Via standardinmatningen, åtskilda med NUL-tecken: lägg till `0|` först

   Exempel (&GNU;-tar):

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

   Detta är samma sak som ovan, utom att NUL-tecken används för att skilja filnamn åt. Eftersom NUL-tecken är förbjudna i filnamn, är detta det säkraste sättet att skicka filnamn, men inte alla arkiveringsverktyg stöder det.

### Anpassa checksummeringsprogram för användning när checksummor skapas och verifieras

&kleopatra; låter administratör (eller avancerad användare) ställa in listan med checksummeringsprogram som användaren kan välja bland i inställningsdialogrutan, och &kleopatra; klarar av att automatiskt detektera verktyg när det ombeds att verifiera en given fils checksumma.

För att vara användbart av &kleopatra;, måste utdata från checksummeringsprogram (både den skriva checksummeringsfilen, och standardutmatningen vid verifiering av checksummor) vara kompatibelt med &GNU; `md5sum` och `sha1sum`.

Närmare bestämt måste checksummeringsfilen vara radbaserad, med varje rad på följande format:

    CHECKSUMMA ' ' ( ' ' | '*' ) FILNAMN

där `CHECKSUMMA` endast består av hexadecimala tecken. Om `FILNAMN` innehåller ett nyradstecken, måste raden istället lyda:

    \CHECKSUMMA ' ' ( ' ' | '*' ) SKYDDAT-FILNAMN

där `SKYDDAT-FILNAMN` är filnamnet med nyrader ersatta med `\n`, och bakstreck dubblerade (`\`↦`\\`).

På liknande sätt måste utdata från checksum-definition-verify-command ha formen

    FILNAMN ( ': OK' | ': FAILED' )

åtskilda med nyrader. Nyrader och andra tecken skyddas inte i utdata.

Jo, dessa program skrevs inte med grafiska gränssnitt i åtanke, och &kleopatra; misslyckas tolka patologiska filnamn som innehåller ": OK" och nyrad riktigt.

Varje checksummeringsprogram definieras i `libkleopatrarc` som en separat grupp `Checksum Definition #`n``, med följande nödvändiga nycklar:

`file-patterns`

- En lista med reguljära uttryck som beskriver vilka filer som ska anses vara checksummeringsfiler för det här checksummeringsprogrammet. Syntaxen är den som används för stränglistor i &kde;:s inställningsfiler.

  Eftersom reguljära uttryck oftast innehåller bakstreck, måste försiktighet iakttas så att de skyddas på ett riktigt sätt i inställningsfilen. Användning av ett redigeringsverktyg av inställningsfiler rekommenderas.

  Plattformen definierar om mönstren behandlas skiftlägeskänsligt eller inte.

`output-file`

- Det typiska utdatafilnamnet för det här checksummeringsprogrammet (ska naturligtvis motsvara ett av checksum-definition-file-patterns). Det är vad &kleopatra; kommer att använda som utdatafilnamn när checksummeringsfiler av den här typen skapas.

`id`

- En unik identifierare som används för att identifiera checksummeringsprogrammet internt. Om tveksam, använd kommandots namn.

`Namn` (översatt)

- Namnet på checksummeringsprogrammet synligt för användaren, som det visas i kombinationsmenyn i &kleopatra;s inställningsdialogruta.

`create-command`

- Själva kommandot som används för att skapa checksummeringsfiler. Syntaxen, begränsningar och alternativ för att skicka väljare är samma som beskrivs för archive-definition-pack-command i admin-archive-definitions.

`verify-command`

- Samma som checksum-definition-create-command, men för verifiering av checksummor.

Här är ett fullständigt exempel:

              [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

## Tack till och licens

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

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

## Bidragsgivare

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

Översättning Stefan Asserhäll stefan.asserhall@bredband.net

&underFDL; &underGPL;
&documentation.index;