# Manuel de &kleopatra;

Marc
Mutz

    marc@kdab.net

David
Faure
Développeur
Steffen
Hansen

    &Steffen.Hansen.mail;

Développeur
Matthias Kalle
Dalheimer
Développeur
Jesper
Pedersen

    &Jesper.Pedersen.mail;

Développeur
Daniel
Molkentin

    &Daniel.Molkentin.mail;

Développeur

&traducteurJoelleCornavin; &traducteurRobinGuitton;
&GPLNotice;
2010-04-27
2.0.14

&kleopatra; est un outil permettant de gérer les certificats X.509 et OpenPGP.

KDE
Kapp
X509
OpenPGP
PGP
LDAP
gpg
gpgsm
certificat

## Introduction

&kleopatra; est l'outil de &kde; permettant de gérer les certificats X.509 et OpenPGP dans les trousseaux &gpgsm; et &gpg; et de recevoir des certificats depuis des serveurs &ldap; et depuis d'autres serveurs de certificats.

Vous pouvez démarrer &kleopatra; depuis le menu Outils Gestionnaire des certificats de &kmail; aussi bien qu'en ligne de commande. L'exécutable &kleopatra; est appelé ``kleopatra``.

Ce programme tire son nom de Cléopâtre, une célèbre pharaonne égyptienne qui vivait du temps de Jules César avec qui elle eu un enfant, Caeserion, non reconnu comme son héritier.

Le choix du nom de ce programme vient des Projets Ägypten (Ägypten signifie Égypte en allemand). Kleopatra est l'orthographe allemande de Cléopâtre.

## Fonctions principales

### Afficher le trousseau local

La fonction principale de &kleopatra; est d'afficher et de modifier le contenu du trousseau local, similaire au concept des trousseaux de clés de &gpg;, quoiqu'il ne faille pas trop forcer l'analogie.

La fenêtre principale se compose de la grande zone de listage des clés se composant de plusieurs onglets, la barre de menus et la barre de recherche en haut, ainsi que d'une barre d'état en bas.

Chaque ligne de la liste des clés correspond à un certificat, identifié par ce qu'on appelle le &dn; du sujet. &dn; est un acronyme pour « Nom Distinct » (Distinguished Name), un identifiant hiérarchique, tout comme l'emplacement d'un système de fichiers avec une syntaxe inhabituelle, censé identifier globalement et de façon unique un certificat donné.

Pour être valables, donc utilisables, les clés (publiques) doivent être signées par une &ca; (autorité de certification, Certification Authority). Ces signatures sont appelées certificats, mais d'ordinaire les termes certificat et clé (publique) s'utilisent de manière interchangeable : en conséquence, nous ne ferons pas de distinction entre elles dans ce manuel, sauf indication explicite.

Les &ca;s doivent à leur tour être signées par d'autres &ca;s pour être valables. Naturellement, l'opération doit prendre fin quelque part, de façon que l'&ca; de premier niveau (&ca; racine) signe sa clé avec elle-même (on parle alors d'auto-signature). Il faut donc affecter manuellement une validité (communément dénommée « confiance ») aux certificats racines, &pex; après avoir comparé l'empreinte numérique avec celle qui se trouve sur le site web de l'&ca;. Cette tâche est généralement dévolue à l'administrateur système ou au fabricant d'un produit faisant intervenir des certificats, mais peut être effectuée par l'utilisateur au moyen de l'interface en ligne de commande de &gpgsm;.

Pour voir lesquels des certificats sont des certificats racines, passez en mode liste de clés hiérarchique avec .

Vous pouvez voir les détails d'un certificat donné en double-cliquant dessus ou à l'aide de . Une boîte de dialogue s'ouvre, qui affiche les propriétés les plus courantes du certificat, sa chaîne de certificats (&cad; la chaîne des émetteurs jusqu'à l'&ca; racine) ainsi qu'un cliché de toutes les informations que le système est en mesure d'extraire du certificat.

Si vous changez le trousseau sans faire appel à &kleopatra; (&pex; à l'aide de l'interface en ligne de commande de &gpgsm;), vous pouvez rafraîchir la vue avec .

### Rechercher et importer des certificats

La plupart du temps, vous acquerrez de nouveaux certificats en vérifiant les signatures dans les courriers électroniques, puisque les certificats sont imbriqués dans les signatures créées, le plus souvent, en les utilisant. Cependant, si vous devez envoyer un message à quelqu'un avec qui vous n'avez pas encore eu de contact, il vous faut recevoir le certificat dans un dossier &ldap; (bien que &gpgsm; puisse le faire automatiquement) ou depuis un fichier. Vous devez également importer votre propre certificat après avoir reçu la réponse de l'&ca; à votre demande de certification.

Pour rechercher un certificat dans une annuaire &ldap;; sélectionner Fichier Rechercher des certificats sur le serveur et saisissez du texte (&pex; le nom de la personne à qui vous voulez le certificat) dans le champ de la boîte de dialogue Recherche de certificat sur le serveur de certificats. Cliquez alors sur le bouton Rechercher. Les résultats seront affichés dans la liste de clés sous la barre de recherche, où vous pouvez sélectionner des certificats pour les étudier en cliquant sur le bouton Détails ou bien les télécharger dans la trousseau locale avec Importer.

Vous pouvez configurer la liste des serveurs &ldap; pour rechercher dans la page Services d'annuaire de la boîte de dialogue de configuration de &kleopatra;.

Si vous avez reçu le certificat sous la forme d'un fichier, essayez . &gpgsm; doit comprendre le format du fichier de certificat : reportez-vous au manuel de &gpgsm; pour obtenir une liste des formats de fichiers pris en charge.

Si vous n'avez pas créé votre paire de clés avec &gpgsm;, vous devez également importer manuellement la clé publique (ainsi que la clé secrète) à partir du fichier PKCS#12 que vous avez obtenu de l'&ca;. Utilisez pour ce faire la ligne de commande avec ``kleopatra `--import-certificate` `nom_du_fichier``` ou dans &kleopatra; avec , tout comme vous le feriez pour les certificats normaux.

### Créer de nouvelles paires de clés

L'élément de menu démarre l'Assistant de création de certificat qui vous guidera à travers un certain nombre d'étapes pour créer une demande de certificat.

Chaque fois que vous avez terminé une étape dans l'assistant, cliquez sur Suivant pour passer à la suivante (ou sur Précédent pour revoir les étapes déjà achevées). La création de demande de certificat peut être annulée à tout moment en cliquant sur le boutonAnnuler.

Sur la première page de l'assistant, choisissez quel type de certificat vous voulez créer :

Créer une paire de clés personnelles OpenPGP

  Les paires de clés OpenPGP sont créées localement et sont certifiées par vos amis et connaissances. Il n'y a pas d'autorité de certification centralisée ; chaque individu crée un réseau de confiance personnel en certifiant les clés des autres utilisateurs avec son propre certificat.

  Vous devez saisir un Nom, une Adresse électronique et facultativement un Commentaire.

Créer une paire de clés X.509 personnelle et une demande de certification

  Les paires de clés X.509 sont créées localement mais sont certifiées de manière centralisée par une autorité de certification (&ca;). Les &ca; peuvent certifier d'autres &ca;, créant ainsi une chaîne de confiance hiérarchisée et centralisée.

  L'étape suivante de l'assistant vous demande de saisir vos données personnelles pour le certificat. Les champs à renseigner sont :

  - Nom d'usage (CN) : Votre nom ;

  - Adresse électronique (EMAIL) : Votre adresse électronique ; prenez soin de la saisir correctement—ce sera l'adresse à laquelle vos correspondants enverront le courriel lorsqu'ils utilisent votre certificat.

  - Localité (L) : La ville où vous habitez ;

  - Unité organisationnelle (OU) : L'unité organisationnelle dans laquelle vous êtes (&pex;, « Logistique ») ;

  - Organisation (O) : L'organisation que vous représentez (&pex;, l'entreprise dans laquelle vous travaillez) ;

  - Indicatif du pays (C) : Le code à deux lettres du pays dans lequel vous résidez (&pex;, « FR » pour la France) ;

  Dans l'étape suivante, l'assistant vous demande de choisir s'il doit enregistrer le certificat dans un fichier ou l'envoyer directement à une &ca;. Vous devrez spécifier le nom du fichier ou l'adresse électronique à laquelle envoyer la demande de certificat.

## Liste des menus

### Menu Fichier

&Ctrl;N Fichier Nouveau certificat...

  Créé une nouvelle paire de clés (publique et privée) et permet d'envoyer la partie publique à une autorité de certification (&ca;) pour sa signature. Le certificat qui en résulte vous est ensuite renvoyé ou enregistré sur un serveur &ldap; pour que vous le téléchargiez dans votre trousseau local, dans lequel vous pouvez vous en servir pour signer et déchiffrer des messages.

  Ce mode de fonctionnement est appelé génération décentralisée des clés du fait que toutes les clés sont créées localement. &kleopatra; (et &gpgsm;) ne gèrent pas la génération décentralisée des clés directement, mais vous pouvez importer le lot de clés publiques/secrètes que vous recevez de l'&ca; au format PKCS#12 via .

&Ctrl;&Maj;I Fichier Rechercher des certificats sur le serveur...

  Recherche et importe des certificats depuis des serveurs de certificats dans le trousseau local. Voir pour plus de détails.

  Vous devez avoir des serveurs de clés configurés pour cette tâche. Voir pour plus de détails.

&Ctrl;I Fichier Importer des certificats...

  Importe des certificats et/ou des clés secrètes depuis des fichiers dans le trousseau local. Voir pour plus de détails.

  Le format du fichier certifié doit être géré par &gpgsm;/&gpg;. Reportez-vous au manuel de &gpgsm; et de &gpg; pour obtenir une liste des formats pris en charge.

&Ctrl;E Fichier Exporter des certificats...

  Exporte les certificats sélectionnés dans un fichier.

  L'extension du nom de fichier que vous choisissez pour exporter le fichier détermine le format du fichier exporté :

  - Pour les certificats OpenPGP, les extensions `gpg` et `pgp` auront comme résultat un fichier binaire, tandis que l'extension `asc` produira un fichier &ascii; blindé.

  - Pour les certificats &smime;, l'extension `der` aura comme résultat un fichier binaire encodé en &der;, alors que l'extension `pem` produira un fichier &ascii; blindé.

  À moins que plusieurs certificats ne soient sélectionnés, &kleopatra; proposera `empreinte_numérique.{asc,pem}` comme nom de fichier exporté.

  Cette fonction est disponible seulement quand un ou plusieurs certificats ont été sélectionné.

  Cette fonction n'exporte que les clés publiques, même si la clé secrète est disponible. Utilisez pour exporter à la fois les clés publiques et privées dans un fichier, mais notez bienque ce procédé est généralement peu judicieux.

Fichier Exporter le certificat secret...

  Exporte à la fois la clé publique et la clé secrète dans un fichier.

  Dans la boîte de dialogue qui s'ouvre, vous pouvez choisir un nom de Fichier de sortie, et si vous voulez créer un fichier binaire ou un fichier exporté &ascii; blindé (ASCII armor). Quand vous exportez des clés secrètes &smime;, vous pouvez aussi choisir le Jeu de caractères de la phrase secrète. Reportez vous à l'explication de l'option `--p12-charset charset` dans le manuel de &gpgsm; pour plus de détails.

  Cette fonction n'est disponible que si exactement un certificat a été sélectionné et que la clé secrète pour ce certificat est disponible.

  L'utilisation de cette fonction devrait être rarement nécessaire, mais s'il faut l'envisager, la prudence est de mise. Planifier la migration d'une clé secrète implique le choix des média de transport et, entre autres choses, une suppression sécurisée des données-clés présentes sur l'ancienne machine, ainsi que sur le moyen de transport.

&Ctrl;&Maj;E Fichier Exporter des certificats vers le serveur...

  Exporte les certificats sélectionnés sur un serveur de clés (seulement pour &openpgp;)..

  Le certificat est envoyé au serveur de certificats configuré pour &openpgp; (cf. ), si déterminé, ou sinon à keys.gnupg.net.

  Cette fonction n'est disponible que si au moins un certificat &openpgp; (et non &smime;) a été sélectionné.

  Quand les certificats OpenPGP ont été exporté vers un serveur d'annuaire publique, il est quasiment impossible de les y supprimer. Avant d'exporter votre certificat vers un serveur d'annuaire publique, assurez vous doncd'avoir créé un certificat de révocation afin de pouvoir révoquer le certificat ultérieurement si besoin.

  La plupart des serveurs de certificats &openpgp; synchronise les certificats entre eux, il est donc vain d'en envoyer plus d'un.

  Il peut arriver qu'une recherche sur un serveur de certificat ne retourne aucun résultat bien que vous veniez d'y envoyer votre certificat. Cela s'explique par le fait que la plupart des adresses de serveur de clés publique utilise la technique du DNS round-robin pour répartir la charge sur plusieurs machines. Ces machines se synchronisent les une avec les autres mais, généralement, seulement toutes les 24 heures voire plus.

Fichier Déchiffrer/Vérifier des fichiers...

  Déchiffre des fichiers et/ou vérifie des signatures sur des fichier.

Fichier Signer/Chiffrer des fichiers...

  Signe et/ou chiffre des fichiers.

&Ctrl;W Fichier Fermer

  Ferme la fenêtre principale de &kleopatra;. Vous pouvez la restaurer depuis la boîte à miniatures à n'importe quel moment.

&Ctrl;Q Fichier Quitter

  Met fin à &kleopatra;.

### Menu Affichage

F5 Affichage Actualiser

  Rafraîchit la liste des certificats.

  Utiliser cette fonction n'est généralement pas nécessaire, comme &kleopatra; surveille les changements du système de fichiers et rafraîchie automatiquement la liste des certificats lorsque cela est nécessaire.

&Echap; Affichage Arrêter l'opération

  Arrête (annule) toutes les opérations en attente, &pex; une recherche, un listage des clés ou un téléchargement.

  Cette fonction n'est disponible que si au moins une opération est en cours.

  À cause de limitations du moteur, des opérations se bloquent parfois de telle façon que cette fonction ne sera capable de les annuler instantanément, voir pas du tout.

  En pareils cas, la seule façon de rétablir l'ordre est de terminer, dans cet ordre, les processus de &scdaemon;, &dirmngr;, &gpgsm; et &gpg; via les outils du système d'exploitation (`top`, Gestionnaire des tâches de Windows, &etc;), jusqu'à ce que l'opération se débloque.

Affichage Détails du certificat

  Affiche les détails du certificat actuellement sélectionné.

  Cette fonction est disponible seulement si exactement un certificat est sélectionné.

  Cette fonction est également accessible en double-cliquant directement sur l'élément correspondant dans l'affichage en liste.

Affichage Liste hiérarchique des certificats

  Bascule entre les modes liste hiérarchique et à plat des certificats.

  En mode hiérarchique, les certificats sont organisés dans une relation émetteur/sujet, de telle sorte qu'il est facile de voir à quelle hiérarchie de certification un certificat donné appartient. Cependant, ce dernier est ainsi initialement plus difficile à trouver (bien que vous disposiez de la barre de recherche).

  En mode à plat, tous les certificats sont affichés dans une liste étendu, triés par ordre alphabétique. Dans ce mode, un certificat donné est facile à trouver, mais il n'est pas évident de savoir directement à quel certificat racine il appartient.

  Cette fonction bascule vers le mode hiérarchique par onglet, &cad; que chaque onglet a son propre état hiérarchique. Vous pouvez donc disposer à la fois d'un listage à plat et hiérarchique, chacun dans leur onglet respectif.

  L'affichage hiérarchique est actuellement seulement implémenté pour les certificats &smime;. Il y a un désaccord parmi les développeurs sur la façon convenable d'afficher les certificats &openpgp; hiérarchiquement (fondamentalement, parent &equals; signer ou parent &equals; signee).

&Ctrl;. Affichage Tout développer

  Développe tous les éléments de la liste dans l'affichage par liste des certificats, &cad; rend tous les éléments visibles.

  C'est le comportement par défaut lorsqu'on entre en mode liste de clés hiérarchique.

  Vous pouvez, naturellement, encore développer et réduire chaque élément individuellement.

  Cette fonction est disponible seulement quand est activé.

&Ctrl;, Affichage Tout réduire

  Réduit tous les éléments de la liste dans l'affichage en liste des certificats, &cad; masque tout sauf les éléments de premier niveau.

  Vous pouvez, naturellement, encore développer et réduire chaque élément individuellement.

  Cette fonction est disponible seulement quand est activé.

### Menu Certificats

Certificats Changer le niveau de confiance...

  Affiche le niveau de confiance du certificat &openpgp; actuellement sélectionné.

  Cette fonction est disponible seulement quand exactement un certificat &openpgp; est sélectionné.

Certificats Certificat racine de confiance

  Marque ce certificat racine (&smime;) comme de confiance.

  D'une certaine façon, c'est l'équivalent de pour les certificats racines &smime;. Vous pouvez cependant seulement choisir—dans les termes de &openpgp;—entre confiance absolue et aucune confiance.

  Le moteur (par le biais de &gpgagent;) demandera, au moment de l'importation de certificats racines, s'il faut faire confiance au certificat racine importé. Toutefois, cette fonction doit être explicitement activée dans la configuration du moteur (`allow-mark-trusted` dans `gpg-agent.conf`, ou sinon GnuPG System GPG Agent Autoriser les clients à marquer les clés comme « de confiance » ou S/MIME Validation Autorisé le marquage de confiance de certificats racines dans ).

  Activer cette fonctionnalité dans le moteur peut vous amenez à être dérangé par des menus contextuels venant de &pinentry; à des moments inopportuns (&cad; à la vérification des signatures), et peut ainsi bloquer le traitement des courriers électroniques laissé sans surveillance. Pour cette raison, et parce qu'il est souhaitable d'être en mesure de ne plus faire confiance à un certificat racine de confiance de nouveau, &kleopatra; permet le réglage manuel du niveau de confiance.

  À cause d'un manque de prise en charge du moteur pour cette fonction, &kleopatra; a besoin de travailler directement sur une base de données de confiance &gpgsm; (`trustlist.txt`). Quand vous utilisez cette fonction, soyez sûr qu'aucune autre opération de cryptographie n'est en cours, qui pourrait concurrencer &kleopatra; dans la modification de cette base de données.

  Cette fonction est disponible seulement quand exactement un certificat racine &smime; est sélectionné et que ce certificat n'est pas encore de confiance.

  Utilisez pour annuler cette fonction.

Certificats Certificat racine de méfiance

  Marque ce certificat racine (&smime;) comme de méfiance.

  Cette fonction est disponible seulement quand exactement un certificat racine &smime; est sélectionné, et que ce certificat est actuellement de confiance.

  Utiliser pour annuler. Voir là-bas pour plus de détails.

Certificats Certifier le certificat...

  Vous permet de certifier un autre certificat &openpgp;.

  Cette fonction est disponible seulement quand exactement un certificat &openpgp; est sélectionné.

Certificats Changer la date d'expiration...

  Vous permet de changer la date d'expiration de votre certificat &openpgp;.

  Utilisez cette fonction pour prolonger la durée du vie de vos certificats &openpgp; et comme alternative à la création d'un nouveau, ou définissez une durée de vie illimitée (n'expire jamais).

  Cette fonction est disponible seulement si exactement un certificat &openpgp; est sélectionné et que la clé secrète est disponible pour ce certificat.

Certificats Changer la phrase secrète...

  Permet de changer la phrase secrète de votre clé secrète

  Cette fonction est disponible seulement si exactement un certificat &openpgp; est sélectionné et que la clé secrète est disponible pour ce certificat. Elle requiert un moteur très récent, puisque nous avons changé l'implémentation d'un appel directe de &gpg; et &gpgsm; vers un appels'appuyant sur &gpgme;.

  Pour des raisons de sécurité, à la fois l'ancienne ainsi que la nouvelle phrase secrète est demandée par &pinentry;, un processus séparé. Dépendant de la plate-forme sur laquelle vous tournez et de la qualité de l'implémentation de &pinentry; sur cette plate-forme, il peut arriver que la fenêtre de &pinentry; se lance en arrière plan. En conséquence, si vous sélectionnez cette fonction et que rien ne se passe, vérifiez la barre des tâche de votre système d'exploitation au cas où la fenêtre de &pinentry; se serait ouverte en arrière plan.

Certificats Ajouter un identifiant utilisateur...

  Permet l'ajout d'un nouvel identifiant utilisateur à votre certificat &openpgp;.

  Utilisez cette fonction pour ajouter une nouvelle identité à un certificat existant et comme alternative à la création d'une nouvelle paire de clé.

      Nom Réel (Commentaire) <Adresse électronique>

  Dans la boîte de dialogue qui apparaît quand vous sélectionnez cette fonction, &kleopatra; vous demandera chacun des trois paramètres séparément (Nom Réel, Commentaire et Adresse électronique) et affichera un aperçu des résultats.

  Ces paramètres sont sujets aux mêmes restrictions de l'administrateur que dans les nouveaux certificats. Voir et pour plus de détails.

  Cette fonction est disponible seulement si exactement un certificat &openpgp; est sélectionné, et que la clé secrète est disponible pour ce certificat.

Suppr Certificats Supprimer

  Supprime les certificats sélectionnés du trousseau de clés local.

  Cette fonction sert à supprimer des clés inutilisées de votre trousseau local. Toutefois, comme les certificats sont généralement attachés à des courriers électroniques signés, la vérification d'un courriel peut faire réapparaître dans le trousseau local la clé qui vient d'être supprimée. Il est donc certainement préférable d'éviter de faire appel à cette fonction autant que faire se peut. Si vous êtes perdu, utilisez la barre de recherche ou la fonction pour retrouver le contrôle sur l'ensemble des certificats.

  Il y a une exception à ce qui vient d'être dit : quand vous supprimez un de vos propre certificat, vous supprimez du même coup la clé secrète. Cela implique que vous ne serez plus à même de lire d'anciennes communications chiffrées utilisant ce certificat, à moins que vous ne les ayez sauvegardées quelque part.

  &kleopatra; vous alertera quand vous tenterez de supprimer une clé secrète.

  À cause de la nature hiérarchicale des certificats &smime;, si jamais vous supprimez un émetteur de certificat &smime; (&ca; certificat), tous les sujets seront également supprimés. Ce comportement est identique à celui d'un système de fichiers : quand vous supprimez un dossier, tous les dossiers et fichiers qu'il contient sont également supprimés.

  Bien entendu, cette fonction n'est disponible que si vous sélectionnez au moins un certificat.

Certificats Copie (dump) du certificat

  Affiche toutes les informations que &gpgsm; possède au sujet du certificat (&smime;) sélectionné.

  Voir l'explication au sujet de `--dump-key key` dans le manuel de &gpgsm; pour plus de détails sur cette sortie.

### Menu Outils

Tools Afficheur de journaux GnuPG...

  Démarre &kwatchgnupg;, un outil qui présente la sortie de déboguage des applications &gnupg;. Si la signature, le chiffrement ou la vérification s'arrête mystérieusement de fonctionner, vous pourriez trouver pourquoi en regardant à l'intérieur du journal.

  Cette fonction n'est pas disponible sur Windows, étant donné que les mécanismes sous-jacents ne sont pas implémentés dans le moteur sur cette plate-forme.

Tools Rafraîchir les certificats OpenPGP

  Rafraîchit tous les certificats &openpgp; en exécutant

      gpg --refresh-keys

  . Après l'exécution réussi de la commande, votre trousseau local répercutera tous les derniers changements concernant la validité des certificats &openpgp;.

  Voir les notes de pour quelques mises en garde.

Outils Rafraîchir les certificats X.509

  Rafraîchie tous les certificats &smime; en exécutant

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

  Après l'exécution réussi de la commande, votre trousseau local répercutera tous les derniers changements concernant la validité des certificats &smime;.

  Rafraîchir les certificats &x509; et &openpgp; implique le téléchargement de tous les certificats &crl;s afin de vérifier qu'aucun d'entre eux n'a été révoqué pendant ce temps.

  Ceci peut mettre à rude épreuve vos propres connexions réseaux ainsi que celles des autres personnes, et peut prendre jusqu'à une heure ou plus à s'achever en fonction de votre connexion réseau et du nombre de certificats à vérifier.

Outils Importer des LRC depuis un fichier...

  Permet d'importer manuellement des &crl; depuis des fichiers.

  Normalement, les &crl; (Certificate Revocation Lists, liste de révocation des certificats) sont gérées de manière transparente par le moteur, mais il peut parfois s'avérer utile d'importer une &crl; manuellement dans le cache local des &crl;.

  Pour que l'importation des &crl; fonctionne, l'outil &dirmngr; doit être dans le `PATH` de recherche. Si l'élément de menu est désactivé, vous devrez contacter l'administrateur système et lui demander d'installer &dirmngr;.

Outils Effacer le cache des LRC

  Efface le cache des LRC de &gpgsm;.

  Vous n'en aurez probablement jamais besoin. Vous pouvez forcer un rafraîchissement du cache des LRC en sélectionnant tous les certificats et en utilisant à la place.

Outils Copie (dump) du cache des LRC

  Affiche le contenu détaillé du cache des LRC de &gpgsm;.

### Menu Configuration

Configuration Effectuer un contrôle automatique

  Effectue une série de tests automatiques et présente leur résultat.

  C'est la même série de tests que celle lancée par défaut au démarrage. Si vous avez désactivé les tests automatiques effectués au démarrage, vous pouvez les réactivez ici.

Configuration Barre d'outils affichée

  Affiche/cache les barres d'outils de &kleopatra;.

  &kleopatra; possède deux barres d'outils :

  1. Barre principale

     Cette barre d'outils comporte une sélection de fonctions courantes. Vous pouvez configurer quelles fonctions vous souhaitez voir apparaître ici avec .

  2. Barre de recherche

     Cette barre d'outils comporte les boutons de recherche et de filtrage.

Configuration Afficher la barre d'état

  Change la visibilité de la barre d'état située en bas.

Configuration Configurer les raccourcis clavier...

  Ouvre la boîte de dialogue de configuration standard des raccourcis &kde;, dans laquelle vous pouvez affecter et réaffecter des raccourcis clavier pour tous les éléments de menu.

Configuration Configure les barres d'outils...

  Ouvre la boîte de dialogue de configuration standard des raccourcis &kde;, dans laquelle vous pouvez choisir quelles actions inclure dans la barre d'outils de &kleopatra;.

Configuration Configurer &kleopatra;...

  Ouvre la boîte de dialogue de configuration de &kleopatra;.

  Voir pour plus de détails.

### Menu Fenêtre

Le menu Fenêtre vous permet de gérer les onglets. En utilisant les éléments de ce menu, vous pouvez renommer un onglet, en ajouter un nouveau, dupliquer l'onglet courant et le déplacer vers la gauche ou la droite.

En cliquant avec le bouton droit de la souris sur un onglet, vous ouvrez un menu contextuel d'où vous pouvez également sélectionner les même actions.

### Menu Aide

Le menu Aide contient le menu d'aide standard de &kde;.

&help.menu.documentation;

## Liste des options de la ligne de commande

Seules les options spécifiques à &kleopatra; sont répertoriées ici. Comme pour toutes les applications de &kde;, vous pouvez obtenir une liste complète des options à l'aide de la commande ``kleopatra `--help```.

`--external`

  Lance uniquement le serveur d'interfaces, cache la fenêtre principale

`-p` `--openpgp`

  Utilise OpenPGP pour l'opération suivante

`-c` `--cms`

  Utilise CMS (X.509, S/MIME) pour l'opération suivante

`-i` `--import-certificate`

  Spécifie un fichier ou une &URL; depuis laquelle importer des certificats (ou des clés secrètes).

  C'est la ligne de commande équivalente à .

`-e` `--encrypt`

  Chiffre le(s) fichier(s)

`-s` `--sign`

  Signe le(s) fichier(s)

`-E` `--encrypt-sign`

  Chiffre et/ou signe le(s) fichier(s). Identique à `--sign-encrypt`, ne pas utiliser.

`-d` `--decrypt`

  Déchiffre le(s) fichier(s)

`-V` `--verify`

  Vérification du fichier et de la signature

`-D` `--decrypt-verify`

  Déchiffre et/ou vérifie le(s) fichier(s)

## Configurer &kleopatra;

La boîte de dialogue de configuration de &kleopatra; est accessible via .

Chacune des pages qu'elle contient est décrite dans les sections ci-dessous.

### Configurer les services d'annuaire (Directory Services)

Sur cette page, vous pouvez configurer quelles serveurs &ldap; utiliser pour les recherches de certificats &smime; et quelles serveurs de clés utiliser pour les recherches de certificats &openpgp;.

C'est simplement une version plus conviviale de la même configuration que vous pouvez aussi trouver dans la section . Tout ce que vous pouvez configurer ici, vous pouvez le faire également là-bas.

#### Note concernant la configuration de serveurs mandataires

La configuration de serveurs mandataires pour le &http; et le &ldap; peut être effectuée dans , mais seulement pour &gpgsm;. Dans le cas de &gpg;, à cause de la complexité des options de serveurs de clés dans celui-ci et du manque de prise en charge correct pour eux dans &gpgconf;, vous aurez actuellement besoin de modifier le fichier de configuration `gpg.conf` directement. Veuillez vous référez au manuel de &gpg; pour plus de détails. &kleopatra; conservera cette configuration, mais n'autorise pas encore leur modification depuis le &GUI;.

La table des Services d'annuaire affiche quels serveurs sont actuellement configurés. Double-cliquez sur une cellule de la table pour modifier les paramètres des entrées de serveurs existants.

La signification de chaque colonne est la suivante :

Schéma

  Détermine le protocole utilisé pour accéder au serveur. Les schémas les plus souvent utilisées sont le ldap (et son frère ldaps sécurisé avec &ssl;) pour les serveurs &ldap; (protocole courant pour &smime;; le seul supporté par &gpgsm;), et hkp, Horowitz Keyserver Protocol, aujourd'hui habituellement appelé protocole &http; Keyserver, un protocole fondé sur &http; qui prend en charge littéralement tous les serveurs de clés &openpgp; publiques.

  Reportez-vous aux manuels de &gpg; et de &gpgsm; pour obtenir une liste des schémas pris en charge.

Nom de serveur

  Le nom de domaine du serveur, &pex; keys.gnupg.net.

Port du serveur

  Le port réseau que le serveur écoute.

  Lorsque vous changez le , le port par défaut est automatiquement affecté, à moins qu'il n'ai été fixé de débuter à un port non standard. Si vous aviez changer le port par défaut et n'arrivez pas à le rétablir, essayez de configurer vers `http` et vers `80` (celui par défaut pour le &http;), puis repartez à partir de là.

ND de base

  Le ND de base (seulement pour &ldap; et &ldaps;), &cad; la racine de la hiérarchie &ldap; à laquelle débuter. Il est souvent également appelé racine de recherche ou base de recherche.

  Cela ressemble généralement à `c=de,o=Foo`, donné comme faisant partie de l'&URL; &ldap;.

Nom d'utilisateur

  Le nom d'utilisateur, s'il y en a un, utilisé pour se connecter au serveur.

  Cette colonne est affichée seulement si l'option Afficher le nom d'utilisateur et le mot de passe (sous la table) est cochée.

Mot de passe

  Le mot de passe, s'il y en a un, utilisé pour se connecter au serveur

  Cette colonne est affichée seulement si l'option Afficher le nom d'utilisateur et le mot de passe (sous la table) est cochée.

X.509

  Cochez cette colonne si cette entrée devrait être utilisée pour les recherches de certificats &x509; (&smime;).

  Seuls les serveurs &ldap; (et &ldaps;) sont gérés par &smime;.

OpenPGP

  Cochez cette colonne si cette entrée devrait être utilisée pour les recherches de certificats &openpgp;.

Vous pouvez configurer autant de serveurs &smime; (&x509;) que vous le désirez, mais un seul serveur openpgp seulement à la fois est autorisé. Le &GUI; fera respecter cela.

Pour ajouter un nouveau serveur, cliquez sur le bouton Nouveau. Cela dupliquera l'entrée sélectionnée, s'il y en a une, ou sinon ajoutera un serveur &openpgp; de défaut. Vous pouvez alors régler le , le , le , et les habituelles et , qui tous deux ne sont nécessaires que si le serveur requiert une authentification.

Pour ajouter directement une entrée pour un certificat &x509;, utilisez Nouveau X.509 ; utilisez Nouveau OpenPGP pour &openpgp;.

Pour supprimer un serveur de la liste de recherche, sélectionnez-le dans la liste et appuyez sur le bouton Supprimer.

Pour fixer le délai maximal &ldap;, &cad; la durée maximale durant laquelle le moteur attendra une réponse d'un serveur, renseignez simplement le champ de saisie intitulé Délai maximal LDAP (minutes:secondes).

Si un de vos serveurs comporte une base de données si volumineuse que même des recherches raisonnables comme `Dupont` renvoient le nombre maximal d'éléments retournés par la requête, vous pourriez être amené à augmenter cette limite. Vous apprendrez aisément si vous atteignez la limite pendant une recherche, car dans pareil cas apparaît une boîte de dialogue qui vous prévient que les résultats ont été tronqués.

Certains serveurs sont susceptibles d'imposer leurs propres limites sur le nombre d'éléments retournés à partir d'une recherche. Dans ce cas, le fait d'augmenter la limite ici ne donnera pas davantage d'éléments retournés.

### Configurer l'Apparence

#### Configurer les Infobulles

Dans la principale liste de certificats, &kleopatra; peut afficher des détails sur un certificats à l'intérieur d'une infobulle. L'information affichée est la même que dans l'onglet Vue d'ensemble de la boîte de dialogue Détails du certificat. Les infobulles peuvent cependant être limitées à l'affichage d'une fraction d'information pour éviter les redondances.

L'ID de clé est toujours affiché afin de s'assurer que, en fin de compte, les infobulles pour différents certificats diffèrent (cela est spécialement important si seulement a été sélectionné.

Vous pouvez activer ou désactiver indépendemment les réglages suivants :

Afficher la validité

  Affiche des informations sur la validité du certificat : son état actuel, son &dn; d'émetteur (&smime; seulement), ses dates d'expirations (s'il y en a) et ses drapeaux d'utilisation du certificat.

  Exemple :

      Ce certificat est actuellement valable.
      Émetteur :            CN=Test-ZS 7,O=Intevation GmbH,C=DE
      Validité :          De 25.08.2009 10:42 à 19.10.2010 10:42
      Utilisation du certificat : Signe des courriels et des fichiers, Chiffre des courriels et des fichiers
      Empreinte numérique :            DC9D9E43

Afficher les informations sur le propriétaire

  Affiche des informations sur le propriétaire du certificat : &dn; du sujet (&smime; uniquement), identifiants utilisateurs (dont les adresses électroniques) et la confiance envers le propriétaire (&openpgp; seulement).

  Exemple &openpgp; :

      ID utilisateur :           Gpg4winUserA <gpg4winusera@test.hq>
      ID de clé :            C6BF6664
      Confiance envers le propriétaire :        absolu

  Exemple &smime; :

      Sujet :           CN=Gpg4winTestuserA,OU=Testlab,O=Gpg4win Project,C=DE
      Alias :            Gpg4winUserA@test.hq
      ID de clé :            DC9D9E43

Afficher les détails techniques

  Affiche des informations techniques sur le certificat : numéro de série (&smime; uniquement), type, empreinte numérique et emplacement de stockage.

  Exemple :

      Numéro de série :     27
      Type du certificat :  1,024-bit RSA (certificat secret disponible)
      Key-ID :            DC9D9E43
      Empreinte numérique :       854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Conservé :            sur cet ordinateur

#### Configurer les Catégories de certificat.

&kleopatra; vous permet de personnaliser l'apparence des certificats dans l'affichage en liste. Cela inclut l'affichage d'une petite icône mais permet également lamodification des couleurs d'avant-plan (texte) et d'arrière-plan, ainsi que des polices.

Chaque catégorie de certificat de la liste se voit affecter un ensemble de couleurs, une icône (facultative) et une police dans laquelle sont affichés les certificats appartenant à cette catégorie. La catégorie agit aussi comme un aperçu des paramètres. Les catégories peuvent être définis librement par l'administrateur ou l'utilisateur doté de privilèges : reportez-vous à la section dans .

Pour définir ou changer l'icône d'une catégorie, sélectionnez-la dans la liste et cliquez sur le bouton Définir l'icône.... La boîte de dialogue de sélection standard des couleurs de &kde; apparaît, dans laquelle vous pouvez choisir une icône existante de la collection de &kde; ou en charger une personnalisée.

Pour revenir à l'icône standard, cliquez sur le bouton Apparence par défaut.

Pour changer la couleur du texte (&cad; de l'avant-plan) d'une catégorie, sélectionnez-la dans le liste et cliquez sur le bouton Définir la couleur du texte.... La boîte de dialogue de sélection standard des couleurs de &kde; apparaît, dans laquelle vous pouvez choisir une couleur existante ou en créer une nouvelle.

Le changement de couleur de l'arrière-plan s'effectue de la même manière. Cliquez simplement à la place sur Définir la couleur d'arrière-plan....

Pour changer la police, deux options vous sont offertes :

1. Modifier la police standard utilisée pour tous les affichages en liste dans &kde;.

2. Utiliser une police personnalisée.

La première option présente l'avantage que la police suivra le style que vous choisissez pour l'ensemble de &kde;, quel qu'il soit, alors que la seconde vous donne l'entier contrôle sur la police à employer. Ce choix vous appartient.

Pour utiliser la police standard modifiée, choisissez la catégorie dans la liste, puis cochez ou décochez les modificateurs de police Italique, Gras et/ou Barrée. Vous pouvez immédiatement voir l'effet sur la police dans la liste des catégories.

Pour utiliser une police personnalisée, cliquez sur le bouton Définir la police.... La boîte de dialogue standard de sélection des polices de &kde; apparaît, dans laquelle vous pouvez sélectionner la nouvelle police.

Notez que vous pouvez encore vous servir des modificateurs de polices pour changer la police personnalisée, simplement comme pour la modification de la police standard.

Pour revenir à la police standard, cliquez sur le bouton Apparence par défaut.

#### Configurer l'ordre des attributs DN

Bien que les &dn;s soient hiérachiques, l'ordre des composants individuels (appelés « &dn;s relatifs » (DNR) ou « attributs &dn; ») n'est pas défini. L'ordre dans lequel les attributs sont affichés est ainsi une affaire de goût personnel ou de politique d'entreprise, ce qui explique pourquoi il est configurable dans &kleopatra;.

Ce réglage ne s'applique pas seulement à &kleopatra;, mais à toutes les applications qui utilisent la technologie &kleopatra;. Au moment de la rédaction de ce document, sont concernés &kmail;, &kaddressbook;, ainsi que &kleopatra; lui-même naturellement.

Cette page de configuration se compose de deux listes : une pour les attributs connus (Attributs disponibles) et une décrivant l'Ordre actuel des attributs.

Les deux listes contiennent les éléments décrits en abrégé dans l'attribut (&pex; CN) ainsi que la forme en toutes lettres (Nom d'usage).

La liste Attributs disponibles est toujours triée par ordre alphabétique, alors que l'ordre de la liste Ordre actuel des attributs reflète l'ordre des attributs &dn; configurés : le premier attribut de la liste est aussi celui qui est affiché le premier.

Seuls les attributs explicitement répertoriés dans la liste Ordre actuel des attributs sont affichés entièrement. Le reste est masqué par défaut.

Cependant, si l'élément fictif _X_ (Tous les autres) est dans la liste « actuelle », tous les attributs non répertoriés (qu'ils soient connus ou non), sont insérés au niveau de _X_ dans leur ordre relatif d'origine.

Un petit exemple vous éclairera davantage :

Étant donné le &dn;

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

L'ordre attribué par défaut de CN, L, _X_, OU, O, C générera le &dn; formaté suivant :

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

alors que CN, L, OU, O, C générera

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

Pour ajouter un attribut à la liste d'ordre d'affichage, sélectionnez-le dans la liste Attributs disponibles et cliquez sur le bouton Ajouter à l'ordre actuel des attributs.

Pour supprimer un attribut de la liste d'ordre d'affichage, sélectionnez-le dans la liste Attributs disponibles et cliquez sur le bouton Supprimer de l'ordre actuel des attributs.

Pour déplacer un attribut au début (à la fin), sélectionnez-le dans la liste Ordre actuel des attributs et cliquez sur le bouton Déplacer vers le haut (Déplacer vers le bas).

Pour déplacer un attribut vers le haut (le bas) d'un niveau seulement, sélectionnez-le dans la liste Ordre actuel des attributs et cliquez sur le bouton Remonter (Redescendre).

### Configurer les opérations de chiffrement

#### Configurer les Opérations de courriel

Vous pouvez configurer ici certains points des opérations de courriel du serveur d'interfaces de &kleopatra;. Actuellement, vous pouvez seulement configurer si vous voulez utiliser le Mode rapide pour, respectivement, signer et chiffrer des courriels.

Quand le Mode rapide est activé, aucune boîte de dialogue n'est affichée lorsque vous signez (ou chiffrez) des courriels, à moins qu'il n'apparaisse un conflit nécessitant une intervention manuelle.

#### Configurer les Opérations de fichiers

Vous pouvez configurer ici certains aspects des opérations de fichiers du serveur d'interfaces de &kleopatra;. Vous pouvez actuellement choisir le programme de contrôle à utiliser pour `CHECKSUM_CREATE_FILES`.

Servez vous de Programme de somme de contrôle à utiliser pour choisir quel programme doit être utilisé lors de la création de fichier de somme de contrôle parmi les programmes configurés.

Lors de la vérification des sommes de contrôle, le programme à utiliser est automatiquement détecté, grâce aux noms des fichiers de contrôle trouvés.

L'administrateur et l'utilisateur doté de privilèges peuvent entièrement définir quels programmes rendre disponible pour &kleopatra; à travers les dénommées Définitions de la somme de contrôle dans le fichier de configuration. Voir dans pour plus de détails.

### Configurer des aspects de la validation S/MIME

Sur cette page, vous pouvez configurer certains aspects de la validation des certificats &smime;.

C'est simplement, en grande partie, une version plus conviviale des mêmes réglages que vous pouvez aussi trouver dans . Tout ce que vous pouvez configurer ici, vous pouvez également le faire là-bas, à l'exception de qui est spécifique à &kleopatra;.

La signification de chacune des options est la suivante :

#### Configurer la vérification périodique des certificats

Vérifie la validité des certificats toutes les N heures.

  Cette option active la vérification périodique de la validité des certificats. L'effet de la vérification périodique est le même que ; la programmation périodique de ou n'est pas prévu.

  La validation est effectuée implicitement à chaque fois que des fichiers significatifs sont modifiés dans `~/.gnupg`. Cette option, comme et , affecte donc seulement les facteurs externes de la validité des certificats.

#### Configurer la méthode de validation

Valider les certificats en utilisant des LRC

  Si cette option est sélectionnée, les certificats &smime; sont validés en utilisant les Listes de Révocations de Certificats (LRC).

  Voir pour obtenir des méthodes alternatives de vérification de validité de certificat.

Valider les certificats en ligne (OCSP)

  Si cette option est sélectionnée, les certificats &smime; sont validés en ligne en utilisant le protocole de vérification en ligne de certificat (Online Certificates Status Protocol, &ocsp;).

  Quand vous choisissez cette méthode, une requête est envoyée au serveur de l'&ca; plus ou moins à chaque fois que vous envoyez ou recevez un message chiffré, permettant théoriquement à l'agence de certification émettrice de localiser celui avec qui vous échangez des (&pex;) courriels.

  Pour utilisez cette méthode, vous aurez besoin de saisir l'&URL; du serveur &ocsp; dans .

  Voir pour obtenir une méthode plus traditionnelle de vérification de validité de certificat qui ne divulgue pas d'informations sur celui avec qui vous échangez des courriels.

URL du serveur OCSP

  Saisissez ici l'adresse du serveur pour la validation en ligne des certificats (du serveur &ocsp;). L'&URL; commence habituellement par `http://`.

Signature du serveur OCSP :

  Sélectionnez ici le certificat avec lequel le serveur &ocsp; signe ses réponses.

Ignorer l'URL de service des certificats

  Chaque certificat &smime; contient généralement l'&URL; de son serveur &ocsp; de l'émetteur ( révélera si un certificat donné en contient une).

  Cochez cette option fais ignorer ces &URL; par &gpgsm; et seulement prendre en compte celle configurée au-dessus.

  Utiliser cela pour, &pex;, imposer l'utilisation d'un serveur mandataire &ocsp; à travers toute une société.

#### Configurer les options de validation

Ne pas vérifier les règles de certificat

  Par défaut, &gpgsm; utilise le fichier `~/.gnupg/policies.txt` pour vérifier si une règle de certificat est permise. Si cette option est sélectionnée, les règles ne sont pas vérifiées.

Ne jamais consulter une LRC

  Si cette option est activée, les listes de révocation de certificats ne sont jamais utilisées pour valider les certificats &smime;.

Autoriser le marquage de confiance des certificats racines

  Si cette option est activée lorsque le certificat &ca; racine est importé, il vous sera demandé de confirmer son empreinte numérique et si vous considérez ou non sa signature comme de confiance.

  Un certificat racine a besoin d'être de confiance avant de pouvoir considérer les certificats qui en proviennent comme de confiance également. Mais avoir confiance en des certificats racines trop facilement peut abaisser la sécurité générale du système.

  Activer cette fonctionnalité dans le moteur peut vous amenez à être dérangé par des menus contextuels de &pinentry; à des moments inopportuns (&cad; à la vérification des signatures), et peut ainsi bloquer le traitement des courriels laissé sans surveillance. Pour cette raison, et parce qu'il est souhaitable d'être en mesure de ne plus faire confiance à un certificat racine de confiance à nouveau, &kleopatra; permet le réglage manuel du niveau de confiance en utilisant et .

  Les réglages ici n'influencent pas la fonction de &kleopatra;.

Recevoir les certificats sans émetteur

  Si cette option est activée, les certificats sans émetteur sont reçus lorsque nécessaire (cela s'applique aux deux méthodes de validation, par LRC et par OCSP).

#### Configurer les options des requêtes &http;

N'effectuer aucune requête HTTP

  Désactiver totalement l'utilisation de &http; pour &smime;.

Ignorer le point de distribution de LRC HTTP des certificats

  Lorsque l'emplacement d'une LRC est recherché, le certificat à tester contient généralement des entrées connues comme le point de distribution de LRC (DP, &crl; Distribution Point) qui sont des &URL;s décrivant le moyen d'accéder aux LRC. La première entrée DP trouvée est utilisée.

  Avec cette option, toutes les entrées utilisant le protocole &http; sont ignorées lors de la recherche d'un DP adéquat.

Utiliser le serveur mandataire HTTP du système

  Si cette option est sélectionnée, le serveur mandataire &http; affiché à droite (qui correspond à la variable d'environnement `http_proxy`) sera utilisé pour toute requête &http;.

Utiliser ce serveur mandataire pour les requêtes HTTP

  Si aucun système de serveur mandataire n'est défini, ou si vous avez besoin d'utiliser un serveur mandataire différent pour &gpgsm;, veuillez saisir son emplacement ici.

  Il sera utilisé pour toutes les requêtes HTTP relatives à S/MIME.

  La syntaxe est `machine`:`port`, &cad; `monproxy.quelquepart.com:3128`.

#### Configurer les options des requêtes &ldap;

N'effectuer aucune requête LDAP

  Désactive totalement l'utilisation de &ldap; pour &smime;.

Ignorer le point de distribution des LRC LDAP des certificats

  Lorsque l'emplacement d'une LRC est recherché, le certificat à tester contient généralement des entrées connues comme « point de distribution de LRC » (DP) qui sont des &URL;s décrivant un moyen d'accès. La première entrée DP trouvée est utilisée.

  Avec cette option, toutes les entrées utilisant le protocole &ldap; sont ignorées lors de la recherche d'un DP adéquat.

Hôte primaire pour les requêtes LDAP

  Indiquer un serveur &ldap; ici fera passer toutes les requêtes &ldap; d'abord par ce serveur. Plus précisément, ce réglage prend le pas sur tout hôte et port spécifié dans une &URL; &ldap; et sera également utilisé si l'hôte et le port ont été omis dans l'&URL;.

  Les autres serveurs &ldap; seront utilisés uniquement si la connexion au serveur mandataire échoue. La syntaxe est `hôte` ou `hôte`:`port`. Si port est omis le port 389 (port standard &ldap;) sera utilisé.

### Configurer le système GnuPG

Cette partie de la boîte de dialogue est générée automatiquement depuis la sortie de `gpgconf `--list-components`` et, pour chaque composant que la commande ci-dessus retourne, la sortie de `gpgconf `--list-options` composant`.

La plus utile de ces options a été dupliqué en pages séparées dans la boîte de dialogue de configuration de &kleopatra;. Reportez vous à et pour les deux pages qui contiennent des options sélectionnées depuis cette section de la boîte de dialogue.

Le contenu exact de cette section de la boîte de dialogue dépend de la version du moteur &gnupg; que vous avez installé et, potentiellement, de la plate-forme sur laquelle vous tournez. Ainsi, allons nous discuter seulement la présentation générale de la boîte de dialogue, notamment les correspondances permettant de passer des options de &gpgconf; aux actions du &GUI; de &kleopatra;.

&gpgconf; retourne des informations de configuration pour plusieurs composants. À l'intérieur de chaque composant, les options individuelles sont réunies en groupes.

&kleopatra; affiche un onglet par composant rapporté par &gpgconf;; les groupes sont intitulés par une ligne horizontale affichant le nom du groupe comme retourné par &gpgconf;.

Chaque option de &gpgconf; a un type. Excepté pour certaines options bien connues que &kleopatra; accompagne avec des réglages spécialisés pour une meilleure expérience utilisateur, les correspondances permettant de passer des types &gpgconf; aux actions du &GUI; de &kleopatra; sont comme suivant :

#### Correspondance entre les options de &gpgconf; et les actions du &GUI; de &kleopatra;

type &gpgconf; | Action de &kleopatra;
--- | ---
pour les listes | pour les non-listes
`aucun` | Compteur | Case à cocher
`chaîne` | &NA; | édition de ligne
`int32` | édition de ligne (non formatée) | Compteur
`uint32`
`nom de l'emplacement` | &NA; | action spécialisée
`serveur ldap` | action spécialisée | &NA;
`empreinte clé` | &NA;
`clé publique`
`clé secrète`
`liste des alias`

Voir le manuel de &gpgconf; pour des informations supplémentaires sur ce que vous pouvez configurer ici et comment.

## Guide de l'Administrateur

Le Guide l'Administrateur décrit les différents moyens permettant de personnaliser &kleopatra; qui ne sont pas accessibles par l'intermédiaire de l'interface graphique utilisateur, mais uniquement au travers des fichiers de configuration.

Il part du principe que le lecteur connaît déjà la technologie utilisée pour la configuration des applications &kde;, y compris la structure, l'emplacement du système de fichiers et l'implantation en cascade des fichiers de configuration de &kde;, sans oublier l'infrastructure KIOSK.

### Personnalisation de l'assistant de création des certificats

#### Personnaliser les champs du ND

&kleopatra; vous permet de personnaliser les champs que l'utilisateur pourra renseigner afin de créer des certificats.

Créez un groupe appelé `CertificateCreationWizard` dans le fichier `kleopatrarc` pour tout le système. Si vous souhaitez avoir un ordre personnalisé des attributs ou ne voir apparaître que certains éléments, créez une clé appelée `DNAttributeOrder`. Le ou les arguments sont à choisir parmi `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL`. Pour initialiser des champs avec une valeur donnée, écrivez quelque chose comme « Attribut=valeur ». Pour que l'attribut soit considéré comme un attribut requis, ajoutez-y à la fin un point d'exclamation (&pex;, `CN!,L,OU,O!,C!,EMAIL!`, ce qui s'avère justement être la configuration par défaut).

L'utilisation du modificateur de mode KIOSK `$e` vous permet d'extraire les valeurs issues des variables d'environnement, d'un script ou d'un binaire évalué. Pour en plus désactiver l'édition du champ respectif, faites appel au modificateur `$i`. Pour interdire l'utilisation du bouton Insérer mon adresse, réglez `ShowSetWhoAmI` à « false ».

En raison de la nature de l'infrastructure KIOSK de &kde;, l'emploi du drapeau immuable (`$i`) interdit à l'utilisateur de ne pas tenir compte du drapeau. C'est un comportement intentionnel. `$i` et `$e` peuvent aussi bien être utilisés avec toutes les autres clés de configuration dans les applications &kde;.

L'exemple suivant donne un aperçu des personnalisations possibles :

    [CertificateCreationWizard]
    ;Interdire de copier des données personnelles provenant du carnet d'adresses, ne pas autoriser la prise de contrôle locale
    ShowSetWhoAmI[$i]=false

    ;définit le nom de l'utilisateur à $UTILISATEUR
    CN[$e]=$UTILISATEUR

    ;définit le nom de l'entreprise à "Mon Entreprise", interdit l'édition
    O[$i]=Mon Entreprise

    ;définit le nom du département à une valeur retournée par un script
    OU[$ei]=$(lookup_dept_from_ip)

    ; définit le pays à FR, mais autorise des changements par l'utilisateur
    C=FR

#### Restreindre les types de clés qu'un utilisateur est autorisé à créer

&kleopatra; permet aussi de restreindre les types de certificats qu'un utilisateur est autorisé à créer. Notez tout de même qu'un moyen facile de contourner ces restrictions est de simplement en créer un à l'aide de la ligne de commande.

##### Algorithme à clés publiques

Pour contrôler l'algorithme à clés publiques à utiliser, ajoutez la clé de configuration `PGPKeyType` (et `CMSKeyType`, mais seulement RSA est géré pour CMS de toute façon) à la section `CertificateCreationWizard` de `kleopatrarc`.

Les valeurs autorisées sont`RSA` pour des clés RSA, `DAS` pour les clés (pour signer uniquement) DSA, et `DSA+ELG` pour une clé (pour signer uniquement) DSA avec une sous-clé Elgamal pour le chiffrement.

La configuration par défaut est lu depuis &gpgconf; ou sinon depuis `RSA`, si &gpgconf; n'en fournit pas.

##### Taille des Clés Publiques

Pour restreindre les tailles de clés disponibles pour un algorithme publique, ajouter la clé de configuration `<ALG>KeySizes` (où ALG peut être `RSA`, `DSA` ou `ELG`) par la `CertificateCreationWizard` section de `kleopatrarc`, contenant une liste de taille de clé (en bits) séparées par des virgules. Une taille de clé par défaut peut être indiquée en la faisant précéder par un trait d'union (`-`).

    RSAKeySizes = 1536,-2048,3072

L'exemple ci-dessus restreindra les tailles de clé RSA autorisées à 1536, 2048 et 3072, avec 2048 par défaut.

En plus des tailles elles-même, vous pouvez aussi spécifier une étiquette pour chacune des tailles. Il suffit de fixer la configuration de clé `ALG KeySizeLabels` à une liste d'étiquettes séparées par des virgules.

    RSAKeySizeLabels = faible,normal,fort

Celui de dessus, en liaison avec l'exemple précédent, écrirait quelque chose comme les options suivantes pour la sélection :

    faible (1536 bits)
                  normal (2048 bits)
                  fort (3072 bits)

Ceux par défaut sont comme si le suivant avait effet :

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

### Créer et éditer des catégories de clés

&kleopatra; permet à l'utilisateur de configurer l'apparence visuelle des clés en se basant sur un concept appelé Catégories de clés. Les Catégories de clés sont aussi utilisées pour filtrer la liste des certificats. Cette section décrit de quelle manière il est possible d'éditer les catégories disponibles et d'en ajouter de nouvelles.

Lorsqu'on essaie de trouver la catégorie à laquelle une clé appartient, &kleopatra; tente de faire correspondre une clé à une séquence de filtres de clés, configurée dans le fichier `libkleopatrarc`. Le premier à correspondre définit la catégorie, en s'appuyant sur un concept de spécificité, expliqué plus loin.

Chaque filtre de clés est défini dans un groupe de configuration nommé `Key FIlter #n`, où n est un nombre à partir de `0`.

Les seules clés obligatoires dans un groupe `Key Filter #n` sont `Name`, qui contient le nom de la catégorie tel qu'il est affiché dans la boîte de dialogue de configuration, et `id`, qui est utilisé comme référence pour le filtre dans d'autres sections de configuration (comme `View #n`).

répertorie toutes les clés qui définissent les propriétés d'affichage des clés appartenant à cette catégorie (&cad; les clés qui peuvent être ajustées dans la boîte de dialogue de configuration), alors que dresse la liste de toutes les clés qui définissent les critères par rapport auxquels le filtre correspond aux clés.

#### Clés de configuration des filtres de clés définissant les propriétés d'affichage

Clé de configuration | Type | Description
--- | --- | ---
`couleur d'arrière-plan` | couleur | La couleur d'arrière-plan à utiliser. Si elle est absente, sera par défaut celle définie globalement pour les affichages en liste.
`couleur d'avant-plan` | couleur | La couleur d'avant-plan à utiliser. Si elle est absente, sera par défaut celle définie globalement pour les affichages en liste.
`police` | police | La police par défaut à utiliser. La police sera mise à l'échelle de façon à correspondre à la taille configurée pour les affichages en liste, et tout attribut de police (voir ci-dessous) sera appliqué.
`font-bold` | booléen | Si défini à `true` et si `font` n'est pas défini, utilise la police par défaut de l'affichage en liste avec ajout du style de police Gras (si disponible). Ignoré si `font` est également présent.
`font-italic` | booléen | Analogue à `font-bold`, mais pour les polices de type italique au lieu de gras.
`font-strikeout` | booléen | Si `true`, trace une ligne au centre de la police. Appliqué même si `font` est défini.
`icon` | texte | Le nom d'une icône à afficher dans la première colonne. N'est pas encore mis en œuvre.

#### Clés de configuration des filtres de clés définissant les critères du filtre

Clé de configuration | Type | Si spécifié, le filtre correspond quand...
--- | --- | ---
`is-revoked` | booléen | la clé a été révoquée.
`match-context` | contexte Le contexte est un listage des valeurs autorisées suivantes : `appearance`, `filtering` et `any`. | le contexte auquel le filtre correspond.
`is-expired` | booléen | la clé a expiré.
`is-disabled` | booléen | la clé a été désactivée (marquée afin de ne pas être utilisée) par l'utilisateur. Ignoré pour les clés &smime;.
`is-root-certificate` | booléen | la clé est un certificat racine. Ignoré pour les clés OpenPGP.
`can-encrypt` | booléen | la clé peut servir pour le chiffrement.
`can-sign` | booléen | la clé peut servir pour signer.
`can-certify` | booléen | la clé peut servir pour signer (certifier) d'autres clés.
`can-authenticate` | booléen | la clé peut servir pour l'authentification (&pex; comme certificat de client TLS).
`is-qualified` | booléen | la clé peut être utilisée pour faire des Signatures Qualifiées (comme définie par la loi allemande sur la signature numérique).
`is-cardkey` | booléen | le matériel clé est stockée sur une carte à puce (et non sur l'ordinateur).
`has-secret-key` | booléen | la clé secrète de cette paire de clés est disponible.
`is-openpgp-key` | booléen | la clé est une clé OpenPGP (`true`) ou une clé &smime; (`false`).
`was-validated` | booléen | la clé a été validée.

`prefix-ownertrust`

validité La validité est un listage (ordonnée) des valeurs autorisées suivantes : `unknown`, `undefined`, `never`, `marginal`, `full`, `ultimate`. Reportez-vous aux manuels de &gpg; et &gpgsm; pour une explication détaillée.

la clé a exactement (prefix = `is`), n'a rien sauf (prefix = `is-not`), a au moins (prefix = `is-at-least`) ou a au plus (prefix = `is-at-most`) la confiance du propriétaire en question comme valeur pour la clé de configuration. Si plusieurs clés `prefix-ownertrust` (avec des valeurs prefix différentes) sont présentes dans un seul groupe, le comportement est indéfini.

`prefix-validity` | validité | Analogue à `prefix-ownertrust`, mais pour la validité des clés au lieu de la confiance du propriétaire.

Quelques-uns des critères les plus intéressants, comme `is-revoked` ou `is-expired` ne fonctionneront que sur des clés validées, ce qui explique pourquoi par défaut, la révocation et l'expiration n'est vérifiée que pour les clés validées, bien que vous soyez libre de supprimer ces contrôles supplémentaires.

En plus de la liste des clés configurées ci-dessous, un filtre de clés peut aussi avoir un `id` et un `match-contexts`.

En utilisant l'`id` du filtre, qui est par défaut le nom du groupe de configuration du filtre s'il n'est pas donné ou vide, vous pouvez indiquer le filtre de clés autre part dans la configuration, &pex; dans l'affichage de la configuration de &kleopatra;. L'`id` n'est pas interprété par &kleopatra;, vous pouvez donc utiliser n'importe quelle chaîne, tant quelle reste unique.

`match-contexts` limite la pertinence du filtre. Deux contexte sont actuellement définis : le contexte d'`appearance` est utilisé lors de la définition des couleurs et des propriétés de la police pour la vue. Le contexte `filtering` est utilisé pour inclure (et exclure) sélectivement des certificats de la vue. `any` peuvent être utilisé pour désigner tous les contextes définis actuellement, et c'est celui par défaut si `match-contexts` n'est pas donné, ou sinon ne produit aucun contexte. Cela assure qu'aucun filtre de clés ne se retrouve mort, &cad; avec aucun contexte à lui appliquer.

Le format de l'entrée est une liste d'identificateurs, séparés par des caractères qui ne sont pas des mots. Chacun de ces identificateurs peut être précédé par un point d'exclamation (`!`), indiquant la négation. Les identificateurs agissent dans l'ordre sur une liste externe de contextes, qui débute vide. Le mieux est de l'expliquer par un exemple : `tous !appearance` est le même que `filtering`, et `appearance !appearance` produit un groupe vide, comme l'est `!any`. Cependant, les deux derniers seront remplacés en interne par `any`, car ils ne produisent aucun contexte du tout.

En général, les critères non spécifiés (&cad; dont l'élément de configuration n'est pas défini) ne sont pas vérifiés. Si un critère est indiqué, il est déceler et doit correspondre au filtre comme un ensemble pour convenir, &cad; que les critères sont « combinés en ET » (AND'ed together).

Chaque filtre a une spécificité tacite qui est utilisée pour classer tous les filtres correspondants. Le filtre le plus spécifique l'emporte sur les filtres les moins spécifiques. Si deux filtres ont la même spécificité, celui qui vient en premier dans le fichier de configuration l'emporte. La spécificité du filtre est proportionnelle au nombre de critère qu'il contient.

#### Exemples de filtres de clés

Pour vérifier tous les certificats racines arrivés à expiration mais non révoqués, vous devriez utiliser un filtre de clés défini comme suit :

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

Pour vérifier toutes les clés OpenPGP désactivées (&kleopatra; ne le gère pas encore) ayant au moins la confiance « minimale » du propriétaire, vous devriezutilisez :

    [Key Filter #n]
    Name=clés OpenPGP désactivées ayant la confiance minimale ou d'un niveau plus élevé du propriétaire
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

### Configurer les gestionnaires d'archives pour être utilisés avec les fichiers signés/chiffrés.

&kleopatra; permet à l'administrateur (et à l'utilisateur doté de privilèges) de configurer la liste des gestionnaires d'archives qui sont présentés dans la boîte de dialogue Signer/chiffrer des fichiers.

Chaque gestionnaire d'archives est définit dans `libkleopatrarc` comme un groupe d'`Archive Definition #n` séparé, avec les clés obligatoires suivantes :

`extensions`

  Une liste d'extensions de nom de fichiers séparés par des virgules qui indique généralement ce format d'archive.

`id`

  Un identifiant unique pour identifier ce gestionnaire d'archives en interne. Si vous n'êtes pas sûr, utilisez le nom de la commande.

`Name` (traduit)

  Le nom d'utilisateur visible de ce gestionnaire d'archives, comme affiché dans le menu déroulant de la boîte de dialogue Signer/Chiffrer des fichiers.

`pack-command`

  La commande actuelle pour archiver des fichiers. Vous pouvez utiliser n'importe quelle commande, tant qu'aucun shell n'est requis pour l'exécuter. Le fichier du programme est recherché en utilisant la variable d'environnement `PATH`, à moins que vous n'utilisiez un emplacement de fichier absolu. La citation est prise en charge comme si un shell était utilisé :

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

Depuis que l'antislash (`\`) est un caractère d'espace dans les fichiers de configuration de KDE, vous devez les doubler quand ils apparaissent dans les noms d'emplacement :

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

. Toutefois, pour la commande en elle-même (en opposition à ses arguments), vous pourriez peut-être utilisez simplement des slashes (`/`) comme séparateur d'emplacement sur toutes les plate-formes :

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

. Ceci n'est pas géré dans les arguments comme la plupart des programmes Windows utilise le slash pour les options. Par exemple, la commande suivante ne fonctionnera pas, comme `C:/myarchivescript.bat` est un argument de `cmd.exe` et `/` n'est pas convertit en `\` en argument, seul s'exécute :

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

. Celle-ci doit plutôt être écrite comme ci :

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

#### Nom de fichier d'entrée passé pour `pack-command`

Il y a trois façons de passer des nom de fichiers à la commande de compression. Pour chacune d'elles, `pack-command` prévoie une syntaxe particulière :

1. Comme argument de la ligne de commande.

   Exemple (tar) :

       pack-command=tar cf -

   Exemple (zip) :

       pack-command=zip -r - %f

   Dans ce cas, les noms de fichier sont passés dans la ligne de commande, comme ce que vous feriez en utilisant l'invite de commande. &kleopatra; n'utilise pas un shell pour exécuter la commande. En conséquence, c'est un moyen sûr de passer des noms de fichier, mais il pourrait survenir des restrictions au sujet de la longueur de la ligne de commande sur certaines plate-formes. Un textuel `%f`, si présent, est remplacé par le noms des fichiers à archiver. Sinon, les noms de fichiers sont ajoutés à la ligne de commande. Ainsi, l'exemple zip ci-dessus pourrait aussi s'écrire comme ceci :

       pack-command=zip -r -

2. Via l'entrée standard, séparé par des sauts de ligne : prepend `|`.

   Exemple (GNU-tar) :

       pack-command=|gtar cf - -T-

   Exemple (ZIP) :

       pack-command=|zip -@ -

   Dans ce cas, les noms de fichiers sont passés au gestionnaire d'archives sur stdin, un par ligne. Ceci évite les problèmes sur les plates-formes qui mettent une limite basse au nombre d'arguments des lignes de commande autorisés mais échoue quand les noms de fichiers contiennent des retours à la ligne.

   &kleopatra; gère actuellement seulement LF comme séparateur de saut de ligne, et non CRLF. Cela pourrait changer dans de futures versions, en s'appuyant sur les retours utilisateurs.

3. Via l'entrée standard, séparé par des octets NUL : prepend `0|`.

   Exemple (GNU-tar) :

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

   Celui-ci est le même qu'au dessus, excepté que les octets NUL sont utilisés pour séparer les noms de fichier. Depuis que les octets NUL sont interdits dans les noms de fichier, c'est la façon la plus robuste pour passer des noms de fichier, mais tous les gestionnaires d'archives ne le gère pas.

### Configurer les programmes de sommes de contrôle pour être utilisés avec Créer/Vérifier des sommes de contrôle

&kleopatra; permet à l'administrateur (et à l'utilisateur doté de privilèges) de configurer la liste des programmes de sommes de contrôle que l'utilisateur peut choisir depuis la boîte de dialogue et que &kleopatra; est capable d'auto-détecter quand demandé pour vérifier une somme de contrôle d'un fichier donné.

Pour être utilisable par &kleopatra;, la sortie du programme de contrôle (à la fois les fichiers de sommes de contrôle écrits ainsi que la sortie sur stdout quand la vérification s'effectue) doit être compatible avec GNU `md5sum` et `sha1sum`.

En particulier, le fichier de somme de contrôle doit être fondé sur des lignes, chaque ligne ayant le format suivant :

    SOMME_DE_CONTRÔLE ' ' ( ' ' | '*' ) NOM_DE_FICHIER

où SOMME_DE_CONTRÔLE est constitué seulement de caractères hexadécimaux. Si NOM_DE _FICHIER contient un caractère de saut de ligne, la ligne doit plutôt être lue

    \SOMME_DE_CONTRÔLE ' ' ( ' ' | '*' ) NOM_DE_FICHIER_DE _SECOURS

où NOM_DE_FICHIER_DE_SECOURS est le nom de fichier avec les sauts de ligne remplacés par des `\n`s, et des antislashes doubles (`\`↦`\\`).

De même, la sortie de doit être de la forme

    NOM_DE_FICHIER ( ': OK' | ': FAILED' )

séparés par des sauts de ligne. Les sauts de ligne et autres caractères ne sont pas soustrais de la sortie. Effectivement, ces programmes n'ont pas été écrit avec des interfaces graphiques à l'esprit, et &kleopatra; ne parviendra pas à analyser correctement les noms de fichiers pathologiques qui contiennent de multiples « : Ok » et sauts de ligne.

Chaque programme de contrôle est définie dans `libkleopatrarc` comme un groupe `Checksum Definition #n` distinct, avec les clés obligatoires suivantes :

`file-patterns`

  Une liste d'expressions rationnelles qui décrivent les fichiers qui doivent être considérés comme fichiers de contrôle pour ce programme de contrôle. La syntaxe est celle utilisée pour les listes de chaînes dans les fichiers de configuration de KDE.

  Comme les expressions rationnelles contiennent généralement des antislashes, prenez soin de bien les éliminer du fichier de configuration. L'utilisation d'un outil d'édition de fichier de configuration est recommandée.

  La plate-forme définit si les motifs sont traités sensibles ou insensibles à la casse.
`output-file`

  Le nom du fichier de sortie caractéristique de ce programme de somme de contrôle (doit, évidemment, correspondre à un des ). C'est celui que &kleopatra; utilisera comme nom de fichier de sortie quand il créera des fichiers de somme de contrôle de ce type.

`id`

  Un identifiant unique utilisé pour identifier ce programme de somme de contrôle en interne. Si vous n'êtes pas sûr, utilisez le nom de la commande.

`Name` (traduit)

  Le nom du programme de somme de contrôle visible par l'utilisateur, comme affiché dans le menu déroulant de la boîte de configuration de &kleopatra;.

`create-command`

  La commande actuelle avec laquelle créer des fichiers de sommes de contrôle. La syntaxe, les restrictions et les options de passage des arguments sont les mêmes que décrits pour dans .

`verify-command`

  Pareil que , mais pour la vérification de sommes de contrôle.

Voici un exemple complet :

    [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

## Remerciements et licence

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

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

### Contributeurs

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

Traduction française par &JoelleCornavin; et &RobinGuitton;.

&underFDL; &underGPL;

&documentation.index;