# Manuale di &kleopatra;

## Introduzione

&kleopatra; è lo strumento di &kde; per gestire certificati &x509; e &openpgp; nelle cassette delle chiavi &gpgsm; e &gpg;, e per recuperare certificati dai server &ldap; e da altri server di certificati.

&kleopatra; può essere avviato dal menu Strumenti Gestore dei certificati di &kmail; e dalla riga di comando. L'eseguibile di &kleopatra; si chiama ``kleopatra``.

Questo programma trae il nome da Cleopatra, una famosa faraona egizia che visse ai tempi di Giulio Cesare, con cui ebbe un figlio, Cesarione, non riconosciuto come erede di Cesare.

Il nome è stato scelto poiché questo programma deriva dai progetti Ägypten (Ägypten in tedesco significa appunto Egitto). &kleopatra; è il nome in tedesco di Cleopatra.

## Funzioni principali

### Esaminare la cassetta delle chiavi locale

La funzione principale di &kleopatra; è di visualizzare e modificare il contenuto della cassetta delle chiavi locale, che è un concetto simile a quello del portachiavi di &gpg;, anche se questa analogia non va presa alla lettera.

La finestra principale si divide fra la grande area con l'elenco delle chiavi, la barra dei menu e la barra di ricerca in cima, e una barra di stato in fondo.

Ogni riga dell'elenco di chiavi corrisponde a un certificato, identificato dal cosiddetto Oggetto DN. &dn; è un acronimo che sta per Distinguished Name, in italiano Nome Distinto: questo è un identificativo gerarchico, simile al percorso di un filesystem ma con una sintassi inusuale, che dovrebbe identificare univocamente il certificato a livello globale.

Perché siano valide, e quindi utilizzabili, le chiavi (pubbliche) devono essere firmate da una &ca; (autorità di certificazione). Queste firme sono dette certificati, ma di solito i termini certificato e chiave (pubblica) sono usati come sinonimi, e in generale non faremo distinzione tra di essi nemmeno in questo manuale.

Le &ca; devono a loro volta essere firmate da altre &ca; per essere valide. Naturalmente a un certo punto si deve finire, per cui le &ca; di massimo livello (le &ca; radice) si firmano da sole (questa operazione è chiamata auto-firma). I certificati radice quindi devono ricevere convalida (di solito detta fiducia) manualmente, per esempio dopo aver confrontato l'impronta digitale con quella sul sito Web della &ca;.Questo è di solito fatto dall'amministratore del sistema o dal fornitore del prodotto che usa i certificati, ma lo può fare anche l'utente con l'interfaccia dalla riga di comando di &gpgsm;.

Per sapere quali dei certificati sono certificati radice puoi passare alla modalità di visualizzazione gerarchica con view-hierarchical-key-list.

Puoi vedere i dettagli dei certificati con un doppio clic su di esso, o usando view-certificate-details. Questo apre una finestra che mostra le proprietà comuni del certificato, la sua catena di certificati (cioè la catena di emittenti fino al &ca; radice), e uno sversamento di tutte le informazioni che il motore è in grado di estrarre dal certificato.

Se cambi la cassetta delle chiavi senza usare &kleopatra; (⪚ usando l'interfaccia a linea di comando di &gpgsm;), puoi aggiornare la vista con view-redisplay.

### Ricerca ed importazione dei certificati

Nella maggior parte dei casi, acquisirai nuovi certificati verificando le firme elettroniche dei messaggi di posta, visto che i certificati sono spesso incorporati nelle firme fatte con loro. Comunque, se devi inviare un messaggio a qualcuno con cui non sei ancora entrato in contatto, dovrai scaricare il certificato da una cartella &ldap; (anche se &gpgsm; possa farlo automaticamente) o da un file. Inoltre dovrai importare il tuo certificato dopo aver ricevuto la risposta della &ca; alla tua richiesta di certificazione.

Per cercare un certificato in una directory &ldap;, seleziona File Cerca i certificati sul server e inserisci del testo (per esempio il nome della persona di cui vuoi il certificato) nella casella di testo della finestra Ricerca del certificato sul server dei certificati, quindi fai clic sul pulsante Cerca. I risultati saranno visualizzati nell'elenco di chiavi sotto la barra di ricerca, dove puoi selezionare i certificati facendoci clic con il pulsante Dettagli o scaricarli nella cassetta locale delle chiavi con il pulsante Importa.

Puoi configurare l'elenco dei server &ldap; su cui cercare dalla pagina Servizi di directory della finestra di configurazione di &kleopatra;.

Se hai ricevuto il certificato come file, prova ad usare file-import-certificates. &gpgsm; deve poter riconoscere il formato del file del certificato; controlla il manuale di &gpgsm; per la lista dei formati di file che è in grado di comprendere.

Se non hai creato la coppia di chiavi con &gpgsm;, dovrai anche importare a mano la chiave pubblica (oltre a quella segreta) dal file PKCS#12 fornito dalla &ca;. Puoi farlo da riga di comando con ``kleopatra` `--import-certificate` `nomefile`` o da dentro &kleopatra; con file-import-certificates, esattamente come faresti per i certificati normali.

### Creare nuove coppie di chiavi

La voce di menu file-new-key-pair fa partire la Procedura guidata per la creazione di coppie di chiavi, che ti guiderà attraverso i passi della richiesta di certificato.

Quando hai finito con un passo della procedura, premi Successivo per andare al passo successivo (o Precedente per rivedere i passi già completati). La creazione della richiesta di un certificato può essere annullata in qualsiasi momento premendo il pulsante Annulla.

Sulla prima pagina della procedura guidata scegli il tipo di certificato che vuoi creare:

Crea una coppia di chiavi personale per OpenPGP

- Le coppie di chiavi &openpgp; sono create localmente, e certificate da amici e conoscenze. Non c'è un'autorità di certificazione centrale; invece, ogni individuo crea una rete di fiducia personale certificando le coppie di chiavi degli altri utenti con il suo certificato.

  Devi inserire un Nome, un indirizzo di Posta elettronica e facoltativamente un Commento.

Crea una coppia di chiavi personali &x509; e una richiesta di certificato

- Le coppie di chiavi &x509; sono create localmente, ma certificate centralmente da un'autorità di certificazione. Le &ca; possono certificare altre &ca;, creando una catena di fiducia centrale e gerarchica.

  Il prossimo passo della procedura guidata è inserire i dati personali per il certificato. I campi da compilare sono:

  - Nome comune, il tuo nome.

  - Indirizzo di posta, il tuo indirizzo di posta elettronica; assicurati di scriverlo correttamente: è l'indirizzo a cui verranno inviati i messaggi quando i tuoi corrispondenti useranno questo certificato.

  - Indirizzo, il paese o città in cui vivi.

  - Unità organizzativa, l'unità organizzativa a cui appartieni (per esempio, Logistica).

  - Organizzazione, l'organizzazione che rappresenti (per esempio la ditta per cui lavori).

  - Codice del paese, l'identificativo di due lettere del paese in cui vivi (per esempio IT).

  Il passo successivo della procedura guidata è scegliere se memorizzare il certificato in un file o inviarlo direttamente a una &ca;. Devi specificare il nome del file o l'indirizzo di posta a cui inviare la richiesta del certificato.

#### Revocare una chiave

Un paio di chiavi scadute possono essere riportate in condizione operativa fintantoché hai accesso alla chiave privata e alla frase segreta. Per rendere una chiave definitivamente inutilizzabile la devi revocare. La revoca viene effettuata aggiungendo una particolare firma di revoca alla chiave.

Questa firma di revoca viene salvata in un file a parte. Questo file può in seguito venire importato nel portachiavi e viene quindi allegato alla chiave, rendendola inutilizzabile. Nota che l'importazione di questa firma nella chiave non richiede una password; quindi, dovresti tenere questa firma di revoca in un posto sicuro, normalmente diverso da dove tieni la coppia di chiavi. È buona norma usare un posto diverso dal computer, come un dispositivo di memorizzazione esterna come una penna USB o uno stampato su carta.

&kleopatra; non fornisce una funzione per creare una tale firma di revoca in qualsiasi momento, ma lo puoi fare con l'applicazione &kgpg; di &kde; scegliendo &kgpg;Chiavi Revoca chiave e a scelta importando subito la firma di revoca nel tuo portachiavi.

Un modo alternativo di generare un certificato di revoca è usare &gpg; direttamente dalla riga di comando: `gpg --output `certificato_di_revoca`.asc --gen-revoke `chiave``. L'argomento `chiave` deve essere lo specificatore di una chiave: l'identificativo della tua coppia di chiavi primarie o parte del nome utente che identifica la tua chiave.

## Guida ai menu

### Il menu File

&Ctrl;N File Nuovo certificato

- Crea una nuova coppia di chiavi (pubblica e privata) e permette di inviare la parte pubblica a un'autorità di certificazione (&ca;) per la firma. Il certificato risultante ti verrà quindi rispedito, o sarà memorizzato in un server &ldap; per fartelo scaricare nella cassetta delle chiavi locale, dove potrai usarlo per firmare e decifrare i messaggi di posta.

  Questo modo di operare è chiamato generazione di chiavi decentralizzata, perché le chiavi sono generate localmente. &kleopatra; (e &gpgsm;) non gestiscono direttamente la generazione delle chiavi centralizzata, ma puoi importare la coppia di chiavi segreta e pubblica che ricevi dalla &ca; in formato PKCS#12 attraverso file-import-certificates.

&Ctrl;&Shift;I File Cerca i certificati sul server

- Cerca, e importa, dei certificati dai loro server nella cassetta locale. Vedi functions-search per i dettagli.

  Devi aver configurato dei server di chiavi perché funzioni. Vedi configuration-directory-services per maggiori dettagli.

&Ctrl;I File Importa certificati

- Importa certificati o chiavi segrete da file nella cassetta delle chiavi locale. Vedi functions-search per maggiori dettagli.

  Il formato del certificato deve essere supportato da &gpgsm;/&gpg;. Fai riferimento ai manuali di &gpgsm; e &gpg; per una lista dei formati supportati.

&Ctrl;E File Esporta certificati

- Esporta i certificati selezionati in un file.

  L'estensione che scegli per il file esportato ne determina il formato:

  - Per i certificati &openpgp;, `.gpg` e `.pgp` produrranno un file binario, mentre `.asc` produrrà un file in armatura &ascii;.

  - Per i certificati &smime;, `.der` produrrà un file binario codificato con &der;, mentre `.pem` produrrà un file in armatura &ascii;.

  A meno che siano selezionati certificati multipli, &kleopatra; proporrà ``fingerprint`.{asc,pem}` come nome del file esportato.

  Questa funzione è disponibile solo quando sono stati selezionati uno o più certificati.

  Questa funzione esporta solo le chiavi pubbliche, anche la segreta è disponibile. Usa file-export-secret-key per esportare le chiavi segrete in un file.

File Esporta chiavi segrete

- Esporta sia la chiave segreta in un file.

  Nella finestra che si apre, puoi scegliere se creare un file esportato binario o con armatura &ascii; (Armatura ASCII). Fai quindi clic sull'icona della cartella a destra della casella File di uscita, e seleziona cartella e nome del file da esportare. Quando si esportano chiavi segrete &smime;, puoi anche scegliere l'Insieme di caratteri della frase segreta. Vedi la discussione dell'opzione `--p12-charset `charset`` nel manuale di &gpgsm; per maggiori dettagli.

  Questa funzione è disponibile solo quando è stato selezionato solo un certificato la cui chiave segreta è disponibile.

  L'uso di questa funzione raramente dovrebbe essere necessario, e, se è lo è, deve essere pianificato attentamente. Pianificare la migrazione delle chiavi segrete comprende la scelta del mezzo di trasporto e la cancellazione sicura dei dati della chiave sulla vecchia macchina, oltre che sul mezzo di trasporto, fra le altre cose.

&Ctrl;&Shift;E File Esporta certificati verso il server

- Pubblica i certificati selezionati su un server di chiavi (solo &openpgp;).

  Il certificato viene inviato al server configurato per &openpgp; (cfr. configuration-directory-services), se impostato, altrimenti a `keys.gnupg.net`.

  Questa funzione è disponibile solo se è stato selezionato almeno un certificato &openpgp; (e nessuno &smime;).

  Quando i certificati &openpgp; vengono esportati a un server di elenco pubblico, è quasi impossibile rimuoverli. Prima di esportare un certificato a un server di elenco pubblico, assicurati di aver creato un certificato di revoca in modo da poterlo revocare se ne avrai bisogno in seguito.

  La maggior parte dei server &openpgp; pubblici sincronizzano i certificati tra di loro, quindi non ha molto senso inviarli a più d'uno.

  Può accadere che una ricerca su un server di certificati non riporti nessun risultato anche se gli hai appena mandato il tuo certificato. Questo perché la maggior parte degli indirizzi dei server di chiavi pubblici usa DNS a turno per bilanciare il carico su più macchine. Queste macchine si sincronizzano tra loro, ma di solito solo ogni 24 ore circa.

File Decifra/verifica file

- Decifra dei file o ne verifica le firme.

File Firma/cifra file

- Firma o cifra dei file.

&Ctrl;W File Chiudi

- Chiude la finestra principale di &kleopatra;. La puoi ripristinare in qualsiasi momento dall'icona nel vassoio di sistema.

&Ctrl;Q File Esci

- Termina &kleopatra;.

### Il menu Visualizza

F5 Visualizza Mostra di nuovo

- Aggiorna l'elenco dei certificati.

  L'uso di questa funzione è di solito superfluo, perché &kleopatra; sorveglia le modifiche al filesystem e aggiorna automaticamente l'elenco dei certificati se necessario.

&Esc; Visualizza Arresta operazione

- Interrompe (annulla) tutte le operazioni pendenti, per esempio una ricerca, un elenco di chiavi o uno scaricamento.

  Questa funzione è disponibile solo se è attiva almeno un'operazione.

  A causa di limitazioni dei motori, a volte le operazioni si fermeranno in un modo in cui questa funzione non riuscirà ad annullarle immediatamente o affatto.

  In questi casi, l'unico modo di riportare l'ordine è terminare i processi &scdaemon;, &dirmngr;, &gpgsm; e &gpg;, in quest'ordine, con gli strumenti del sistema operativo (`top`, gestore dei processi, eccetera), finché l'operazione non viene sbloccata.

Visualizza Dettagli del certificato

- Mostra i dettagli del certificato attualmente selezionato.

  Questa funzione è disponibile solo quando è selezionato esattamente un certificato.

  Questa funzione è anche disponibile direttamente con un doppio clic sulla voce corrispondente della vista a elenco.

Visualizza Lista gerarchica dei certificati

- Passa tra la modalità gerarchica e quella a singolo livello per l'elenco dei certificati.

  In modalità gerarchica i certificati sono organizzati secondo la relazione emittente/oggetto, quindi è facile vedere a quale gerarchia di certificazione appartenga un particolare certificato, ma è inizialmente è più difficile trovare un certificato in particolare (sebbene si possa naturalmente usare la barra di ricerca).

  In modalità semplice, tutti i certificati sono mostrati in una semplice lista, in ordine alfabetico. In questa modalità, un dato certificato è facile da trovare, ma non è immediatamente chiaro a quale certificato radice appartenga.

  Questa funzione commuta la modalità gerarchica per schede, cioè ogni scheda ha il suo stato gerarchico. Questo in modo da poter avere sia una lista a livello singolo e una gerarchica a disposizione, ciascuna nella sua scheda.

  La visualizzazione gerarchica è attualmente implementata solo per i certificati &smime;. C'è disaccordo tra gli sviluppatori riguardo al modo giusto di visualizzare i certificati &openpgp; gerarchicamente (sostanzialmente, genitore = firmatario o genitore = firmato).

&Ctrl;. Visualizza Espandi tutto

- Espande tutte le voci nella vista a elenco dei certificati, cioè li rende tutti visibili.

  Questa è la modalità predefinita quando si passa alla modalità di elenco gerarchico delle chiavi.

  È ovviamente ancora possibile espandere e contrarre le voci una ad una.

  Questa funzione è disponibile solo quando si attiva view-hierarchical-key-list.

&Ctrl;, Visualizza Contrai tutto

- Contrae tutte le voci della vista a elenco dei certificati, cioè nasconde tutte le voci tranne quelle di massimo livello.

  È ovviamente ancora possibile espandere e contrarre le voci una ad una.

  Questa funzione è disponibile solo quando si attiva view-hierarchical-key-list.

### Il menu Certificati

Certificati Cambia fiducia nel proprietario

- Cambia la fiducia nel proprietario del certificato &openpgp; selezionato.

  Questa funzione è disponibile solo quando è selezionato esattamente un certificato &openpgp;.

Certificati Fidati del certificato radice

- Segna questo certificato radice (&smime;) come fidato.

  In qualche modo, questo è l'equivalente di certificates-change-owner-trust per i certificati radice &smime;. Puoi tuttavia scegliere solo tra la fiducia assuluta e nessuna fiducia, nella terminologia di &openpgp;.

  Il motore (per mezzo di &gpgagent;) chiederà al momento dell'importazione del certificato radice se fidarsene. Tuttavia, quella funzione va abilitata esplicitamente nella configurazione del motore (`allow-mark-trusted` in `gpg-agent.conf`, oppure Sistema GnuPG Agente GPG Permetti ai client di indicare le chiavi come fidate o Convalida S/MIME Permetti di indicare i certificati radice come fidati sotto configuration).

  Abilitare quella funzionalità nel motore può far apparire delle finestre a comparsa di &pinentry; in momenti inopportuni (per esempio quando si verificano le firme), e può quindi bloccare l'elaborazione della posta se nessuno è presente. Per questo motivo, e perché è una buona cosa poter togliere la fiducia a un certificato radice fidato, &kleopatra; permette di impostare la fiducia manualmente.

  A causa del mancato supporto a livello di motore per questa funzione, &kleopatra; deve lavorare direttamente sulla banca dati della fiducia di &gpgsm; (`trustlist.txt`). Quando usi questa funzione, assicurati che non ci sia nessun'altra operazione crittografica in corso che possa interferire con &kleopatra; mentre modifica quella banca dati.

  Questa funzione è disponibile solo quando è stato selezionato solo un certificato radice &smime; che non sia ancora fidato.

  Usa certificates-distrust-root per annullare questa funzione.

Certificati Togli fiducia al certificato radice

- Indica questo certificato radice (&smime;) come non fidato.

  Questa funzione è disponibile solo quando è stato selezionato solo un certificato radice &smime; che sia attualmente fidato.

  Usato per annullare certificates-trust-root. Vedi lì per i dettagli.

Certificati Certifica certificato

- Permette di certificare un altro certificato &openpgp;.

  Questa funzione è disponibile solo quando è selezionato esattamente un certificato &openpgp;.

Certificati Cambia data di scadenza

- Permette di cambiare la data di scadenza di un certificato &openpgp;.

  Usa questa funzione per estendere la vita utile dei certificati &openpgp; in alternativa a crearne di nuovi o usare una durata illimitata (non scade mai).

  Questa funzione è disponibile solo quando è stato selezionato solo un certificato &openpgp; la cui chiave segreta è disponibile.

Certificati Cambia frase segreta

- Permette di cambiare la frase segreta di una chiave segreta.

  Questa funzione è disponibile solo se è selezionato esattamente un certificato la cui chiave segreta è disponibile. Richiede un motore molto recente, perché l'implementazione è stata cambiata dalla chiamata diretta a &gpg; e &gpgsm; in una basata su &gpgme;.

  Per ragioni di sicurezza, le frasi segrete sia vecchia che nuova vengono richieste da &pinentry;, un processo a parte. A seconda della piattaforma su cui sei e della qualità della sua implementazione di &pinentry;, potrebbe darsi che la finestra di &pinentry; compaia sullo sfondo. Quindi, se selezioni questa funzione e non succede nulla, controlla la barra delle applicazioni del sistema per vedere se sullo sfondo si è aperta una finestra di &pinentry;.

Certificati Aggiungi ID utente

- Permette di aggiungere un nuovo ID utente al certificato &openpgp;.

  Usalo per aggiungere nuove identità a un certificato esistente in alternativa a creare un nuovo paio di chiavi. Un ID utente di &openpgp; ha la forma seguente:

      Nome vero (Commento) <Posta elettronica>

  Nella finestra che appare quando selezioni questa funzione, &kleopatra; chiederà separatamente ciascuno dei tre parametri (`Nome vero`, `Commento` e `Posta elettronica`), e ne visualizzerà il risultato in un'anteprima.

  Questi parametri sono soggetti alle stesse restrizioni amministrative come per i nuovi certificati. Vedi functions-newkey e admin-certificate-request-wizard per i dettagli.

  Questa funzione è disponibile solo quando è stato selezionato solo un certificato &openpgp; la cui chiave segreta è disponibile.

Canc Certificati Elimina

- Elimina i certificati selezionati dal portachiavi locale.

  Usa questa funzione per rimuovere le chiavi inutilizzate dalla cassetta delle chiavi locale. Però, poiché i certificati sono tipicamente allegati a messaggi di posta firmati, la verifica di un messaggio potrebbe risultare nel reinserimento nella cassetta delle chiavi locale di una chiave appena rimossa. Quindi è probabilmente meglio evitare di usare questa funzione il più possibile. Quando ti perdi, usa la barra di ricerca o la funzione view-hierarchical-key-list per ottenere nuovamente il controllo dei certificati.

  C'è un'eccezione a quanto sopra: quando elimini uno dei tuoi certificati, ne elimini anche la chiave segreta. Ciò implica che non potrai più leggere le comunicazioni precedenti cifrate per te con questo certificato, a meno di avere una copia di sicurezza da qualche parte.

  &kleopatra; ti avvertirà se cercherai di eliminare una chiave segreta.

  A causa della natura gerarchica dei certificati &smime;, se elimini un certificato emittente &smime; (certificato &ca;), anche tutti i suoi oggetti saranno eliminati.

  È come sul disco: quando elimini una cartella, elimini anche tutti i file e tutte le cartelle che contiene.

  Naturalmente, questa funzione è disponibile solo se hai selezionato almeno un certificato.

Certificati Sversa il certificato

- Mostra tutte le informazioni che &gpgsm; ha sul certificato (&smime;) selezionato.

  Vedi la discussione su `--dump-key `key`` nel manuale di &gpgsm; per i dettagli sui risultati.

### Il menu Strumenti

Strumenti Visore di registri GnuPG

- Avvia &kwatchgnupg;, uno strumento per presentare il risultato del debug delle applicazioni &gnupg;. Se la firma, la cifratura o la verifica smettono misteriosamente di funzionare, potresti scoprire perché leggendo il registro.

  Questa funzione non è disponibile su &Windows;, perché i meccanismi necessari non sono implementati nel motore di quella piattaforma.

Strumenti Aggiorna i certificati OpenPGP

- Aggiorna tutti i certificati &openpgp; eseguendo ``gpg `--refresh-keys```. Dopo il corretto completamento del comando, la raccolta di chiavi locale rispecchierà le ultime modifiche alla validità dei certificati &openpgp;.

  Vedi la nota sotto configuration per alcuni avvisi.

Strumenti Aggiorna i certificati X.509

- Aggiorna tutti i certificati &smime; eseguendo ``gpgsm `-k` `--with-validation` `--force-crl-refresh` `--enable-crl-checks```. Dopo il corretto completamento del comando, la raccolta di chiavi locale rispecchierà le ultime modifiche alla validità dei certificati &smime;.

  Aggiornare i certificati &x509; o &openpgp; implica scaricare tutti i certificati e le &crl; per controllare se qualcuno di essi è stato nel frattempo revocato.

  Ciò può mettere sotto pressione la connessione di rete tua e altrui, perché può volerci più di un'ora per finire, a seconda della connessione e del numero di certificati da controllare.

Strumenti Importa CRL da file

- Permette di importare manualmente &crl; da file.

  Normalmente, le Liste di Revocazione dei certificati (&crl;) sono gestite in modo trasparente dal motore, ma a volte è utile importare una &crl; manualmente nella cache locale delle &crl;.

  Perché l'importazione di &crl; funzioni, lo strumento &dirmngr; deve essere nel `PATH` di ricerca. Se questa voce del menu è disabilitata, dovresti contattare l'amministratore del sistema e chiedergli di installare &dirmngr;.

Strumenti Pulisci la cache delle CRL

- Pulisce la cache delle &crl; di &gpgsm;.

  Non dovresti mai aver bisogno di questa funzione. Al suo posto, puoi forzare l'aggiornamento della cache delle &crl; selezionando tutti i certificati ed usando certificates-refresh-x509.

Strumenti Sversa cache delle CRL

- Mostra il contenuto dettagliato della cache delle &crl; di &gpgsm;.

### Il menu Impostazioni

&kleopatra; ha un menu delle Impostazioni predefinito di &kde;, come descritto nei Fondamentali di &kde;, con una voce in più:

Impostazioni Esegui l'autodiagnosi

- Effettua una serie di autodiagnosi e ne presenta il risultato.

  Questa è la stessa serie di test che come impostazione predefinita vengono eseguiti all'avvio. Se hai disattivato i test all'avvio, li puoi riattivare qui.

### Il menu Finestra

Il menu Finestra permette di gestire le schede. Usando gli elementi di questo menu puoi rinominare una scheda, aggiungerne una nuova, duplicare quella attuale, chiuderla, e spostarla a destra o a sinistra.

Anche facendo clic con il &RMB; su una scheda puoi aprire un menu contestuale in cui puoi selezionare le stesse azioni.

### Il menu Aiuto

&kleopatra; ha un menu Aiuto predefinito di &kde;, come descritto nei Fondamentali di &kde;.

## Guida alle opzioni dalla riga di comando

Sono elencate qui solo le opzioni specifiche di &kleopatra;. Come per tutte le applicazioni di &kde; puoi avere la lista completa delle opzioni disponibili con il comando ``kleopatra` `--help``.

`--uiserver-socket` `argomento`

- Posizione del socket su cui il server dell'UI è in ascolto

`--daemon`

- Esegui solo il server dell'interfaccia, nascondi la finestra principale

`-p` `--openpgp`

- Usa &openpgp; per l'operazione seguente

`-c` `--cms`

- Usa CMS (&x509;, S/&MIME;) per l'operazione seguente

`-i` `--import-certificate`

- Specifica un file o un &URL; da cui importare certificati (o chiavi segrete).

  Questo è l'equivalente su riga di comando di file-import-certificates.

`-e` `--encrypt`

- Cifra file

`-s` `--sign`

- Firma file

`-E` `--encrypt-sign`

- Cifra o firma i file. Uguale a `--sign-encrypt`, da non usare.

`-d` `--decrypt`

- Decifra file

`-V` `--verify`

- Verifica file e firma

`-D` `--decrypt-verify`

- Decifra o verifica file

## Configurare &kleopatra;

La finestra di configurazione di &kleopatra; è accessibile con Impostazioni Configura &kleopatra;.

Ciascuna pagina è descritta nelle sezioni seguenti.

### Configurare i servizi di directory

Su questa pagina, puoi configurare quali server &ldap; usare per le ricerche di certificati &smime;, e quali server di chiavi usare per le ricerche di certificati &openpgp;.

Questa è semplicemente una versione più facile da usare delle stesse impostazioni che trovi anche in configuration-gnupg-system. Tutto quello che puoi configurare qui può essere configurato anche là.

#### Nota sulle impostazioni dei proxy

Le impostazioni dei proxy possono essere configurate per &http; e &ldap; in configuration-smime-validation, ma solo per &gpgsm;. Per &gpg;, a causa della complessità delle opzioni dei server delle chiavi di &gpg;, e a causa della mancanza di un loro supporto appropriato in &gpgconf;, al momento devi modificare direttamente il file di configurazione `gpg.conf`. Fai riferimento al manuale di &gpg; per i dettagli. &kleopatra; manterrà queste impostazioni, ma non permette ancora di modificarle nella sua interfaccia.

La tabella Servizi di directory mostra quali server sono attualmente configurati. Fai doppio clic su una cella della tabella per cambiare i parametri delle voci dei server presenti.

Le colonne della tabella hanno i seguenti significati:

Schema

- Determina il protocollo di rete usato per accedere al server. Schemi di uso comune includono ldap (e la sua versione con sicurezza &ssl; ldaps) per i server &ldap;, un protocollo comune per &smime; e l'unico supportato da &gpgsm;; e hkp, il protocollo Horowitz per server di chiavi, oggi spesso chiamato il protocollo &http; per server di chiavi, un protocollo basato su &http; supportato da praticamente tutti i server di chiavi.

  Riferisciti ai manuali di &gpg; e &gpgsm; per un elenco degli schemi supportati.

Nome del server

- Il nome di dominio del server, per esempio `keys.gnupg.net`.

Porta del server

- La porta di rete su cui il server è in ascolto.

  Questa cambia automaticamente alla porta predefinita quando si cambia configuration-directory-services-scheme, a meno che fosse già stata impostata a una porta non standard. Se hai cambiato la porta predefinita e non riesci a ritrovarla, prova a impostare configuration-directory-services-scheme a `http` e configuration-directory-services-server-port a `80` (il valore predefinito per &http;), e riparti da lì.

DN base

- Il &dn; base (solo per &ldap; e &ldaps;), cioè la radice della gerarchia &ldap; da cui partire. Viene spesso chiamato radice di ricerca o base di ricerca.

  Di solito è qualcosa come `c=de,o=Foo`, dato come parte dell'&URL; di &ldap;.

Nome utente

- In nome dell'utente, se c'è, da usare per accedere al server.

  Questa colonna è visibile solo se l'opzione Mostra le informazioni su utente e password (sotto la tabella) è attiva.

Password

- La password, se c'è, da usare per accedere al server.

  Questa colonna è visibile solo se l'opzione Mostra le informazioni su utente e password (sotto la tabella) è attiva.

X.509

- Spunta questa colonna se questa voce va usata per ricerche di certificati &x509; (&smime;).

  Solo i server &ldap; (e &ldaps;) sono supportati per &smime;.

OpenPGP

- Spunta questa colonna se questa voce va usata per ricerche di certificati &openpgp;.

Puoi configurare tanti server &smime; (&x509;) quanti ne vuoi, ma è permesso solo un server &openpgp; alla volta. L'interfaccia farà rispettare questo limite.

Per aggiungere un nuovo server, fai clic sul pulsante Nuovo. Ciò duplica la voce selezionata, se ce n'è una, altrimenti inserisce un server &openpgp; predefinito. Puoi quindi impostare ilconfiguration-directory-services-server-name, laconfiguration-directory-services-server-port, il configuration-directory-services-base-dn e i soliti configuration-directory-services-password e configuration-directory-services-user-name, entrambi i quali sono necessari solo se il server richiede di identificarsi.

Per inserire direttamente una voce per i certificati &x509;, usa Nuovo X.509; usa Nuovo OpenPGP per &openpgp;.

Per rimuovere un server dall'elenco di ricerca, selezionalo e premi il pulsante Elimina.

Per impostare il periodo di scadenza ad &ldap;, cioè il massimo periodo di tempo per cui il motore aspetterà una risposta del server, usa la casella numerica Scadenza LDAP (minuti:secondi).

Se uno dei server ha una banca dati molto grande, per cui anche ricerche semplici come `Rossi` raggiungono il Numero massimo di voci restituite dalla ricerca, potresti dover aumentare questo limite. È facile accorgersi se si raggiunge il limite durante la ricerca, perché apparirà una finestra per avvertire che i risultati saranno troncati.

Alcuni server possono imporre dei limiti propri sul numero di voci restituite da una ricerca. In questo caso, aumentare il limite non aumenterà il numero di elementi restituiti.

### Configurare l'Aspetto

#### Configurare i Suggerimenti

Nell'elenco principale dei certificati, &kleopatra; può mostrare i dettagli di un certificato in un suggerimento. Le informazioni visualizzate sono le stesse della scheda Panoramica della finestra Dettagli del certificato. I suggerimenti, però, si possono limitare a mostrare solo una parte delle informazioni per avere un programma meno logorroico.

L'ID chiave viene sempre mostrato. Ciò per assicurarsi che i suggerimenti di certificati diversi siano davvero diversi (è importante soprattutto se è stato selezionato solo tooltips-validity).

Puoi abilitare o disabilitare indipendentemente i seguenti insiemi di informazioni:

Mostra validità

- Mostra informazioni sulla validità di un certificato: il suo stato attuale, il &dn; dell'emittente (solo &smime;), la data di scadenza (se c'è) e i contrassegni d'uso del certificato.

  Esempio:

      Questo certificato è attualmente valido.
      Emittente:           CN=Test-ZS 7,O=Intevation GmbH,C=DE
      Validità:            da 25.08.2009 10:42 a 19.10.2010 10:42
      Uso del certificato: Firma di posta elettronica e file, Cifratura di posta e file
      ID chiave:           DC9D9E43

Mostra informazioni sul proprietario

- Mostra informazioni sul proprietario del certificato: &dn; oggetto (solo &smime;), ID utente (inclusi indirizzi di posta) e affidabilità del proprietario (solo &openpgp;).

  Esempio &openpgp;:

      ID utente:                      Pinco Pallino <pinco.pallino@esempio.it>
      ID chiave:                      C6BF6664
      Affidabilità del proprietario:  assoluta

  Esempio &smime;:

      Oggetto:           CN=PincoPallino,OU=Esempio,O=Progetto esempio,C=IT
      alias:             pinco.pallino@esempio.it
      ID chiave:         DC9D9E43

Mostra dettagli tecnici

- Mostra informazioni tecniche sul certificato: numero di serie (solo &smime;), tipo, impronta digitale e indirizzo di memorizzazione.

  Esempio:

      Numero di serie:        27
      Tipo di certificato:    %1-bit %2 (certificato segreto disponibile)
      ID chiave:              DC9D9E43
      Impronta digitale:      854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Memorizzato:            su questo computer

#### Configurare le Categorie dei certificati

&kleopatra; permette di configurare l'aspetto dei certificati nella vista a elenco. È possibile mostrare un'iconcina, ma anche cambiare i colori del testo e di sfondo, oltre al carattere.

Ogni categoria di certificati nell'elenco ha un insieme di colori, un'icona (facoltativa) e un carattere associati, con i quali i certificati di quella categoria sono visualizzati. Le categorie possono essere definite liberamente dagli amministratori o dagli utenti esperti, vedi admin-key-filters neladmin.

Per impostare o cambiare l'icona di una categoria, selezionala nell'elenco e premi il pulsante Imposta icona. Apparirà la finestra standard di selezione delle icone di &kde;, dove puoi scegliere un'icona dalla raccolta di &kde; o caricarne una nuova.

Per rimovere un'icona, devi premere il pulsante Aspetto predefinito.

Per cambiare il colore del testo (cioè di primo piano) di una categoria, selezionala dall'elenco e premi il pulsante Imposta colore del testo. Apparirà la finestra di selezione dei colori di &kde;, dove puoi scegliere un colore o crearne uno nuovo.

Il cambio del colore di sfondo si fa allo stesso modo premendo il pulsante Imposta colore di sfondo.

Per cambiare il carattere, hai sostanzialmente due scelte:

1. Modificare il carattere standard, usato da tutte le viste a elenco di &kde;.

2. Usare un carattere personalizzato.

La prima scelta ha il vantaggio che il carattere seguirà lo stile scelto come preferito in tutto &kde;, mentre l'altra dà pieno controllo sul carattere da usare. La scelta è tua.

Per usare il carattere standard modificato, seleziona la categoria dalla lista, e cambia i modificatori del carattere Corsivo, Grassetto o Barrato. Puoi vedere immediatamente l'effetto sui caratteri della lista delle categorie.

Per usare un carattere personalizzato, premi il pulsante Imposta carattere. Apparirà la finestra standard di selezione dei caratteri di &kde; per permettere di scegliere il carattere.

Puoi ancora usare i modificatori dei caratteri per cambiare il carattere personalizzato, come per modificare il carattere standard.

Per tornare ad usare il carattere standard, è necessario premere il pulsante Aspetto predefinito.

#### Configurare l'Ordine degli attributi DN

Sebbene i &dn; siano gerarchici, l'ordine dei componenti individuali (chiamati &dn; relativi o RDN, o attributi dei &dn;) non è definito. L'ordine in cui gli attributi vanno mostrati è un problema di politica aziendale o di gusto personale, ed ecco perché è configurabile in &kleopatra;.

Questa impostazione non ha effetto solo su &kleopatra;, ma su tutte le applicazioni che ne usano la tecnologia. Al momento in cui è stato redatto questo manuale, queste includono &kmail;, &kaddressbook;, e anche &kleopatra; stessa, ovviamente.

Questa pagina di configurazione consiste sostanzialmente di due elenchi, uno per gli attributi noti (Attributi disponibili) e uno che descrive l'Ordine attuale degli attributi.

Entrambi gli elenchi contengono voci descritte dalla forma breve dell'attributo (per esempio CN) in aggiunta alla forma descrittiva (Nome comune).

L'elenco Attributi disponibili è sempre ordinato alfabeticamente, mentre l'elenco Ordine attuale degli attributi riflette l'ordine degli attributi del &dn; configurato: il primo attributo della lista è mostrato per primo.

I soli attributi che vengono mostrati sono quelli esplicitamente elencati in Ordine attuale degli attributi. Quelli che non compaiono nell'elenco sono nascosti.

Però, se la voce segnaposto _X_ (Tutti gli altri) è nell'elenco attuale, tutti gli attributi non elencati (che siano noti oppure no) verranno inseriti al posto di _X_, nell'ordine relativo originale.

Un breve esempio aiuterà a chiarire la situazione:

Dato il &dn;

> O=&kde;, C=IT, CN=Pippo, X-PINCO=pallino, OU=&kleopatra;, X-PALLINO=pinco,

l'ordine predefinito degli attributi di CN, L, _X_, OU, O, C produrrà il seguente &dn; formattato:

> CN=Pippo, X-PINCO=pallino, X-PALLINO=pinco, OU=&kleopatra;, O=&kde;, C=IT

Mentre CN, L, OU, O, C produrrà

> CN=Pippo, OU=&kleopatra;, O=&kde;, C=IT

Per aggiungere un attributo all'ordine di visualizzazione della lista, selezionalo dalla lista Attributi disponibili e premi il pulsante Aggiungi all'ordine attuale degli attributi.

Per eliminare un attributo dall'ordine di visualizzazione della lista, selezionalo dalla lista Ordine attuale degli attributi e premi il pulsante Rimuovi dall'ordine attuale degli attributi.

Per spostare un attributo all'inizio (o alla fine) della lista, selezionalo dalla lista Ordine attuale degli attributi e premi il pulsante Sposta in cima (o Sposta in fondo).

Per spostare un attributo più in su (o in giù) di una sola posizione, selezionalo dalla lista Ordine attuale degli attributi e premi il pulsante Sposta in su (o Sposta in giù).

### Configurare le operazioni di cifratura

#### Configurare le Operazioni di posta

Qui puoi configurare alcuni aspetti delle operazioni di posta dell'&uiserver; di &kleopatra;. Attualmente puoi configurare solo se usare o meno la modalità rapida per firmare e cifrare i messaggi individualmente.

Quando la modalità rapida è attiva, non si mostra nessuna finestra quando si firmano (o cifrano) messaggi di posta, a meno che ci sia un conflitto che richieda una soluzione manuale.

#### Configurare le Operazioni dei file

Qui puoi configurare alcuni aspetti delle operazioni sui file dell'&uiserver; di &kleopatra;. Attualmente puoi solo scegliere il programma da usare per il calcolo del codice di controllo di `CHECKSUM_CREATE_FILES`.

Usa Programma per i codici di controllo da usare per scegliere quale dei programmi configurati usare alla creazione di file di codici di controllo.

Quando si verificano i codici di controllo, il programma da usare viene trovato automaticamente, in base al nome dei file di codici di controllo trovati.

L'amministratore e l'utente esperto possono definire completamente quali programmi di codici di controllo rendere disponibili a &kleopatra; con le cosiddette definizioni di codice di controllo nel file di configurazione. Per i dettagli vedi admin-checksum-definitions.

### Configurare aspetti della convalida S/&MIME;

Su questa pagina, puoi configurare certi aspetti della convalida dei certficati &smime;.

Per lo più, questa è solo una versione più facile da usare delle stesse impostazioni che trovi anche in configuration-gnupg-system. Tutto quello che puoi configurare qui, lo puoi configurare anche là, eccetto configuration-smime-validation-refresh-interval, che è specifico a &kleopatra;.

Il significato delle opzioni è come segue:

#### Configurare il controllo periodico dei certificati

Controlla la validità dei certificati ogni `N` ore

- Questa opzione abilita il controllo periodico della validità dei certificati. Puoi anche scegliere il periodo di controllo (in ore). L'effetto del controllo periodico è lo stesso di view-redisplay; non c'è la possibilità di pianificazione periodica di certificates-refresh-openpgp o certificates-refresh-x509.

  La convalida viene effettuata implicitamente ogni volta che cambiano dei file significativi in `~/.gnupg`. Questa opzione, come certificates-refresh-openpgp e certificates-refresh-x509, è quindi importante solo nel caso di fattori esterni per la validità dei certificati.

#### Configurare il metodo di convalida

Convalida i certificati con le CRL

- Se questa opzione è selezionata, i certificati &smime; verranno convalidati usando le liste di revoca certificato (&crl;).

  Vedi configuration-smime-validation-use-ocsp per un metodo alternativo di controllo della validità dei certificati.

Convalida in linea dei certificati (OCSP)

- Se questa opzione è selezionata, i certificati &smime; verranno convalidati in linea con il protocollo di stato dei certificati in linea (&ocsp;).

  Quando si sceglie questo metodo, si invia una richiesta al server della &ca; più o meno ogni volta che si invia o riceve un messaggio cifrato, il che in linea teorica permette all'agenzia che ha emesso il certificato di monitorare con chi stai scambiando (per esempio) messaggi di posta.

  Se usi questo metodo, dovra inserire l'&URL; del risponditore &ocsp; in configuration-smime-validation-ocsp-url.

  Vedi configuration-smime-validation-use-ocsp per un metodo più tradizionale di controllo della validità dei certificati che non tradisce informazioni sui tuoi contatti.

URL del risponditore OCSP

- Inserisci qui l'indirizzo del server per la convalida in linea dei certificati (risponditore &ocsp;). L'&URL; comincia di solito per `http://`.

Firma del risponditore OCSP

- Scegli qui il certificato con cui il server &ocsp; firma le sue risposte.

Ignora l'URL del servizio dei certificati

- Ogni certificato &smime; di solito contiene l'&URL; del risponditore &ocsp; del suo emittente (certificates-dump-certificate rivelerà se un dato certificato lo contiene).

  Segnare questa opzione fa ignorare a &gpgsm; questi &URL;, e gli fa usare solo quello configurato sopra.

  Usalo, per esempio, per far rispettare l'uso di un proxy &ocsp; aziendale.

#### Configurare le opzioni di convalida

Non controllare le politiche dei certificati

- Come impostazione predefinita, &gpgsm; usa il file `~/.gnupg/policies.txt` per controllare se la politica di un certificato è permessa. Se questa opzione è selezionata, le politiche non vengono controllate.

Non consultare mai una CRL

- Se questa opzione è selezionata, non si useranno mai le liste di revoca dei certificati (CRL) per convalidare i certificati &smime;.

Permetti di indicare i certificati radice come fidati

- Se questa opzione è attivata durante l'importazione di un certificato &ca; radice, verrà chiesto di confermarne l'impronta digitale e di dichiarare se si considera quel certificato radice affidabile.

  Un certificato radice deve essere fidato prima che i certificati che esso certifica divengano a loro volta fidati, ma fidarsi troppo facilmente di certificati radice può minare la sicurezza del sistema.

  Abilitare questa funzionalità nel motore può far apparire delle finestre a comparsa di &pinentry; in momenti inopportuni (per esempio quando si verificano le firme), e può quindi bloccare l'elaborazione della posta se nessuno è presente. Per questo motivo, e perché è una buona cosa poter togliere la fiducia a un certificato radice fidato, &kleopatra; permette di impostare la fiducia manualmente con certificates-trust-root e certificates-distrust-root.

  Questa funzionalità qui non influenza il funzionamento di &kleopatra;.

Recupera i certificati degli emittenti mancanti

- Se questa opzione è impostata, i certificati degli emittenti mancanti vengono scaricati secondo necessità (ciò è valido per entrambi i metodi di convalida, &crl; e &ocsp;).

#### Configurare le opzioni di richiesta &http;

Non effettuare nessuna richiesta HTTP

- Disattiva completamente l'uso di &http; per &smime;.

Ignora i punti di distribuzione di CRL HTTP dei certificati

- Quando si cerca l'indirizzo di una &crl;, il certificato da controllare di solito contiene quelle che sono note come voci Punto di distribuzione di &crl; (DP), che sono &URL; che descrivono il modo di accedere alla &crl;. Si usa la prima voce DP trovata.

  Con questa opzione tutte le voci che usano lo schema &http; sono ignorate quando si cerca un DP adatto.

Usa il proxy HTTP di sistema

- Se questa opzione è selezionata, il valore del proxy &http; mostrato a destra (che viene dalla variabile d'ambiente `http_proxy`) sarà usato per ogni richiesta &http;.

Usa questo proxy per le richieste HTTP

- Se non è impostato nessun proxy di sistema, o devi usare un proxy diverso per &gpgsm;, puoi inserirne l'indirizzo qui.

  Verrà usato per tutte le richieste &HTTP; relative a S/&MIME;.

  La sintassi è ``host``:``porta``, per esempio `mioproxy.dove.it:3128`.

#### Configurare le opzioni di richiesta &ldap;

Non effettuare nessuna richiesta LDAP

- Disattiva completamente l'uso di &ldap; per &smime;.

Ignora i punti di distribuzione di CRL LDAP dei certificati

- Quando si cerca l'indirizzo di una &crl;, il certificato da controllare di solito contiene quelle che sono note come voci Punto di distribuzione di &crl; (DP), che sono &URL; che descrivono il modo di accedere alla &crl;. Si usa la prima voce DP trovata.

  Con questa opzione tutte le voci che usano lo schema &ldap; sono ignorate quando si cerca un DP adatto.

Host principale per le richieste LDAP

- Inserire qui un server &ldap; invierà tutte le richieste &ldap; a quel server per primo. Più precisamente, questa impostazione si sostituisce a qualsiasi parte `host` o `porta` specificata in un &URL; di &ldap;, e sarà usata anche `host` e `porta` sono stati omessi dall'&URL;.

  Altri server &ldap; verranno usati solo se la connessione al proxy non riesce. La sintassi è ``host`` o ``host``:``porta``. Se si omette la `porta`, si usa la porta 389 (la porta standard di &ldap;).

### Configurare il sistema &gnupg;

Questa parte della finestra viene generata automaticamente dal risultato di ``gpgconf` `--list-components`` e, per ogni `componente` restituito dal comando sopra, il risultato di ``gpgconf` `--list-options` `componente``.

Le più utili di queste opzioni sono state duplicate come pagine a sé nella finestra di configurazione di &kleopatra;. Vedi configuration-directory-services e configuration-smime-validation per le due pagine della finestra che contengono le opzioni selezionate di questa parte della finestra.

Il contenuto preciso di questa parte della finestra dipende dalla versione del motore &gnupg; che hai installato e, potenzialmente, dalla piattaforma su cui ti trovi. Quindi, discuteremo solo lo schema generale della finestra, incluse le mappature dalle opzioni di &gpgconf; ai controlli dell'interfaccia di &kleopatra;.

&gpgconf; restituisce informazioni di configurazione per diversi componenti. Entro ogni componente vengono raggruppate le singole opzioni.

&kleopatra; mostra una scheda per componente riportato da &gpgconf;; i gruppi sono intestati da una riga orizzontale che indica il nome del gruppo come restituito da &gpgconf;.

Ogni opzione di &gpgconf; ha un tipo. Eccetto alcune opzioni comuni che &kleopatra; supporta con controlli specifici per facilitare la vita all'utente, la mappatura tra i tipi di &gpgconf; e i controlli di &kleopatra; è come segue:

### Mappatura da tipi di &gpgconf; a controlli dell'interfaccia

Tipo di &gpgconf; | Controllo di &kleopatra;
elenchi | non elenchi
`nessuno` | Casella numerica (semantica del conteggio) | Casella di spunta
`string` | &NA; | Casella di testo
`int32` | Casella di testo (non formattata) | Casella numerica
`uint32`
`percorso` | &NA; | controllo specializzato
`server ldap` | controllo specializzato | &NA;
`impronta digitale di chiave` | &NA;
`chiave pubblica`
`chiave segreta`
`elenco di alias`

Vedi il manuale di &gpgconf; per maggiori informazioni su cosa puoi configurare qui, e come.

## Guida dell'amministratore

La guida dell'amministratore descrive dei modi di personalizzare &kleopatra; non disponibili dall'interfaccia grafica, ma solo dai file di configurazione.

Si presuppone che il lettore abbia familiarità con le tecnologie usate per la configurazione delle applicazioni di &kde;, in particolare la disposizione, la posizione nel filesystem e l'ordine di precedenza dei file di configurazione di &kde;, ed anche dell'infrastruttura KIOSK.

### Personalizzazione della procedura guidata della creazione di certificati

#### Personalizzare i campi &dn;

&kleopatra; permette di configurare i campi che l'utente può inserire per creare il certificato.

Crea un gruppo chiamato `CertificateCreationWizard` nel file di sistema `kleopatrarc`. Se vuoi personalizzare l'ordine degli attributi o se vuoi che compaiano solo certe voci, crea una chiave chiamata `DNAttributeOrder`. L'argomento è uno o più tra `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL`. Se vuoi inizializzare i campi con un certo valore, scrivi qualcosa come ``Attributo`=`valore``. Se vuoi che l'attributo sia trattato come uno obbligatorio, apponi un punto esclamativo (ad esempio `CN!,L,OU,O!,C!,EMAIL!`, che tra l'altro è la configurazione predefinita).

Usando il modificatore di modalità di KIOSK `$e` è possibile recuperare i valori dalle variabili d'ambiente, o dall'esecuzione di uno script o di un file binario. Se inoltre vuoi impedire la modifica dei campi rispettivi, usa il modificatore `$i`. Se vuoi impedire l'uso del pulsante Inserisci il mio indirizzo, imposta `ShowSetWhoAmI` a `false`.

A causa della natura dell'infrastruttura KIOSK di &kde;, l'uso del contrassegno immutabile (`$i`) impedisce all'utente di cambiarlo. Questo è il comportamento voluto. `$i` e `$e` possono anche essere usate con tutte le altre chiavi di configurazione di &kde;.

L'esempio seguente illustra delle possibili personalizzazioni:

    [CertificateCreationWizard]
    ; Impedisci la copia di dati personali dalla rubrica, non permettere modifiche locali
    ShowSetWhoAmI[$i]=false

    ; Imposta il nome utente a $USER
    CN[$e]=$USER

    ; Imposta in nome della ditta a «Digitex», impedisci la modifica
    OU[$i]=Digitex

    ; Imposta il nome del dipartimento con il valore restituito da uno script
    O[$ei]=$(lookup_dept_from_ip)

    ; Imposta il codice paese a IT, ma permetti all'utente di cambiarlo
    C=IT

#### Limitare il tipo di chiavi che un utente può creare

&kleopatra; permette anche di limitare quale tipo di certificati possono essere creati da un utente. Nota, però, che un modo semplice di aggirare queste restrizioni è crearne uno dalla riga di comando.

##### Algoritmi a chiave pubblica

Per limitare l'algoritmo a chiave pubblica da usare, aggiungi la chiave di configurazione `PGPKeyType` (e `CMSKeyType`, ma è comunque supportato solo RSA per CMS) nella sezione `CertificateCreationWizard` di `kleopatrarc`.

I valori ammessi sono `RSA` per chiavi RSA, `DSA` per chiavi (di sola firma) DSA, e `DSA+ELG` per una chiave (di sola firma) DSA con una sottochiave Elgamal per la cifratura.

Il valore predefinito viene letto da &gpgconf; o altrimenti si assume `RSA` se &gpgconf; non ha un valore predefinito.

##### Dimensione della chiave pubblica

Per limitare le dimensioni delle chiavi per un algoritmo pubblico, aggiungi la chiave di configurazione ``<ALG>`KeySizes` (dove `ALG` può essere `RSA`, `DSA` o `ELG`) nella sezione `CertificateCreationWizard` di `kleopatrarc`, contenente un elenco separato da virgole di dimensioni di chiavi (in bit). Un valore predefinito può essere indicato prefiggendo la dimensione con un trattino (`-`).

    RSAKeySizes = 1536,-2048,3072

Quanto sopra limiterebbe le dimensioni delle chiavi RSA a 1536, 2048 e 3072, con 2048 come valore predefinito.

Oltre alle dimensioni stesse, puoi anche specificare le etichette di ogni dimensione. Basta impostare la chiave di configurazione ``ALG`KeySizeLabels` a un elenco separato da virgole di etichette.

    RSAKeySizeLabels = debole,normale,forte

Quanto sopra, insieme all'esempio precedente, risulterebbe in qualcosa come quanto segue per la selezione:

    debole (1536 bit)
                  normale (2048 bit)
                  forte (3072 bit)

I valori predefiniti corrispondono a quanto segue:

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

### Creare e modificare categorie di chiavi

&kleopatra; permette all'utente di configurare l'aspetto visivo delle chiavi in base al concetto di Categorie di chiavi. Le Categorie di chiavi si usano anche per filtrare l'elenco dei certificati. Questa sezione descrive come modificare le categorie disponibili e aggiungerne di nuove.

Quando cerca di trovare la categoria a cui appartiene una chiave, &kleopatra; la fa passare attraverso una serie di filtri, configurati in `libkleopatrarc`. Il primo filtro che corrisponde definisce la categoria, basandosi su un concetto di specificità, spiegata un po' più avanti.

Ciascun filtro delle chiavi è definito in un gruppo di configurazione chiamato `Key Filter #`n``, dove `n` è un numero a partire da `0`.

Le uniche chiavi obbligatorie in un gruppo `Key Filter #`n`` sono `Name`, contenente il nome della categoria così com'è mostrato nella finestra di configurazione, e `id`, che viene usata come riferimento per il filtro in altre sezioni della configurazione (come `View #`n``).

table-key-filters-appearance elenca tutte le chiavi che definiscono le proprietà visive della categoria (cioè le chiavi che possono essere configurate nella finestra di configurazione), mentre table-key-filters-criteria elenca tutte le chiavi che definiscono il criterio di corrispondenza con le chiavi del filtro.

### Configurazione di chiavi e filtri. Chiavi di definizione delle proprietà di visualizzazione

Chiave di configurazione | Tipo | Descrizione
`background-color` | colore | Il colore di sfondo da usare. Se manca, verrà usato il colore di sfondo definito globalmente per le viste a elenco.
`foreground-color` | colore | Il colore di primo piano da usare. Se manca, verrà usato il colore usato globalmente per le viste a elenco.
`font` | carattere | Il carattere da usare. Il carattere sarà adattato alla dimensione configurata per le viste a elenco, e ne verranno applicati gli attributi.
`font-bold` | booleano | Se impostato a `true` e `font` non è impostato, usa il carattere predefinito per le viste a elenco con l'aggiunta dello stile grassetto, se disponibile. È ignorato se è presente anche `font`.
`font-italic` | booleano | Simile a `font-bold`, ma si usa un carattere corsivo invece che grassetto.
`font-strikeout` | booleano | Se è `true`, traccia una riga centrata sopra i caratteri. È applicato anche se `font` è impostato.
`icon` | testo | Il nome dell'icona da mostrare nella prima colonna. Non ancora implementato.

### Configurazione delle chiavi-filtro. Chiavi di definizione dei criteri di filtraggio

Chiave di configurazione | Tipo | Se specificato, il filtro corrisponde quando...
`is-revoked` | booleano | la chiave è stata revocata.
`match-context` | contesto Il contesto è un'enumerazione con i seguenti valori previsti: `appearance` (aspetto), `filtering` (filtraggio) e `any` (qualsiasi). | il contesto in cui questo filtro corrisponde.
`is-expired` | booleano | la chiave è scaduta.
`is-disabled` | booleano | la chiave è stata disabilitata (segnata come da non usare) dall'utente. Ignorata per le chiavi &smime;.
`is-root-certificate` | booleano | la chiave è un certificato radice. Ignorato per le chiavi &openpgp;.
`can-encrypt` | booleano | la chiave può essere usata per la cifratura.
`can-sign` | booleano | la chiave può essere usata per la firma.
`can-certify` | booleano | la chiave può essere usata per firmare (certificare) altre chiavi.
`can-authenticate` | booleano | la chiave può essere usata per l'autenticazione (per esempio come un certificato cliente TLS).
`is-qualified` | booleano | la chiave può essere usata per fare firme qualificate (come definite dalla legge tedesca sulle firme digitali).
`is-cardkey` | booleano | il materiale della chiave è memorizzato su una smartcard (invece che sul computer).
`has-secret-key` | booleano | è disponibile la chiave segreta di questa coppia di chiavi.
`is-openpgp-key` | booleano | la chiave è una chiave &openpgp; (`true`) o una chiave &smime; (`false`).
`was-validated` | booleano | la chiave è stata convalidata.
``prefisso`-ownertrust` | validità La validità è una enumerazione (ordinata) con i seguenti valori possibili: `unknown` (sconosciuta), `undefined` (non definita), `never` (mai), `marginal` (marginale), `full` (completa), `ultimate` (assoluta). Vedi i manuali di &gpg; e &gpgsm; per una spiegazione dettagliata. | la chiave ha esattamente (`prefisso` = `is`), ha qualunque cosa tranne (`prefisso` = `is-not`), ha almeno (`prefisso` = `is-at-least`), o ha al più (`prefisso` = `is-at-most`) l'affidabilità data come valore della chiave di configurazione. Se è presente più di una chiave ``prefisso`-ownertrust` (con diversi valori di `prefisso`) in un singolo gruppo, il comportamento non è definito.
``prefisso`-validity` | validità | Analogo a ``prefisso`-ownertrust`, ma per la validità della chiave invece dell'affidabilità del proprietario.

Alcuni dei criteri più interessanti, come `is-revoked` o `is_expired` funzionano solo su chiavi `convalidate`, e questo è il motivo per cui, normalmente, solo per le chiavi convalidate sono controllate la revoca e la scadenza, sebbene tu possa eliminare questi controlli supplementari.

Oltre alle chiavi di config mostrate sopra, un filtro per le chiavi può anche avere `id` e `match-contexts`.

In altre parti della configurazione (per esempio nella configurazione delle viste di &kleopatra;) puoi fare riferimento al filtro per le chiavi usando il suo `id` che, se non viene specificato, è il nome del gruppo di configurazione. L'`id` non viene interpretato da &kleopatra;, quindi puoi usare una sequenza di caratteri a piacere, a patto che sia univoca.

`match-contexts` limita l'applicabilità del filtro. Attualmente sono definiti due contesti: il contesto `appearance` è usato quando si definisce la colorazione e le proprietà dei caratteri delle viste. Il contesto `filtering` è usato per includere (o escludere) selettivamente dei certificati dalle viste. `any` può essere usato per indicare tutti i contesti attualmente definiti, ed è quello predefinito se non viene specificato `match-contexts`, altrimenti non produce alcun contesto. Ciò assicura che nessun filtro per le chiavi finisca morto, cioè senza contesti a cui essere applicato.

Il formato della voce è un elenco di elementi separati da caratteri non di parola. Ciascun elemento può essere preceduto da un punto esclamativo (`!`) per negarne il significato. Gli elementi agiscono in ordine su un elenco interno di contesti, che all'inizio è vuoto. Si può spiegare meglio con un esempio: `any !appearance` è equivalente a `filtering` e `appearance !appearance` produce l'insieme vuoto, allo stesso modo di `!any`. Però gli ultimi due saranno sostituiti internamente da `any`, perché non producono nessun contesto.

In generale, i criteri non specificati (cioè con la voce di configurazione non impostata) non vengono controllati. Se viene fornito un criterio, viene controllato e deve corrispondere perché il filtro nel suo insieme corrisponda, cioè i criteri sono applicati con un'operazione di AND logico.

Ogni filtro ha una specificità implicita, usata per valutare tutti i filtri che corrispondono. I filtri più specifici prevalgono su quelli meno specifici. Se due filtri hanno la stessa specificità, vince il primo nel file di configurazione. La specificità di un filtro è proporzionale al numero di criteri che contiene.

#### Esempi di filtri sulle chiavi

Per controllare tutti i certificati radice scaduti, ma non revocati, potresti usare un filtro sulle chiavi come il seguente:

    [Key Filter #n]
    Name=scaduti, ma non revocati
    was-validated=true
    is-expired=true
    is-revoked=false
    is-root-certificate=true
    ; ( specificity 4 )

Per controllare tutte le chiavi &openpgp; disabilitate (non ancora gestito da &kleopatra;) con fiducia nei confronti del proprietario di almeno marginal, potresti usare:

    [Key Filter #n]
    Name=Chiavi OpenPGP disabilitate con affidabilità marginale o migliore
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

### Configurare programmi di archiviazione per file di firma e cifratura

&kleopatra; permette all'amministratore (e all'utente avanzato) di configurare l'elenco di programmi di archiviazione presentati nella finestra Firma/Cifra file.

Ogni programma di archiviazione è definito in `libkleopatrarc` come un gruppo `Archive Definition #`n`` a sé, con le seguenti chiavi obbligatorie:

`extensions`

- Un elenco separato da virgole di estensioni di nomi di file che normalmente indicano questo formato d'archiviazione.

`id`

- Un identificativo univoco usato per indentificare internamente questo archivio. Se non sei sicuro, usa il nome del comando.

`Name` (tradotto)

- Il nome di questo programma di archiviazione così com'è visibile all'utente nel menu a tendina corrispondente della finestra Firma/Cifra file.

`pack-command`

- Il comando vero e proprio per archiviare i file. Puoi usare qualsiasi comando, purché non sia richiesta una shell per eseguirlo. Il file del programma viene recuperato con la variabile d'ambiente `PATH`, a meno che venga usato un percorso assoluto. Le virgolette sono supportate come se si usasse una shell:

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

Siccome la barra inversa (`\`) è un carattere di escape nei file di configurazione di &kde;, devi raddoppiarla quando compare nei percorsi:

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

Tuttavia, per il comando di per sé (non per i suoi argomenti), puoi usare solo delle barre (`/`) come separatori di percorso su tutte le piattaforme:

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

Ciò non è supportato per gli argomenti, perché la maggior parte dei programmi &Windows; usa la barra inversa per le opzioni. Per esempio, quanto segue non funziona, perché `C:/mioscriptdiarchiviazione.bat` è un argomento di `cmd.exe`, e `/` non viene convertito in `\` negli argomenti, solo nei comandi:

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

Ciò va scritto invece come:

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

#### Passaggio dei nomi dei file di input per `pack-command`

Ci sono tre modi di passare i nomi dei file al comando di archiviazione. Per ciascuno di questi, `pack-command` ha una sintassi particolare:

1. Come argomenti da riga di comando.

   Esempio (tar):

       pack-command=tar cf -

   Esempio (zip):

       pack-command=zip -r - %f

   In questo caso, i nomi dei file vengono passati sulla riga di comando, come faresti usando il prompt dei comandi. &kleopatra; non usa una shell per eseguire il comando; quindi, è un modo sicuro di passare i nomi dei file, ma potrebbe raggiungere delle restrizioni sulla lunghezza della riga di comando su alcune piattaforme. Un segnaposto `%f`, se presente, viene sostituito dai nomi dei file da archiviare. Altrimenti, i nomi dei file vengono aggiunti alla fine della riga di comando. Quindi, l'esempio zip sopra potrebbe essere anche scritto come:

       pack-command=zip -r -

2. Attraverso lo standard input, separato da ritorni a capo: prefiggi `|`.

   Esempio (&GNU; tar):

       pack-command=|gtar cf - -T-

   Esempio (zip):

       pack-command=|zip -@ -

   In questo caso, i nomi dei file vengono passati al programma di archiviazione sullo standard input, uno per riga. Questo evita problemi su piattaforme che hanno limiti bassi sul numero di argomenti permessi sulla riga di comando, ma non funziona quando i nomi dei file stessi contengono dei ritorni a capo.

   &kleopatra; attualmente supporta solo LF come separatore di ritorno a capo, non CRLF. Questo potrebbe venire modificato in futuro, secondo l'opinione degli utenti.

3. Attraverso lo standard input, separato da byte nulli: prefiggi `0|`.

   Esempio (&GNU; tar):

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

   Questo è lo stesso di sopra, tranne che si usano byte nulli per separare i nomi dei file. Siccome i byte nulli non possono far parte dei nomi dei file, questo è il modo più robusto di passarli, ma non tutti i programmi lo supportano.

### Configurare i programmi dei codici di controllo per l'uso con Crea/Verifica codici di controllo

&kleopatra; permette all'amministratore (e all'utente avanzato) di configurare l'elenco di programmi per i codici di controllo tra cui l'utente può scegliere nella finestra di configurazione e che &kleopatra; può rilevare automaticamente quando le si chiede di verificare il codice di controllo di un certo file.

Per essere utile a &kleopatra;, il risultato dei programmi per i codici di controllo (sia il file scritto dei codici di controllo, che il risultato sullo standard output quando si verificano i codici) deve essere compatibile con &GNU; `md5sum` e `sha1sum`.

Nello specifico, il file dei codici di controllo deve essere basato su righe, con ogni riga avente il seguente formato:

    codice_controllo ' ' ( ' ' | '*' ) nome_file

dove`codice_controllo` consiste di soli carattere esadecimali. Se `nome_file` contiene un carattere di ritorno a capo, la riga deve invece essere:

    \codice_controllo ' ' ( ' ' | '*' ) nome_file_quotato

dove `nome_file_quotato` è il nome del file con i ritorni a capo sostituiti da `\n`, e le barre inverse raddoppiate (`\`↦`\\`).

Similmente, il risultato di checksum-definition-verify-command deve essere nella forma

    nome_file ( ': OK' | ': FAILED' )

separata da ritorni a capo. I ritorni a capo e altri caratteri non vengono quotati nel risultato.

È vero, questi programmi non sono stati scritti pensando alle interfacce grafiche, e &kleopatra; non gestirà correttamente dei nomi di file patologici che contengono `: OK` e un ritorno a capo.

Ogni programma per i codici di controllo è definito in `libkleopatrarc` come un gruppo `Checksum Definition #`n``, con le seguenti chiavi obbligatorie:

`file-patterns`

- Un elenco di espressioni regolari che descrivono quali file andrebbero considerati file di codici di controllo per questo programma. La sintassi è quella usata per gli elenchi di stringhe nei file della configurazione di &kde;.

  Siccome le espressioni regolari contengono spesso delle barre inverse, si deve fare attenzione a quotarle appropriatamente nel file di configurazione. Si raccomanda l'uso di uno strumento di modifica dei file di configurazione.

  La piattaforma definisce se gli schemi sono da trattare distinguendo le maiuscole o meno.

`output-file`

- Il nome tipico del file risultante per questo programma per codici di controllo (ovviamente dovrebbe corrispondere a uno dei checksum-definition-file-patterns). Questo è ciò che &kleopatra; userà come nome di file risultante quando creerà file di codici di controllo di questo tipo.

`id`

- Un identificativo univoco usato per identificare internamente questo programma per codici di controllo. Se hai dei dubbi, usa il nome del comando.

`Name` (tradotto)

- Il nome visibile all'utente di questo programma per codici di controllo, così come mostrato nel menu a cascata nella finestra di configurazione di &kleopatra;.

`create-command`

- Il comando vero e proprio con cui creare file di codici di controllo. La sintassi, le restrizioni e le opzioni che passano argomenti sono le stesse come descritto per archive-definition-pack-command neladmin-archive-definitions.

`verify-command`

- Come checksum-definition-create-command, ma per la verifica dei codici di controllo.

Ecco un esempi completo:

    [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

## Riconoscimenti e licenza

&kleopatra; © 2002 di &Steffen.Hansen;, &Matthias.Kalle.Dalheimer; e &Jesper.Pedersen;, © 2004 di &Daniel.Molkentin;, © 2004, 2007-2010 di Klarälvdalens Datakonsult AB.

La documentazione è copyright 2002 di &Steffen.Hansen;, copyright 2004 di &Daniel.Molkentin;, copyright 2004,2010 di Klarälvdalens Datakonsult AB.

## Hanno contribuito

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

Traduzione del programma di Alessandro Astarita, traduzione della documentazione a cura di Luciano Montanaro, manutenzione a cura di Federico Zenith federico.zenith@member.fsf.org

&underFDL; &underGPL;
&documentation.index;