# El manual de &kleopatra;

## Introducción

&kleopatra; es la herramienta de &kde; para gestionar certificados &x509; y &openpgp; en los almacenes de claves &gpgsm; y &gpg; y para recuperar certificados desde &ldap; y otros servidores de certificados.

&kleopatra; se puede iniciar desde el menú Herramientas Gestor de certificados de &kmail;, así como desde la línea de órdenes. El ejecutable de &kleopatra;se llama ``kleopatra``.

Este programa se llama como Cleopatra, una famosa faraona egipcia contemporánea de Julio César, con quien se dice que tuvo un hijo, Cesarión, no reconocido como suyo.

El nombre se eligió porque el programa se originó en el proyecto Ägypten (Ägypten es Egipto en alemán). &kleopatra; es la ortografía alemana para Cleopatra.

## Funciones principales

### Ver la caja de claves local

La función principal de &kleopatra; es mostrar y editar el contenido de la caja de claves local, que es similar al concepto de los anillos de claves de &gpg;, aunque no se ajuste demasiado a esta analogía.

La ventana principal está dividida en la gran área de listado de claves, que consta de varias pestañas, la barra de menús y la barra de búsqueda arriba y la barra de estado abajo.

Cada línea de la lista de claves corresponde a un certificado, que se identifica por el llamado Asunto &dn;. &dn; es el acrónimo de Distinguished Name (n.t. Nombre distintivo), algo como una ruta al sistema de archivos con una sintaxis poco usual. Se supone que es un identificador global único que identifica al certificado.

Para que sea válido y, por tanto, útil, las claves (públicas) tienen que estar firmadas por una &ca; (Certification Authority - n.t. Autoridad certificadora). Estas firmas se llaman certificados, pero normalmente los términos certificado y clave (pública) se usan indistintamente y no haremos distinciones entre ellos en este manual, salvo cuando se indique de forma explícita.

Las &ca;pueden tener que estar firmadas por otras &ca; para ser válidas. Por supuesto, debe existir un límite, por lo que la &ca; de nivel superior (&ca; raíz) firma su clave con ella misma (a esto se le llama firmar a sí mismo). A los certificados raíz, por tanto, se les tiene que asignar manualmente una validez (llamada frecuentemente confianza), ⪚ después de comparar la huella dactilar con la del sitio web de la &ca;. Normalmente, suele hacerlo el administrador del sistema o el vendedor de un producto que use certificados, pero cualquier usuario puede hacerlo también con la interfaz de línea de órdenes de &gpgsm;.

Para ver cuáles de los certificados son certificados raíces, puede cambiar al modo jerárquico de lista de claves con view-hierarchical-key-list.

Usted puede ver los detalles de cualquier certificado haciendo doble clic o usando view-certificate-details. Se abrirá un diálogo que mostrará las propiedades más frecuentes del certificado, su cadena de certificado (&ie;, la cadena del emisor hasta la &ca; raíz) y un volcado de toda la información que el motor puede extraer del certificado.

Si usted cambia el almacén de certificados sin usar &kleopatra; (⪚ usando la interfaz de línea de órdenes de &gpgsm;), usted puede refrescar la vista con view-redisplay.

### Buscar e importar certificados

La mayoría de las veces, adquirirá los certificados nuevos al verificar las firmas de los correos electrónicos, porque los certificados están empotrados en las firmas que se hacen al usarlos. Sin embargo, si necesita enviar un correo a alguien con el que no se haya puesto en contacto todavía, tendrá que obtener el certificado de una carpeta &ldap;(aunque &gpgsm; puede hacerlo automáticamente), o desde un archivo. También tendrá que importar su propio certificado tras recibir la respuesta de la &ca; a su petición de certificación.

Para buscar un certificado en un directorio &ldap;, seleccione Archivo Buscar certificados en el servidor e introduzca algún texto (⪚ el nombre de la persona para la que quiere el certificado) en la línea de edición del diálogoBúsqueda de certificado en servidor de claves, a continuación pulse sobre el botón Buscar. Los resultados se mostrarán en una lista de claves bajo la barra de búsquedas, donde usted puede seleccionar certificados para observarlos pulsando el botón Detalles o descargarlos en las claves locales con Importar.

Usted puede configurar la lista de servidores &ldap; para las búsquedas en la página Servicios de directorio del diálogo de configuración de &kleopatra;.

Si usted recibió el certificado como un archivo, pruebefile-import-certificates. &gpgsm; necesita entender el formato del archivo de certificado. Por favor, consulte el manual de &gpgsm; para acceder a una lista de los formatos de archivo admitidos.

Si usted no creó su par de claves con &gpgsm;, también tendrá que importar manualmente tanto la clave pública (así como la clave secreta) desde el archivo PKCS#12 que obtuvo de la &ca;. Usted puede hacerlo desde la línea de órdenes con ``kleopatra `--import-certificate` `nombre-de-archivo``` o desde dentro de &kleopatra; con file-import-certificates, justo como usted haría para certificados normales.

### Crear un nuevo par de claves

La opción de menú file-new-key-pair inicia el Asistente de creación de pares de claves, que le guiará a través de unos sencillos pasos para crear una solicitud de certificado.

Cuando haya terminado un paso del asistente, pulse Adelante para ir al siguiente paso (o Atrás para revisar los pasos que ya ha completado). La creación de solicitud de certificado se puede cancelar en cualquier momento pulsando el botón Cancelar.

En la primera página del asistente elija que tipo de certificado quiere usted crear:

Crear un par de claves personales OpenPGP

- Los pares de claves &openpgp; se crean localmente y se certifican por sus amigos y conocidos. No hay una autoridad central de certificación, en su lugar, cada individuo crea una red de confianza certificando otros pares de claves de usuario con su propio certificado.

  Usted tiene que introducir un Nombre, Correo y opcionalmente Comentario.

Crear un par de claves personales X.509 y una solicitud de certificación

- Los pares de claves &x509; se crean localmente, pero se certifican centralizadamente por una autoridad de certificación (&ca;). Unas &ca; pueden certificar otras &ca;, creando una cadena de confianza central y jerárquica.

  El siguiente paso del asistente es teclear sus datos personales para el certificado. Los campos que tiene que rellenar son:

  - Nombre (CN): Su nombre;

  - Dirección de correo (EMAIL) Su dirección de correo electrónico. Asegúrese de teclearla correctamente—esta será la dirección a la que la gente le enviará el correo cuando use su certificado.

  - Ubicación (L): El pueblo o ciudad donde usted vive;

  - Unidad organizativa (OU): La unidad organizativa en la que usted está (por ejemplo, «Logística»);

  - Organización (O): La organización que representa (por ejemplo, la empresa en la que usted trabaja);

  - Código del país (C): El código de dos letras del país en el que está viviendo (por ejemplo, «ES»);

  El siguiente paso en el asistente es seleccionar si almacenar el certificado en un archivo o enviarlo directamente a la &ca;. Tendrá que indicar el nombre del archivo o la dirección de correo electrónico a la que va a enviar la petición del certificado.

#### Revocación de una clave

Un par de claves que ha expirado puede regresar a un estado operativo tan pronto usted disponga de acceso a la clave privada y la frase de contraseña. Para inutilizar fiablemente una clave usted necesita revocarla. La revocación se hace añadiendo una firma especial de revocación a la clave.

La firma de revocación se almacena en un archivo separado. Este archivo puede importarse posteriormente en el anillo de claves y a continuación se adjunta a la clave inutilizándola. Por favor, tenga en cuenta que para importar esa firma a la clave, no se necesita contraseña. Más aun, usted debería guardar esta firma en un lugar seguro, generalmente uno diferente de donde esté su par de claves. Es un buen consejo usar un lugar que esté desconectado de su equipo, bien copiándolo a un dispositivo de almacenamiento externo como una llave USB o imprimiéndolo.

&kleopatra; no proporciona una función para crear una firma de revocación en cualquier momento, pero usted puede hacerlo con la aplicación &kde; &kgpg;, eligiendo Claves Revocar clave y opcionalmente importando su firma de revocación en su anillo de claves inmediatamente.

Un modo alternativo de generar una revocación de certificado es usar &gpg; directamente desde la línea de órdenes: `gpg --output `revocation_certificate`.asc --gen-revoke `your_key``. El argumento `your_key` debe ser un especificador de clave, bien el ID de clave de su par de claves primario o cualquier parte de su ID de usuario que identifique su par de claves.

## Referencia de menús

### Menú archivo

&Ctrl;N Archivo Nuevo certificado…

- Crea un nuevo par de claves (pública y privada) y le permite enviar la parte pública a una autoridad certificadora (&ca;) para que la firme. El certificado resultante se lo deben devolver o almacenarlo en un servidor &ldap; para que lo descargue en su caja de claves local, para que pueda usarlo para firmar y descifrar correos.

  Este modo de operación se llama generación descentralizada de claves, porque todas las claves se crean localmente. &kleopatra; (y &gpgsm;) no admite directamente la generación centralizada de claves, pero usted puede importar recopilaciones de claves públicas/secretas que reciba de la &ca; en formato PKCS#12 vía file-import-certificates.

&Ctrl;&Shift;I File Consultar certificados en el servidor…

- Busca e importa certificados desde servidores de certificados, en al almacén local de certificados. Consulte functions-search para más detalles.

  Usted necesita disponer de servidores de claves para esta tarea. Consulte configuration-directory-services para más detalles.

&Ctrl;I Archivo Importar certificados…

- Importa certificados o claves secretas desde archivos en el almacén de claves local. Consulte functions-search para más detalles.

  El formato del archivo de certificado debe ser admitido por &gpgsm;/&gpg;. Por favor, consulte los manuales de &gpgsm; y &gpg; para tener acceso a una lista de los formatos admitidos.

&Ctrl;E Archivo Exportar certificados…

- Exporta los certificados seleccionados a un archivo.

  La extensión de nombre de archivo que usted elija para la exportación del nombre de archivo determina el formato del archivo exportado:

  - Para certificados &openpgp;, `gpg` y `pgp` generarán un archivo binario, mientras que `asc` generarán un archivo &ascii;blindado.

  - Para certificados &smime;, `der` generarán una archivo binario codificado &der;, mientras que `pem` generarán un archivo &ascii; blindado.

  Salvo que se hayan seleccionado varios certificados, &kleopatra; propondrá ``huella dactilar`.{asc,pem}` como el nombre de archivo a exportar.

  Esta función solo está disponible cuando se han seleccionado uno o más certificados.

  Esta función solo exporta las claves públicas, incluso si la clave secreta esté disponible. Use file-export-secret-key para exportar tanto las claves públicas como las privadas en un archivo.

Archivo Exportar clave secreta…

- Exporta la clave secreta a un archivo.

  En el diálogo que se abre, usted puede elegir si crear un archivo de exportación binario o &ascii; blindado (ASCII blindado). A continuación, pulse sobre el icono de carpeta a la mano derecha del área de texto Archivo de salida y seleccione la carpeta y el nombre del archivo exportado. Cuando exporte claves secretas &smime;, usted puede elegir también el Juego de caracteres de la frase secreta. Vea el debate sobre la opción `--p12-charset `juego de caracteres`` en el manual de &gpgsm; para más detalles.

  Esta función solo está disponible cuando se ha seleccionado exactamente un certificado y la clave secreta para ese certificado está disponible.

  Raramente debiera ser necesario usar esta función y, si lo fuera, debiera planificarse con cuidado. Planificar la migración de una clave secreta implica la elección del medio de transporte y la eliminación segura de los datos de la clave de la máquina antigua, así como el medio de transporte, entre otras cosas.

&Ctrl;&Shift;E Archivo Exportar certificados al servidor…

- Publica los certificados en un servidor de claves (solo &openpgp;).

  Se envía el certificado al servidor de certificados configurado para &openpgp; (cf. configuration-directory-services), si está activo, de otro modo a `keys.gnupg.net`.

  Esta función solo está disponible si se ha seleccionado al menos un certificado &openpgp; (y no &smime;).

  Cuando se han exportado certificados &openpgp; a un servidor de directorio público, es casi imposible eliminarlos de nuevo. Antes de exportar su certificado a un servidor de directorio público, asegúrese de que usted ha creado un certificado de revocación de modo que usted pueda revocar el certificado más tarde si lo necesita.

  La mayor parte de los servidores de certificados &openpgp; sincronizan los certificados entre sí, por lo que no tiene mucho sentido enviar más de uno.

  Puede ocurrir que una búsqueda en un servidor de certificados no devuelva resultados incluso aunque usted acabe de enviar su certificado allí. Esto es debido a que la mayor parte de las direcciones de servidores de claves públicos utilizan DNS round-robin para equilibrar la carga sobre varias máquinas. Estas máquinas se sincronizan entre ellas, pero, generalmente, solo cada 24 horas más o menos.

Archivo Descifrar/Verificar archivos…

- Descifra archivos o verifica firmas sobre archivos.

Archivo Firmar/cifrar archivos…

- Firma o cifra archivos.

&Ctrl;W Archivo Cerrar

- Cierra la ventana principal de &kleopatra;. Usted puede restaurarla en cualquier momento desde el icono de la bandeja del sistema.

&Ctrl;Q Archivo Salir

- Hace que termine &kleopatra;.

### Menú ver

F5 Ver Volver a mostrar

- Refresca la lista de certificados.

  El uso de esta función no es necesaria en general, ya que &kleopatra; monitoriza el sistema de archivos en busca de cambios y refresca automáticamente la lista de certificados cuando se necesita.

&Esc; Ver Detener operación

- Detiene (cancela) todas las operaciones pendientes, ⪚ una búsqueda, listado de claves o una descarga.

  Esta función solo está disponible si al menos está activa una operación.

  Debido a limitaciones del motor, algunas veces las operaciones se bloquearán de tal modo que esta función no será capaz de cancelarlas, inmediatamente, o del todo.

  En esos casos, el único modo de restaurar el orden es matar los procesos &scdaemon;, &dirmngr;, &gpgsm; y &gpg;, en ese orden, vía las herramientas del sistema operativo (`top`, gestor de tareas, &etc;), hasta que la operación se desbloquee.

Ver Detalles del certificado

- Muestra los detalles del certificado seleccionado actualmente.

  Esta función solo está disponible si se ha seleccionado exactamente un certificado.

  Esta función también está disponible haciendo doble clic directamente sobre el elemento correspondiente de la vista de lista.

Ver Lista jerárquica de certificados

- Conmuta entre el modo jerárquico y el plano de la lista de certificados.

  En el modo jerárquico, los certificados están ordenados por relaciones emisor/asunto, por lo que es sencillo ver a qué jerarquía de certificación pertenece un certificado dado, pero es más difícil encontrar un certificado inicialmente (por supuesto, también puede usar labarra de búsqueda).

  En modo plano, se muestran todos los certificados en una lista plana, ordenados alfabéticamente. En este modo, es fácil de encontrar un certificado dado, pero no se aprecia claramente a qué certificado raíz pertenece.

  Esta función conmuta el modo jerárquico por pestaña, &ie; cada pestaña dispone de su propio estado jerárquico. Esto es lo porque usted puede tener ambas, una lista jerárquica y plana y un listado jerárquico a mano, cada uno en su propia pestaña.

  La vista jerárquica está actualmente implementada solo para certificados &smime;. Existe un desacuerdo entre los desarrolladores respecto al modo correcto de mostrar los certificados &openpgp; jerárquicamente (básicamente padre = firmante o padre = firmado).

&Ctrl;. Ver Expandir todo

- Expande todos los elementos en la vista de lista de certificados, &ie;, hace que todos los elementos estén disponibles.

  Es el valor predeterminado al entrar en el modo jerárquico de lista de claves.

  Por supuesto, puede expandir y contraer los elementos individuales.

  Esta función solo está disponible cuando está activa view-hierarchical-key-list.

&Ctrl;, Ver Colapsar todo

- Contrae todos los elementos de la lista en la vista de lista de certificados, &ie; oculta todos los elementos, salvo los de nivel superior.

  Por supuesto, puede expandir y contraer los elementos individuales.

  Esta función solo está disponible cuando está activa view-hierarchical-key-list.

### Menú certificados

Certificados Cambiar confianza del propietario…

- Cambia la confianza del propietario del certificado &openpgp; seleccionado.

  Esta función solo está disponible cuando exactamente está seleccionado un certificado &openpgp;.

Certificados Certificado raíz de confianza

- Marca este (&smime;) certificado raíz como de confianza.

  En algún modo, esto es el equivalente de certificates-change-owner-trust para certificados raíces &smime;. Usted puede, sin embargo, elegir solo entre—en función de &openpgp; los términos—extrema confianza y nunca confiar.

  El motor (por medio de &gpgagent;) preguntará en el momento de importación del certificado raíz si confiar en el certificado raíz importado. Sin embargo, la función debe ser activada explícitamente en la configuración del motor (`permitir-marcar-confiable` in `gpg-agent.conf`, o bien Sistema GnuPG Agente GPG Permitir a los clientes marcar como "confiable" o Validación S/MIME Permitir marcar certificados raíces como de confianza bajo configuration).

  La activación de esta funcionalidad en el motor puede llevar a ventanas emergentes de &pinentry; en momentos inoportunos (⪚ cuando se verifiquen firmas) y puede bloquear el tratamiento desatendido del correo. Por ese motivo y porque es deseable permitir desconfiar de un certificado raíz de confianza de nuevo, &kleopatra; permite la configuración manual de confianza.

  Debido a la carencia de implementación en el motor para esta función, &kleopatra; necesita trabajar directamente en la base de datos de confianza &gpgsm; (`trustlist.txt`). Cuando se utilice esta función, asegúrese de que no estén en curso otras operaciones de cifrado que puedan interferir con &kleopatra; para modificar esa base de datos.

  Esta función solo está disponible cuando se ha seleccionado exactamente un certificado raíz &smime; y ese certificado no es todavía de confianza.

  Utilice certificates-distrust-root para deshacer esta función.

Certificados Desconfiar de certificado raíz

- Marca este certificado (&smime;) como no confiable.

  Esta función solo está disponible cuando se ha seleccionado exactamente un certificado raíz &smime; y ese certificado es actualmente de confianza.

  Utilizado para deshacer certificates-trust-root. Consulte ahí para más detalles.

Certificados Certificar certificado…

- Le permite certificar otro certificado &openpgp;.

  Esta función solo está disponible si está seleccionado exactamente un certificado &openpgp;.

Certificados Cambiar fecha de caducidad…

- Le permite cambiar la fecha de caducidad de su certificado &openpgp;.

  Utilice esta función para aumentar el tiempo de vida de sus certificados &openpgp; como alternativa a bien crear uno nuevo, o usar un tiempo de vida ilimitado (nunca caduca).

  Esta función solo está disponible cuando se ha seleccionado exactamente un certificado &openpgp; y la clave secreta está disponible para ese certificado.

Certificados Cambiar frase de contraseña…

- Le permite cambiar la frase de contraseña de su clave secreta.

  Esta función solo está disponible si está seleccionado exactamente un certificado y la clave secreta está disponible para ese certificado. Necesita un motor muy reciente, ya que hemos cambiado la implementación de llamadas directas a &gpg; y &gpgsm; a una basada en &gpgme;.

  Por motivos de seguridad, &pinentry;, pregunta tanto la vieja como la nueva frase de contraseña, en un proceso separado. Dependiendo de la plataforma que usted esté ejecutando y de la calidad de la implementación de &pinentry;, en esa plataforma, puede ocurrir que la ventana de &pinentry;, aparezca en segundo plano. Por tanto, si usted elige esta función y no pasa nada, compruebe la barra de tareas del sistema operativo por si acaso una ventana de &pinentry;, está abierta en segundo plano.

Certificados Añadir ID-de-usuario…

- Permite añadir un nuevo usuario a su certificado &openpgp;.

  Utilice esto para añadir nuevas identidades a un certificado que ya exista como alternativa a crear un nuevo par de claves. Un id de usuario &openpgp; tiene el siguiente formato:

      Nombre Real (Comentario) <Correo>

  En el diálogo que aparece cuando usted selecciona esta función, &kleopatra; le preguntará por cada uno de los tres parámetros (`Nombre real`, `Comentario` y `Correo`) por separado y muestra el resultado en una previsualización.

  Esos parámetros están sujetos a las mismas restricciones de administración que los nuevos certificados. Consulte functions-newkey y admin-certificate-request-wizard para más detalles.

  Esta función solo está disponible cuando se ha seleccionado exactamente un certificado &openpgp; y la clave secreta está disponible para ese certificado.

Suprimir Certificados Borrar

- Borra los certificados seleccionados del anillo de claves local.

  Use esta función para eliminar las claves no usadas de su caja de claves local. Sin embargo, como los certificados se añaden típicamente a los correos electrónicos firmados, verificar un correo electrónico puede provocar que la clave se elimine en la caja de claves local. Por tanto, probablemente lo mejor sea evitar esta función siempre que sea posible. Cuando se pierda, use la barra de búsqueda o la funciónview-hierarchical-key-list para volver a tomar control sobre el lote de certificados.

  Existe solo una excepción a lo de arriba. Cuando usted borra uno de sus propios certificados, usted borra la clave secreta con él. Esto implica que usted no podrá leer las comunicaciones pasadas cifradas para usted utilizando este certificado, salvo que tenga una copia de respaldo por algún lado.

  &kleopatra; le advertirá cuando intente borrar una clave secreta.

  Debido a la naturaleza jerárquica de los certificados &smime;, si usted borra un certificado de emisor &smime; (certificado &ca;) se borran también todos los asuntos.

  Esto es lo mismo que un sistema de archivos. Cuando usted borra una carpeta, usted borra también todas las carpetas dentro de ella.

  Naturalmente, esta función está disponible solo si usted selecciona al menos un certificado.

Certificados Volcar certificado

- Muestra toda la información que &gpgsm; dispone sobre el certificado (&smime;) seleccionado.

  Consulte el debate sobre `--dump-key `clave`` en el manual de &gpgsm; para más detalles sobre la salida.

### Menú herramientas

Herramientas Visor del registro de GnuPG…

- Inicia &kwatchgnupg;, una herramienta para mostrar la salida de depuración de la aplicación &gnupg;. Si el firmado, cifrado o verificación se detienen misteriosamente, usted podría encontrar el por qué buscando en el registro.

  Esta función no esta disponible en &Windows;, dado que los mecanismos subyacentes no está implementados en el motor de esta plataforma.

Herramientas Refrescar certificados OpenPGP

- Refresca todos los certificados &openpgp; ejecutando

      gpg --refresh-keys

  Después de que la orden termine satisfactoriamente, su almacén de claves local reflejará los últimos cambios respecto a la validez de los certificados &openpgp;.

  Consulte la nota bajo certificates-refresh-x509 para más detalles.

herramientas Refrescar certificados X.509

- Refresca certificados &smime; ejecutando

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

  Después de la terminación satisfactoria de la orden, su almacén de claves local reflejará los últimos cambios respecto a la validez de certificados &smime;.

  Refrescar certificados &x509; o &openpgp; implica descargar los certificados y &crl;, para comprobar si cualquiera de ellos ha sido revocado en el intervalo.

  Esto puede suponer una sobrecarga severa en sus propias conexiones y en la de otra gente y puede tardar más de una hora en completarse, dependiendo de su conexión de red y el número de certificados a comprobar.

Herramientas Importar CRL desde archivo…

- Le permite importar manualmente &crl; desde archivos.

  Normalmente, las listas de revocación de certificados &crl;se manejan de modo transparente por el motor, puro algunas veces puede ser útil importar manualmente una &crl; de la caché local de &crl;.

  Para que la importación de &crl; funcione, la herramienta &dirmngr; debe encontrase en la búsqueda `PATH`. Si la opción de menú esta desactivada, usted debería contactar con el administrador del sistema y preguntarle cómo instalar &dirmngr;.

Herramientas Borrar caché de CRL

- Borra la caché &crl; de &gpgsm;.

  Usted probablemente nunca necesite esto. Usted puede forzar un refresco de la caché de las &crl; seleccionando todos los certificados y utilizando certificates-refresh-x509 en su lugar.

Herramientas Volcar caché de CRL

- Muestra los contenidos detallados de la caché de &crl; de &gpgsm;.

### Menú preferencias

&kleopatra; tiene un menú predeterminado de &kde; Preferencias descrito en los Fundamentos de &kde; con una entrada adicional:

Preferencias Ejecutar autoprueba

- Ejecuta un conjunto de pruebas y presenta sus resultados.

  Este es el mismo conjunto de pruebas que se ejecuta por omisión en el arranque. Si usted desactiva las pruebas en el arranque, usted puede reactivarlas aquí.

### Menú ventana

El menú Ventana le permite gestionar las pestañas. Usando los elementos de este menú usted puede cambiar de nombre una pestaña, añadir una nueva pestaña, duplicar la actual y mover la pestaña actual a la derecha o la izquierda.

Pulsando con el &RMB; en una pestaña se abre un menú de contexto, donde usted puede seleccionar varias acciones.

### Menú ayuda

&kleopatra; tiene un menú predeterminado de &kde; Ayuda descrito en los Fundamentos de &kde;.

## Referencia de las opciones de la línea de órdenes

Solo se muestran aquí las opciones específicas de &kleopatra;. Como con todas las aplicaciones de &kde;, puede tener una lista completa de estas opciones lanzando la orden ``kleopatra `--help```.

`--uiserver-socket` `argumento`

- Ubicación del socket en el que está escuchando el servidor ui

`--daemon`

- Ejecuta solo el servidor UI, esconde la ventana principal

`-p` `--openpgp`

- Utiliza &openpgp; para la siguiente operación

`-c` `--cms`

- Utiliza CMS (&x509;, S/&MIME;) para la siguiente operación

`-i` `--import-certificate`

- Especifica un archivo o un &URL; desde donde importar los certificados (o claves secretas).

  Esta es la orden equivalente de file-import-certificates.

`-e` `--encrypt`

- Cifrar archivo(s)

`-s` `--sign`

- Firma archivo(s)

`-E` `--encrypt-sign`

- Cifra o firma archivo(s). Al igual que `--sign-encrypt`, no utilizarla

`-d` `--decrypt`

- Descifrar archivo(s)

`-V` `--verify`

- Verifica archivo/firma

`-D` `--decrypt-verify`

- Descifrar o verificar archivo(s)

## Configurando &kleopatra;

El diálogo de configuración de &kleopatra; puede accederse vía Preferencias Configurar &kleopatra;…

En las secciones siguientes se describe cada una de las páginas.

### Configuración de servicios de directorio

En esta página usted puede configurar que servidores &ldap; utilizar para la búsqueda de certificados &smime; y que servidores de claves utilizar para búsquedas de certificados &openpgp;.

Este es una versión simple y más amigable con el usuario de las mismas preferencias que usted puede encontrar también en configuration-gnupg-system. Todo lo que usted puede configurar aquí, también lo puede configurar allí.

#### Una nota sobre configuración del proxy

La configuración del proxy puede hacerse por &http; y &ldap; en configuration-smime-validation, pero solo para &gpgsm;. Para &gpg;, debido a la complejidad de las opciones del servidor de claves en &gpg; y la carencia de reconocimiento adecuado de estas en &gpgconf;, usted necesita actualmente modificar el archivo de configuración `gpg.conf`. Por favor, remítase al manual de &gpg; para más detalles. &kleopatra; conservará esa configuración, pero no le permite modificarla en la &GUI;.

La tabla Servicios de directorio muestra que servidores están configurados actualmente. Haga doble clic en una celda en la tabla para cambiar los parámetros de las entradas de servidor existentes.

El significado de las columnas en la tabla es como sigue:

Esquema

- Determina el protocolo de red que se utiliza para acceder al servidor. Los esquemas usados frecuentemente incluyen ldap (y su gemelo seguro &ssl;-ldaps) para servidores &ldap; (protocolo común para &smime; el único admitido por &gpgsm;) y hkp, el protocolo Horowitz Keyserver, hoy en día, generalmente &http; Keyserver Protocol, un protocolo basado en &http; que admite casi todos los servidores de claves &openpgp;.

  Por favor, consulte los manuales de &gpg; y &gpgsm; para una lista de esquemas admitidos.

Nombre del servidor

- El nombre de dominio del servidor, ⪚ `keys.gnupg.net`.

Puerto del servidor

- El puerto de red en el que el servidor está escuchando.

  Esto cambia automáticamente al puerto predeterminado cuando usted cambia configuration-directory-services-scheme, salvo que se haya asignado a algún puerto no estándar para empezar. Si usted cambió el puerto predeterminado y no puede volver atrás, intente asignar configuration-directory-services-scheme a `http` y configuration-directory-services-server-port a `80` (el predeterminado para &http;), entonces tómelo de ahí.

DN base

- El &dn;-base (solo para &ldap; y &ldaps;), &ie; la raíz de la jerarquía &ldap; por la que comenzar. A esto se le llama, generalmente raíz de búsqueda o base de búsqueda.

  Generalmente, se parece a `c=de,o=Foo`, dado como parte de la &URL; &ldap;.

Nombre de usuario

- El nombre de usuario, si existe, que se usa para iniciar sesión en el servidor.

  Esta columna solo se muestra si la opción Mostrar información de usuario y contraseña (bajo la tabla) está marcada.

Contraseña

- La contraseña, si existe, que se utiliza para iniciar sesión en el servidor.

  Esta columna solo se muestra si la opción Mostrar información de usuario y contraseña (bajo la tabla) está marcada.

X.509

- Marque esta columna si esta entrada debe usarse para búsquedas de certificados &x509; (&smime;).

  Solo los servidores &ldap; (y &ldaps;) se admiten para &smime;.

OpenPGP

- Marque esta columna si esta entrada debe utilizarse para búsquedas de certificados &openpgp;.

Usted puede configurar tantos servidores &smime; (&x509;) como quiera, pero solo se permite un servidor &openpgp; a la vez. La &GUI; reforzará esto.

Para añadir un nuevo servidor, pulse en el botón Nuevo. Esto duplica la entrada seleccionada si existe o si no, inserta un servidor &openpgp; predeterminado. Después usted puede ajustar configuration-directory-services-server-name, configuration-directory-services-server-port, configuration-directory-services-base-dn y el habitual configuration-directory-services-password y configuration-directory-services-user-name, los cuales solo se necesitan si el servidor necesita autenticación.

Para insertar directamente una entrada para certificados &x509; utilice Nuevo X.509; utilice Nuevo OpenPGP para &openpgp;.

Para eliminar un servidor de la lista de búsqueda, selecciónelo en la lista y luego pulse el botón Borrar.

Para definir el tiempo de espera de &ldap;, &ie; el tiempo máximo que el motor esperará para que responda el servidor, simplemente use el correspondiente campo de entrada, llamado Tiempo de espera LDAP (minutos:segundos).

Si uno de los servidores tiene una base de datos enorme que hace que, búsquedas razonables como `García` alcancen el número máximo de elementos devueltos por la consulta, puede querer incrementar este límite. Puede averiguar fácilmente si alcanza este límite durante la búsqueda, porque en ese caso se desplegará un cuadro de diálogo para decirle que se van a truncar los resultados.

Algunos servidores pueden imponer sus propios límites al número de elementos que devuelve una consulta. En este caso, aunque incremente el límite no se devolverán más elementos.

### Configuración de apariencia

#### ConfigurarConsejos emergentes

En la lista principal de certificados, &kleopatra; puede mostrar detalles sobre un certificado en un consejo emergente. La información que se muestra es la misma que en la pestaña Visión general del diálogo Detalles del certificado. Los consejos emergentes, sin embargo, pueden restringirse a mostrar solo un subconjunto de la información para una experiencia menos detallada.

El Clave-ID se muestra siempre. Esto asegura que los consejos emergentes para certificados distintos son, de hecho, distintos (esto es especialmente importante si solo se ha seleccionado tooltips-validity).

Usted puede activar o desactivar independientemente los siguientes grupos de información:

Mostrar validez

- Muestra información sobre la validez de un certificado: su estado actual, emisor-&dn; (solo &smime;), fechas de caducidad (si existe) e indicadores de uso del certificado.

  Ejemplo:

      Este certificado es válido en la actualidad.
      Issuer:            CN=Test-ZS 7,O=Intevation GmbH,C=DE
      Validity:          from 25.08.2009 10:42 through 19.10.2010 10:42
      Uso del certificado: Firma de correos y archivos, cifrado de correos y archivos
      Key-ID:            DC9D9E43

Mostrar información del propietario

- Muestra información sobre el propietario del certificado: asunto-&dn; (solo &smime;), id-de-usuario (incluso dirección de correo) y confianza del propietario (solo &openpgp;).

  Ejemplo de &openpgp;:

      User-ID:           Gpg4winUserA <gpg4winusera@test.hq>
      Key-ID:            C6BF6664
      Ownertrust:        ultimate

  ejemplo de &smime;:

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

Mostrar detalles técnicos

- Muestra información técnica sobre el certificado: número de serie (solo &smime;), tipo, huella dactilar y ubicación de almacenamiento.

  Ejemplo:

      Serial Number:     27
      Certificate type:  1,024-bit RSA (secret certificate available)
      Key-ID:            DC9D9E43
      Fingerprint:       854F62EEEBB41BFDD3BE05D124971E09DC9D9E43
      Stored:            on this computer

#### Configuración de Categorías de certificado

&kleopatra; le permite personalizar la apariencia de los certificados en la vista de lista. Esto incluye mostrar un pequeño icono, pero usted también puede cambiar los colores de primer plano (de texto) y de fondo, así como el tipo de letra.

A cada categoría de certificado en la lista se le asigna un conjunto de colores, un icono (opcional) y un tipo de letra en los que se muestran los certificados de la categoría. La lista de categorías también actúa como vista previa de las preferencias. Las categorías las puede definir libremente el administrador o el usuario avanzado. Puede dirigirse a admin-key-filters en admin.

Para establecer o cambiar el icono de una categoría, selecciónelo en la lista y pulse el botón Establecer icono…. Aparecerá el diálogo de selección estándar de iconos de &kde;, donde usted puede seleccionar un icono que exista desde la colección de &kde; o cargar uno personalizado.

Para eliminar un icono de nuevo, usted necesita pulsar el botón Aspecto predeterminado.

Para cambiar el color del texto (&ie; primer plano) de una categoría, selecciónelo en la lista y pulse el botón Establecer el color del texto…. Aparecerá el diálogo estándar de selección de color de &kde; donde usted podrá seleccionar un color que exista o crear uno nuevo.

El cambio del color de fondo se hace de la misma forma. Simplemente pulse Establecer color de fondo….

Para cambiar el tipo de letra, básicamente tiene dos opciones:

1. Modificar el tipo de letra estándar, usada en todas las vistas en &kde;.

2. Usar un tipo de letra personalizado.

La primera opción tiene la ventaja de que el tipo de letra seguirá el estilo que seleccione para &kde; al completo, mientras que la última le da un control completo sobre el tipo de letra que se va a usar. Suya es la decisión.

Para usar el tipo de letra estándar modificado, seleccione la categoría de la lista y marque o desmarque los modificadores de tipo de letra Cursiva, Negrita o Tachado. Puede ver inmediatamente el efecto del tipo de letra en la lista de categorías.

Para usar un tipo de letra personalizado, pulse el botón Establecer tipo de letra…. Aparecerá el diálogo de selección de tipos de letra estándar de &kde; y podrá seleccionar el nuevo tipo de letra.

Usted todavía puede utilizar los modificadores de tipo de letra para cambiar el tipo de letra personalizado, igual que para modificar el tipo de letra estándar.

Para volver al tipo de letra estándar, tiene que pulsar el botón Apariencia predeterminada.

#### Configurar el Orden de atributos DN

Aunque los &dn;s son jerárquicos, el orden de los componentes individuales (llamados &dn;s relativos (RDN), o atributos &dn;s) no está definido. El orden en el que se muestran los atributos es, por tanto, cuestión de gustos personales o de política de empresa, de ahí que sea configurable en &kleopatra;.

Esta opción no solo se aplica a &kleopatra;, sino a todas las aplicaciones que usen la tecnología de &kleopatra;. En el momento de escribir estas líneas, entre ellas estaban &kmail; &kaddressbook;, así como la propia &kleopatra;, por supuesto.

Esta página de configuración consta básicamente de dos listas, una para los atributos conocidos (Atributos disponibles) y uno para describir el Orden actual de los atributos.

Ambas listas tienen entradas descritas por la forma breve del atributo (⪚ CN), así como la forma expandida (Nombre común).

La lista Atributos disponibles siempre se ordena alfabéticamente, mientras que la lista Orden actual del atributo refleja el orden del atributo &dn; configurado: el primer atributo de la lista también es el que se muestra primero.

Solo los atributos que se muestran explícitamente en la lista Orden actual de los atributos se muestran. Los demás están ocultos de forma predeterminado.

Sin embargo, si la entrada de marcador de posición _X_ (Todos los demás) está en la lista actual, todos los atributos que no se muestren (sean conocidos o no) se insertarán donde diga la _X_, en su orden relativo original.

Un pequeño ejemplo ayudará a aclarar el asunto:

Dado el &dn;

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

el orden de atributos predeterminado para CN, L, _X_, OU, O, C producirá el siguiente &dn; formateado:

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

mientras que CN, L, OU, O, C producirá

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

Para añadir un atributo al orden de visualización de la lista, selecciónelo en la lista Atributos disponibles y pulse el botón Añadir al orden de atributos actual.

Para eliminar un atributo del orden de visualización de la lista, selecciónelo en la lista Atributos disponibles y pulse el botón Eliminar del orden de atributos actual.

Para mover un atributo al principio (final), selecciónelo en la lista Orden actual de los atributos y pulse el botón Mover al principio (Mover al final).

Para mover un atributo hacia arriba (abajo) solo una posición, selecciónelo de la lista Orden actual de los atributos y pulse el botón Mover uno hacia arriba (Mover uno hacia abajo).

### Configuración de operaciones de cifrado

#### Configurar Operaciones de correo

Aquí usted puede configurar algunos aspectos de las operaciones de correo de la &uiserver; de &kleopatra;. Actualmente, usted solo puede configurar si utilizar o no Modo rápido para firmar y cifrar correos, individualmente.

Cuando está activado Modo rápido, no se muestra ningún diálogo cuando se firman (cifran) correos, respectivamente, salvo que haya un conflicto que necesite de resolución manual.

#### Configurar Operaciones de archivo

Aquí usted puede configurar algunos aspectos de operaciones de archivo en la &uiserver; de &kleopatra;. Actualmente, usted solo puede elegir el programa de suma de verificación a utilizar `CHECKSUM_CREATE_FILES`.

Utilice Programa de suma de verificación a utilizar para elegir cual de los programas de suma de verificación configurados deben emplearse cuando se crean archivos de suma de verificación.

Cuando se comprueban sumas de verificación, el programa a utilizar se encuentra automáticamente, basándose en los nombres de los archivos de sumas de verificación encontrados.

El administrador y el usuario avanzado pueden definir completamente cuales de los programas de suma de verificación deben estar disponibles para &kleopatra; a través de las llamadas Definiciones de sumas de verificación en el archivo de configuración. Consulte admin-checksum-definitions en admin para más detalles.

### Configuración de aspectos de validación S/&MIME;

En esta página, usted puede configurar ciertos aspectos de la validación de certificados &smime;.

En su mayor parte, esto es sencillamente una versión más amigable de las mismas preferencias que usted encontrará en configuration-gnupg-system. Todo lo que usted configure aquí, lo puede configurar allí también, con la excepción de configuration-smime-validation-refresh-interval, que es específica de &kleopatra;.

El significado de las opciones es el siguiente:

#### Configuración del intervalo de comprobación de certificados

Comprobar la validez del certificado cada `N` horas

- Esta opción permite la comprobación de la validez del certificado a intervalos. Usted puede elegir también el intervalo de comprobación (en horas). El efecto de la comprobación a intervalos es lo mismo que view-redisplay; no hay ninguna disposición para planificación de intervalos de certificates-refresh-openpgp o certificates-refresh-x509.

  La validación se ejecuta implícitamente cuando cambian archivos significativos en `~/.gnupg`. Esta opción, al igual que certificates-refresh-openpgp y certificates-refresh-x509, por lo tanto, solo afecta a factores externos de la validez del certificado.

#### Configuración del método de validación

Validar certificados usando CRL

- Si está seleccionada esta opción, los certificados &smime; se validarán usando Listas de Revocación de Certificados (&crl;).

  Consulte configuration-smime-validation-use-ocsp para métodos alternativos para la comprobación de la validez de certificados.

Validar certificados en línea (OCSP)

- Si esta opción está seleccionada, los certificados &smime; se validan con conexión usando el protocolo de estado de certificados en línea (&ocsp;).

  Cuando se elige este método, se envía una petición al servidor de la &ca;, más o menos cada vez que usted envía o recibe un mensaje criptográfico, así teóricamente se permite a la agencia emisora del certificado rastrear con quien intercambia usted (⪚) correos.

  Para usar este método usted necesita introducir la &URL; de respuesta del &ocsp; en configuration-smime-validation-ocsp-url.

  Consulte configuration-smime-validation-use-ocsp para un método más tradicional para comprobación de la validez de certificados que no pierde información sobre quién intercambia mensajes con usted.

URL de respuesta del OCSP

- Introduzca aquí la dirección del servidor para la validación con conexión de certificados (respuesta &ocsp;). La &URL; comienza, generalmente con `http://`.

Firma de respuesta del OCSP

- Elija aquí el certificado con el que el servidor &ocsp; firmará sus respuestas.

Ignorar servicio URL de certificados

- Cada certificado &smime; contiene, generalmente la &URL; de sus respuestas &ocsp; del emisor (certificates-dump-certificate que revelan si un certificado dado la contiene).

  Marcar esta opción hace que &gpgsm; ignore aquellas &URL; y solo utilice la configurada arriba.

  Utilice esto para ⪚ imponer el uso de un proxy corporativo &ocsp;.

#### Configuración de las opciones de validación

No verificar políticas de certificado

- De forma predeterminada, &gpgsm; usa el archivo `~/.gnupg/policies.txt` para comprobar si se permite la política de certificados. Si esta opción está seleccionada, no se comprueban las políticas.

Nunca consultar una CRL

- Si esta opción está marcada, nunca se usan las listas de revocación de certificados para validar los certificados &smime;.

Permitir marcar certificados raíz como de confianza

- Si esta opción esta marcada mientras se importa un certificado raíz &ca;, se le pedirá confirmar su huella dactilar y declarar si usted considera o no fiable este certificado raíz.

  Un certificado raíz necesita ser de confianza antes de que los certificados que certifica se hagan de confianza, pero confiar a la ligera en certificados raíces en su almacén de certificados socavará la seguridad del sistema.

  La activación de esta funcionalidad en el motor puede llevar a ventanas emergentes de &pinentry; en momentos inoportunos (⪚ cuando se verifiquen firmas) y puede bloquear el tratamiento desatendido del correo. Por ese motivo y porque es deseable permitir desconfiar de un certificado raíz de confianza de nuevo, &kleopatra; permite la configuración manual de confianza utilizando certificates-trust-root y certificates-distrust-root.

  Esta preferencia no influye en el funcionamiento de &kleopatra;.

Obtener emisores de certificados perdidos

- Si esta opción está marcada, los certificados de emisores se descargarán cuando sea necesario (esto se aplica a ambos métodos de validación, &crl; y &ocsp;).

#### Configuración de las opciones de peticiones &http;

No realizar ninguna petición HTTP

- Desactiva por completo el uso de &http; para &smime;.

Ignorar el punto de distribución HTTP de CRL de certificados

- Cuando se busca la ubicación de una &crl;, el certificado a ser probado usualmente contiene lo que se denomina entradas &crl; Punto de distribución (DP), que son &URL;s que describen el modo de acceder a la &crl;. La primera entrada DP es usada.

  Con esta opción, todas las entradas que utilicen el esquema &http; se ignoran al buscar una DP adecuada.

Usar el proxy HTTP del sistema

- Si esta opción está seleccionada, el valor del proxy &http; que se muestra a la derecha (que proviene de la variable de entorno `http_proxy`) se usará para cualquier solicitud &http;.

Usar este proxy para peticiones HTTP

- Si no se ha establecido un proxy del sistema, o usted necesita utilizar uno diferente para &gpgsm;, usted puede introducir aquí su ubicación.

  Se utilizará para todas las peticiones &HTTP; relacionadas con S/&MIME;.

  La sintaxis es ``servidor``:``puerto``, ⪚ `myproxy.nowhere.com:3128`.

#### Configuración de las opciones de peticiones &ldap;

No realizar ninguna petición LDAP

- Desactiva por completo el uso de &ldap; para &smime;.

Ignorar el punto de distribución de certificados CRL LDAP

- Cuando se busca la ubicación de una &crl;, el certificado a ser probado usualmente contiene lo que se denomina entradas «Punto de distribución» de &crl; (DP), que son &URL; que describen el modo de acceder a la &crl; La primera entrada DP se usa.

  Con esta opción, todas las entradas que utilicen el esquema &ldap; se ignoran al buscar una DP adecuada.

Servidor principal para las peticiones LDAP

- Al introducir aquí un servidor &ldap;, hace que todas las peticiones se dirijan, en primer lugar, a ese servidor. De forma más precisa, esta opción remplaza a cualquier componente `servidor` y `puerto` especificado en una &URL; &ldap; y se utilizará también si el `servidor` y `puerto` se omiten en la &URL;.

  Se utilizarán otros servidores &ldap; solo si la conexión al proxy ha fallado. La sintaxis es ``servidor`` o ``servidor``:``puerto``. Si se omite `puerto`, se utiliza el puerto 389 (puerto estándar &ldap;).

### Configuración del sistema &gnupg;

Esta parte del diálogo es autogenerada por la salida de `gpgconf `--list-components`` y para cada `componente` que devuelve la orden de arriba, la salida de `gpgconf `--list-options` `componente``.

Las opciones más útiles se han duplicado en páginas separadas en el diálogo de configuración de &kleopatra;. Consulte configuration-directory-services y configuration-smime-validation para las dos páginas de diálogo que contienen secciones seleccionadas de esta parte del diálogo.

El contenido exacto de esta parte del diálogo depende de la versión del motor &gnupg; que usted tenga instalado y, potencialmente, de la plataforma en la que lo ejecute. Así, solo comentaremos el esquema general del diálogo, incluyendo la asociación de la opción &gpgconf; a la &GUI; de &kleopatra;.

&gpgconf; devuelve información de configuración para componentes múltiples, dentro de cada componente, las opciones individuales se combinan en grupos.

&kleopatra; muestra una pestaña por cada componente devuelto por &gpgconf; los grupos están encabezados por una línea horizontal que muestra el nombre de grupo devuelto por &gpgconf;.

Cada opción de &gpgconf; tiene un tipo. Excepto para algunas opciones bien conocidas que &kleopatra; respalda con controles especializados para una mejor experiencia de usuario, la asociación entre tipos de &gpgconf; y controles de &kleopatra; es como sigue:

### Asociación de tipos de &gpgconf; a controles de la &GUI;

Tipo &gpgconf; | Control &kleopatra;
para listas | para no-listas
`ninguno` | Cuadro de número (cuenta-semántica) | Casilla de verificación
`cadena` | &NA; | Editor de línea
`int32` | Editor de línea (sin formato) | Cuadro de número
`uint32`
`nombre de ruta` | &NA; | control especializado
`servidor ldap` | control especializado | &NA;
`huella dactilar de clave` | &NA;
`clave pública`
`clave secreta`
`lista de alias`

Consulte el manual de &gpgconf; para más información sobre lo que usted puede configurar aquí y cómo.

## Guía del administrador

La guía del administrador describe las formas de personalizar &kleopatra; a las que no puede acceder por medio de la &GUI;, sino solo por medio de archivos de configuración.

Se asume que el lector está familiarizado con la tecnología que se usa para configurar las aplicaciones de &kde;, como la disposición, la ubicación en el sistema de archivos y la cascada de archivos de configuración de &kde;, así como la infraestructura KIOSK.

### Personalización del asistente de creación de certificados

#### Personalización de los campos &dn;

&kleopatra; le permite personalizar los campos que se le permiten introducir al usuario para crear el certificado.

Cree un grupo llamado `CertificateCreationWizard` en el archivo `kleopatrarc` del sistema. Si quiere que el orden de los atributos sea personalizado, o si quiere que solo aparezcan ciertos elementos, cree una clave llamada `DNAttributeOrder`. El argumento es uno o más de entre `CN,SN,GN,L,T,OU,O,PC,C,SP,DC,BC,EMAIL`. Si quiere inicializar los campos con algún valor, escriba algo como Atributo=valor. Si quiere que el atributo sea requerido, añada una marca de exclamación (por ejemplo, `CN!,L,OU,O!,C!,EMAIL!`, que resulta ser la configuración predeterminada).

El uso del modificador de modo `$e` de KIOSK, se le permite recuperar los valores de las variables de entorno o de un guion evaluado o binario. Si quiere desactivar la edición del campo respectivo, use el modificador `$i`. Si quiere desactivar el uso del botón Insertar mi dirección, defina `ShowSetWhoAmI` como false (n.t. falso).

Debido a la naturaleza de la infraestructura KIOSK de &kde;, el uso del indicador inmutable (`$i`), hace que sea imposible para el usuario remplazar el indicador. Es un comportamiento intencionado. `$i` y `$e` también se pueden usar con todas las claves de configuración de las aplicaciones de &kde;.

El ejemplo siguiente bosqueja las posibles personalizaciones:

    [CertificateCreationWizard]
    ;No permite copiar los datos personales de la libreta de direcciones, ni sobrepasar localmente
    ShowSetWhoAmI[$i]=false

    ;define el nombre del usuario como $USER
    CN[$e]=$USER

    ;define el nombre de la empresa como «Mi empresa», no permite editar
    O[$i]=Mi empresa

    ;define el nombre del departamento según lo que devuelva un guion
    OU[$ei]=$(lookup_dept_from_ip)

    ;define el país como ES, pero permite que el usuario lo cambie
    C=ES

#### Restringiendo los tipos de claves que un usuario puede crear

&kleopatra; también permite restringir que tipo de certificados puede crear un usuario. Tenga en cuenta, sin embargo, que una manera sencilla de saltarse estas restricciones es crear uno en la línea de ordenes.

##### Algoritmos de clave pública

Para restringir los algoritmos de clave pública a utilizar, añada la clave de configuración `PGPKeyType` (y `CMSKeyType`, pero solo se admite RSA para CMS de cualquier manera) para la sección `Asistente de creación de certificados` de `kleopatrarc`.

Los valores permitidos son `RSA` para claves RSA, `DAS` para DSA claves (solo firma) y `DSA+ELG` para una clave DSA (solo firma) con una subclave de cifrado Elgamal.

El valor predeterminado se lee desde &gpgconf; o si no `RSA` si &gpgconf; no proporciona un valor por omisión.

##### Tamaño de la clave pública

Para restringir los tamaños de clave disponibles para un algoritmo de clave pública, añada la clave de configuración ``<ALG>`KeySizes` (donde `ALG` debe ser `RSA`, `DSA` o `ELG`) a la sección`Asistente de creación de certificados` de `kleopatrarc`, que contiene una lita separada por comas de tamaños de claves (en bits). Se puede indicar un valor por omisión prefijando el tamaño de clave con un guion (`-`).

    RSAKeySizes = 1536,-2048,3072

Lo de arriba restringirá los tamaños de claves RSA permitidos a 1536, 2048 y 3072, con el valor 2048 por omisión.

Además de los propios tamaños, usted puede especificar etiquetas para cada uno de los tamaños. Simplemente ajuste la clave de configuración ``ALG`KeySizeLabels` a una lista de etiquetas separada por comas.

    RSAKeySizeLabels = débil,normal,fuerte

Lo de arriba, en conexión con el ejemplo previo, imprimirá algo como las siguientes opciones para la selección:

    débil (1536 bits)
                  normal (2048 bits)
                  fuerte (3072 bits)

Los valores predeterminados son como si lo siguiente estuviera en efecto:

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

### Crear y editar categorías de claves

&kleopatra; permite al usuario configurar la apariencia visual de las claves, basándose en un concepto llamado Categorías de claves. Las Categorías de claves se emplean también para filtrar las listas de certificados. Esta sección describe cómo puede editar las categorías disponibles y añadir otras nuevas.

Cuando intenta localizar la categoría a la que pertenece una clave, &kleopatra; intenta hacer coincidir la clave con una secuencia de filtros de claves, configurados en el archivo `libkleopatrarc`. El primero que coincide define la categoría, basado en el concepto de especificado explicado ampliamente más abajo.

Cada filtro de clave está definido en un grupo de configuración llamado `Key Filter #`n``, en el que `n` es un número, que comienza por el `0`.

La única clave obligatoria en un grupo `Key Filter #`n`` son `Name` (n.t. nombre), que contiene el nombre de la categoría que se mostrará en el diálogo de configuración e `id`, que se utiliza como referencia al filtro en otras secciones de configuración (como`Ver #`n``).

table-key-filters-appearance lista todas las claves que definen las propiedades de visualización de claves que pertenecen a esa categoría (&ie; las claves que se pueden ajustar en el diálogo de configuración), mientras que table-key-filters-criteria lista todas las claves que definen los criterios con los que el filtro empareja las claves.

### Configuración de filtro de claves Definir las propiedades de visualización

Configurar clave | Tipo | Descripción
`background-color` | color | El color de fondo que se va a usar. Si no se indica, por omisión toma el valor del color de fondo definido globalmente para las vistas de lista.
`foreground-color` | color | El color de primer plano que se va a usar. Si no se indica, por omisión toma el valor del color de primer plano definido globalmente para las vistas de lista.
`font` | font (n.t. tipo de letra) | El tipo de letra personalizado que se va a usar. El tipo de letra se escalará hasta el tamaño configurado para las vistas de lista y se aplicarán los atributos de tipos de letra (se explican más abajo).
`font-bold` | boolean (n.t. booleano) | Si está definido como `true` (n.t. cierto) y `font` no está definido, usa el tipo de letra predeterminado de la vista de lista con el estilo de negrita añadido (si está disponible). Se ignora si también está presente `font`.
`font-italic` | boolean (n.t. booleano) | Igual que `font-bold`, pero con el estilo de cursiva en lugar de negrita.
`font-strikeout` | boolean (n.t. booleano) | Si es `true` (n.t. cierto), dibuja una línea por encima del tipo de letra. Se aplica aunque esté definida `font`.
`icono` | text (n.t. texto) | El nombre del icono que se muestra en la primera columna. Aún no implementado.

### Configuración de filtros de claves Definir claves Criterios de filtrado

Configurar clave | Tipo | Si se especifica, los filtros coinciden cuando…
`is-revoked` | boolean (n.t. booleano) | la clave ha sido revocada.
`match-context` | context Contexto es una enumeración con los siguientes valores posibles: `apariencia`, `filtrado` y `cualquiera`. | el contexto en el que este filtro encaja.
`is-expired` | boolean (n.t. booleano) | la clave ha caducado.
`is-disabled` | boolean (n.t. booleano) | el usuario ha desactivado la clave (marcada para que no se use). Se ignora para claves &smime;.
`is-root-certificate` | boolean (n.t. booleano) | la clave es un certificado raíz. Se ignora para claves &openpgp;.
`can-encrypt` | boolean (n.t. booleano) | la clave se puede usar para cifrar.
`can-sign` | boolean (n.t. booleano) | la clave se puede usar para firmar.
`can-certify` | boolean (n.t. booleano) | la clave se puede usar para firmar (certificar) otras claves.
`can-authenticate` | boolean (n.t. booleano) | la clave se puede usar para autenticación (⪚, como un certificado de cliente TLS).
`is-qualified` | boolean (n.t. booleano) | la clave puede usarse para hacer firmas cualificadas (como se definen en la ley alemana de firma digital).
`is-cardkey` | boolean (n.t. booleano) | la clave física se guarda en una tarjeta inteligente (en lugar de en el equipo).
`has-secret-key` | boolean (n.t. booleano) | está disponible la clave secreta para este par de claves.
`is-openpgp-key` | boolean (n.t. booleano) | la clave es una clave &openpgp; (`true` - n.t. cierto) o una clave &smime; (`false` - n.t. falso).
`was-validated` | boolean (n.t. booleano) | la clave ha sido validada.
``prefix`-ownertrust` | validity (validez) La validez (validity) es una enumeración ordenada con los siguientes valores: `unknown` (desconocido), `undefined` (no definido), `never` (nunca),`marginal`, `full` (completo), `ultimate` (definitivo). Puede dirigirse a los manuales de &gpg; y &gpgsm; para tener acceso a una explicación detallada. | la clave tiene exactamente (`prefix` = `is`) lo tiene todo, salvo (`prefix` = `is-not`) tiene al menos (`prefix` = `is-at-least`) o tiene a lo sumo (`prefix` = `is-at-most`) el ownertrust (n.t. confianza del propietario) le da el valor de la clave de configuración. Si hay más de una clave``prefix`-ownertrust` (con diferentes valores para `prefix` - prefijo) en un solo grupo, el comportamiento no está definido.
``prefix`-validity` | validity (validez) | Parecido a ``prefix`-ownertrust`, pero para la validez de las claves en lugar de para la confianza del propietario.

Algunos de los criterios más interesantes, como `is-revoked` (está revocada) o `is-expired` (ha caducado) solo funcionarán con claves validadas, de ahí que, de forma predeterminada, solo se compruebe la validez de las claves para la revocación y la caducidad, aunque usted pueda eliminar estas comprobaciones extra.

Además de las claves configuradas listadas arriba, una clave de filtro puede también tener`id` y `match-contexts`.

Al usar el `id` del filtro, el cual por omisión es igual al nombre del grupo configurado si no se especifica o está vacío, usted puede hacer referencia al filtro clave en cualquier punto de la configuración, ⪚ en la configuración Ver de &kleopatra;. El `id` no es interpretado por &kleopatra;, así que puede utilizar cualquier cadena que desee, siempre que sea única.

`match-contexts` limita la aplicabilidad del filtro. En la actualidad hay definidos dos contextos: El contexto `apariencia` se utiliza cuando se definen propiedades de color y tipo de letra para las vistas. El contexto `filtrado` se utiliza para incluir (y excluir) selectivamente certificados de las vistas. `cualquiera` puede usarse para significar cualquiera de los contextos definidos actualmente y es el valor predeterminado si no se proporciona `match-contexts` o de otro modo no presenta contextos. Esto asegura que ningún filtro de clave puede finalizar muerto, &ie; con ningún contexto aplicable.

El formato de la entrada es una lista de elementos, separados por caracteres no-palabras. Cada uno de los elementos puede estar precedido opcionalmente por una exclamación (`!`), lo que indica negación. Los elementos actúan en orden en una lista interna de contextos, que comienza vacía. Esto se explica mejor mediante un ejemplo: `cualquier !apariencia` es lo mismo que `filtrado` y `apariencia !apariencia` produce un conjunto vacío, igual que `!cualquiera`. Sin embrago, los dos últimos serán remplazados internamente por `cualquiera`, puesto que en definitiva no producen contextos.

En general, los criterios no especificados (&ie; la entrada de configuración no está definida) no se comprueban. Si se proporciona un criterio, se comprueba y debe coincidir con el filtro por completo para que se haga coincidir, &ie; los criterios Y juntos.

Cada filtro tiene una especificidad implícita que se usa para jerarquizar todos los filtros que encajen. El filtro más específico gana sobre los menos específicos. Si dos filtros tienen la misma especificidad, gana el que está primero en el archivo de configuración. La especificidad de un filtro es proporcional al número de criterios que contiene.

#### Ejemplos de filtros de claves

Para comprobar todos los certificados raíz caducados, pero no revocados, usted podría usar un filtro de claves definido de la siguiente forma:

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

Para comprobar que todas las claves &openpgp; desactivadas (&kleopatra; aún no lo admite) tienen una confianza del propietario al menos marginal, usted debería usar:

    [Key Filter #n]
    Name=disabled OpenPGP keys with marginal or better ownertrust
    is-openpgp=true
    is-disabled=true
    is-at-least-ownertrust=marginal
    ; ( specificity 3 )

### Configurar archivadores para utilizar con archivos de firmado/cifrado

&kleopatra; permite al administrador (y usuario avanzado) configurar la lista de archivadores que se muestran en el diálogo de firmar/cifrar archivos.

Cada archivador se define en `libkleopatrarc` como un grupo separado `Archivo Definición #`n``, con las siguientes claves obligatorias:

`extensions`

- Una lista separada por comas de extensiones de nombre de archivo que, generalmente indican este formato de archivo comprimido.

`id`

- Un ID único empleado para identificar este archivador internamente. En caso de duda, utilice el nombre de la orden.

`Nombre` (traducido)

- El nombre visible para el usuario de ese archivador, como se muestra en el correspondiente menú desplegable del diálogo de firmado/cifrado de archivos.

`pack-command`

- La orden real para archivar archivos. Usted puede utilizar cualquier orden, siempre y cuando no se necesite una «shell» para ejecutarla. El archivo del programa se busca utilizando la variable de entorno `PATH`, salvo que usted emplee una ruta absoluta de archivo. Se admite el entrecomillado si se usa la «shell»:

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

Puesto que la barra inversa (`\`) es un carácter de escape en los archivos de configuración de &kde;, usted necesita duplicarla cuando aparezca en los nombres de rutas.

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

Sin embargo, para la propia orden (como opuesto a sus argumentos), usted debe usar solo barras oblicuas (`/`) como separadores de rutas en todas las plataformas

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

. Esto no se admite para los argumentos, como la mayoría de los programas de &Windows; utilizan la barra oblicua para opciones. Por ejemplo, lo siguiente no funcionará, puesto que `C:/myarchivescript.bat` es un argumento a `cmd.exe`, y `/` no se convierte en los argumentos a `\`, solo en las ordenes:

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

. Esto necesita escribirse en su lugar como:

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

#### Nombre de archivo de entrada pasado por `pack-command`

Hay tres formas de pasar nombres de archivo a la orden de empaquetar. Para cada una de ellas, `pack-command` proporciona una sintaxis determinada:

1. Como argumentos de línea de órdenes.

   Ejemplo (tar):

       pack-command=tar cf -

   Ejemplo (zip):

       pack-command=zip -r - %f

   en este caso, los nombres de archivo se pasan en la línea de órdenes, justo como usted lo haría al utilizar la orden en la consola, &kleopatra; no utiliza una «shell» para ejecutar la orden. Más aún, esto es un modo seguro de pasar nombres de archivo, pero puede conducir a restricciones en la longitud de nombres de archivo en la línea de órdenes en algunas plataformas. Si está presente un literal `%f`, se remplaza por los nombres de los archivos a archivar. De otro modo, los nombres de archivo se añaden a la línea de órdenes. Así, el archivo zip del ejemplo de arriba puede escribirse de forma equivalente como:

       pack-command=zip -r -

2. Vía entrada estándar, separada por saltos de línea: anteponer `|`.

   Ejemplo (&GNU;-tar):

       pack-command=|gtar cf - -T-

   Ejemplo (ZIP):

       pack-command=|zip -@ -

   En este caso, los nombres de archivo se pasan al archivador en stdin, uno por línea. Esto evita problemas en las plataformas que sitúan un límite bajo al número de argumentos de línea de órdenes que se permiten, pero falla cuándo los nombres de archivo contienen, de hecho, saltos de línea.

   &kleopatra; solo admite actualmente LF como separador de líneas, no CRLF. Esto podría cambiar en versiones futuras, en función de los comentarios y sugerencias de los usuarios.

3. Vía entrada estándar, separado por bytes NUL: prefijo `0|`.

   Ejemplo (&GNU;-tar):

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

   Esto es lo mismo que lo de arriba, excepto que los bytes nulos se emplean para separar nombres de archivo. Dado que los bytes NUL están prohibidos en nombres de archivo, esto es el modo más robusto de pasar nombres de archivo, pero no lo admiten todos los archivadores.

### Configuración de programas de suma de verificación para su uso con crear/verificar sumas de verificación

&kleopatra; permite al administrador (y al usuario avanzado) configurar la lista de programas de suma de verificación que el usuario puede elegir en el diálogo de configuración y que &kleopatra; puede autodetectar cuando se le pide verificar la suma de verificación de un archivo dado.

Para que se pueda usar con &kleopatra;, la salida de un programa de suma de verificación (tanto el archivo de suma de verificación escrito como la salida en stdout cuando se verifican sumas de verificación) necesita ser compatible con &GNU; `md5sum` y `sha1sum`.

Específicamente los archivos de suma de verificación deben estar basados en líneas, cada línea con el siguiente formato:

    SUMA-DE-VERIFICACIÓN ' ' ( ' ' | '*' ) NOMBRE-DE-ARCHIVO

donde `SUMA-DE-VERIFICACIÓN` consta solo de caracteres hexadecimales. Si `-ARCHIVO` contiene un carácter de salto de línea, la línea debe leerse en su lugar:

    \SUMA-DE-VERIFICACIÓN ' ' ( ' ' | '*' ) NOMBRE-DE-ARCHIVO-CON-ESCAPE

donde `NOMBRE-DE-ARCHIVO-CON-ESCAPE` es el nombre de archivo con salto de línea remplazados por `\n`, y barras inversas dobladas (`\`↦`\\`).

De forma similar, la salida de checksum-definition-verify-command debe ser de la forma

    NOMBRE-DE-ARCHIVO ( ': OK' | ': FAILED' )

separado por saltos de línea. Saltos de línea y otros caracteres no se escapan en la salida.

Sí, esos programas no se escribieron pensando en interfaces gráficas y &kleopatra; fallará al analizar correctamente nombres de archivos patológicos que contengan «: OK» seguido de salto de línea.

Cada programa de suma de verificación se define en `libkleopatrarc` como un grupo separado `Checksum Definition #`n``, con las siguientes claves obligatorias:

`file-patterns`

- Una lista de expresiones regulares que describen que archivos deben considerase como archivos de suma de verificación para este programa de suma de verificación. La sintaxis es la utilizada para lista de cadenas en los archivos de configuración de &kde;.

  Dado que las expresiones regulares contienen, generalmente, barras inversas, se debe tener cuidado para escaparlas adecuadamente en el archivo de configuración. Se recomienda la utilización de una herramienta de edición de archivos de configuración.

  La plataforma define si los patrones son tratados como sensibles a mayúsculas o no.

`output-file`

- El típico nombre de archivo para este programa de suma de verificación (debe coincidir con uno de los checksum-definition-file-patterns, por supuesto). Esto es lo que &kleopatra; utilizará como nombre de archivo de salida cuando se creen archivos de suma de verificación de este tipo.

`id`

- Un ID único empleado para identificar este programa de suma de verificación internamente. En caso de duda, utilice el nombre de la orden.

`Nombre` (traducido)

- El nombre visible para el usuario de este programa de suma de verificación, como se muestra en el correspondiente menú desplegable del diálogo de configuración de &kleopatra;.

`create-command`

- La orden real con la que crear archivos de suma de verificación. Las restricciones de sintaxis y opciones de paso de argumentos son las mismas que las descritas para archive-definition-pack-command in admin-archive-definitions.

`verify-command`

- Lo mismo que checksum-definition-create-command, pero para verificación de sumas de verificación.

Aquí está un ejemplo 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

## Créditos y licencia

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

Derechos de autor de la documentación 2002 &Steffen.Hansen;, copyright 2004 &Daniel.Molkentin;, copyright 2004, 2010 Klarälvdalens Datakonsult AB

## Colaboradores

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

Traducido por Juan Manuel García Molina juanma@superiodico.net, Franco Mariluis fmariluis@gmail.com y Javier Viñal fjvinal@gmail.com.

&underFDL; &underGPL;
&documentation.index;