El manual de Kleopatra

# El manual de Kleopatra

Marc Mutz `<marc@kdab.net>`

Desarrollador: David Faure
Desarrollador: Steffen Hansen
Desarrollador: Matthias Kalle Dalheimer
Desarrollador: Jesper Pedersen
Desarrollador: Daniel Molkentin
Traductor: Juan Manuel García Molina
Traductor: Franco Mariluis
Traductor: Javier Viñal
revisión 2.1.1 (KDE
4.11) (2013-07-04)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Kleopatra es una herramienta para gestionar certificadosX.509 y OpenPGP.

Lista de tablas

5.1. Asociación de tipos de GpgConf a controles de la GUI
6.1. Configuración de filtro de claves Definir las propiedades de visualización
6.2. Configuración de filtros de claves Definir claves Criterios de filtrado

Lista de ejemplos

6.1. Ejemplos de filtros de claves

Capítulo 1. Introducción
Introducción

# Capítulo 1. Introducción

Kleopatra es la herramienta de KDE para gestionar certificados X.509 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 certificadosde KMail, así como desde la línea de órdenes. El ejecutable de Kleopatrase llama `kleopatra`.

### Nota

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.

Capítulo 2. Funciones principales
Funciones principales

# Capítulo 2. 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 CApueden 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), por ejemplo 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 Ver → Lista jerárquica de certificados.

Usted puede ver los detalles de cualquier certificado haciendo doble clic o usando Ver → Detalles del certificado. Se abrirá un diálogo que mostrará las propiedades más frecuentes del certificado, su cadena de certificado (es decir, 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 (por ejemplo usando la interfaz de línea de órdenes de GpgSM), usted puede refrescar la vista con Ver → Volver a mostrar (F5) .

Buscar e importar certificados
Buscar e importar certificados

## 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 (por ejemplo 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, pruebe Archivo → Importar certificados... (Ctrl+I) . 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 Archivo → Importar certificados... (Ctrl+I) , justo como usted haría para certificados “normales”.

Crear un nuevo par de claves
Crear un nuevo par de claves

## Crear un nuevo par de claves

La opción de menú Archivo → Nuevo certificado... (Ctrl+N) 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 X.509 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.

Capítulo 3. Referencia de menús
Referencia de menús

# Capítulo 3. Referencia de menús

## Menú archivo

Archivo → Nuevo certificado... (Ctrl+N)

  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 Archivo → Importar certificados... (Ctrl+I) .

File → Consultar certificados en el servidor... (Ctrl+Mayúsculas+I)

  Busca e importa certificados desde servidores de certificados, en al almacén local de certificados. Consulte “Buscar e importar certificados” para más detalles.

  Usted necesita disponer de servidores de claves para esta tarea. Consulte “Configuración de servicios de directorio” para más detalles.

Archivo → Importar certificados... (Ctrl+I)

  Importa certificados o claves secretas desde archivos en el almacén de claves local. Consulte “Buscar e importar certificados” 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.

Archivo → Exportar certificados... (Ctrl+E)

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

  - Para certificados S/MIME, `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.

  ### Nota

  Esta función solo exporta las claves públicas, incluso si la clave secreta esté disponible. Use Archivo → Exportar clave secreta... 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 S/MIME, 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.

  ### Aviso

  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.

Archivo → Exportar certificados al servidor... (Ctrl+Mayúsculas+E)

  Publica los certificados en un servidor de claves (solo OpenPGP).

  Se envía el certificado al servidor de certificados configurado para OpenPGP (cf. “Configuración de servicios de directorio”), 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 S/MIME).

  ### Nota

  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.

  ### Nota

  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.

Archivo → Cerrar (Ctrl+W)

  Cierra la ventana principal de Kleopatra. Usted puede restaurarla en cualquier momento desde el icono de la bandeja del sistema.

Archivo → Salir (Ctrl+Q)

  Hace que termine Kleopatra.

Menú ver
Menú ver

## Menú ver

Ver → Volver a mostrar (F5)

  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.

Ver → Detener operación (Esc)

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

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

  ### Nota

  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, es decir 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.

  ### Nota

  La vista jerárquica está actualmente implementada solo para certificados S/MIME. Existe un desacuerdo entre los desarrolladores respecto al modo correcto de mostrar los certificados OpenPGP jerárquicamente (básicamente “padre = firmante” o “padre = firmado”).

Ver → Expandir todo (Ctrl+.)

  Expande todos los elementos en la vista de lista de certificados, es decir, 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 Ver → Lista jerárquica de certificados.

Ver → Colapsar todo (Ctrl+,)

  Contrae todos los elementos de la lista en la vista de lista de certificados, es decir 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 Ver → Lista jerárquica de certificados.

Menú certificados
Menú certificados

## 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 (S/MIME) certificado raíz como de confianza.

  En algún modo, esto es el equivalente de Certificados → Cambiar confianza del propietario... para certificados raíces S/MIME. Usted puede, sin embargo, elegir solo entre—en función de OpenPGP los términos—“extrema” confianza y “nunca confiar”.

  ### Nota

  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 Capítulo 5, Configurando Kleopatra).

  La activación de esta funcionalidad en el motor puede llevar a ventanas emergentes de PinEntry en momentos inoportunos (por ejemplo 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.

  ### Aviso

  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 S/MIME y ese certificado no es todavía de confianza.

  Utilice Certificados → Desconfiar de certificado raíz para deshacer esta función.

Certificados → Desconfiar de certificado raíz

  Marca este certificado (S/MIME) como no confiable.

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

  Utilizado para deshacer Certificados → Certificado raíz de confianza . 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.

  ### Nota

  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.

  ### Nota

  Esos parámetros están sujetos a las mismas restricciones de administración que los nuevos certificados. Consulte “Crear un nuevo par de claves” y “Personalización del asistente de creación de certificados” 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.

Certificados → Borrar (Suprimir)

  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ónVer → Lista jerárquica de certificados para volver a tomar control sobre el lote de certificados.

  ### Aviso

  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 S/MIME, si usted borra un certificado de emisor S/MIME (certificado CA) se borran también todos los asuntos.[1]

  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 (S/MIME) seleccionado.

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

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

Menú herramientas
Menú herramientas

## Menú herramientas

Herramientas → Visor del registro de GnuPG...

  Inicia GnuPG Log Viewer, 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 herramientas → Refrescar certificados X.509 para más detalles.

herramientas → Refrescar certificados X.509

  Refresca certificados S/MIME 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 S/MIME.

  ### Nota

  Refrescar certificados X.509 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 CRLse manejan de modo transparente por el motor, puro algunas veces puede ser útil importar manualmente una CRL de la caché local de CRL.

  ### Nota

  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 herramientas → Refrescar certificados X.509 en su lugar.

Herramientas → Volcar caché de CRL

  Muestra los contenidos detallados de la caché de CRL de GpgSM.

Menú preferencias
Menú preferencias

## 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
Menú ventana

## 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 botón derecho del ratón en una pestaña se abre un menú de contexto, donde usted puede seleccionar varias acciones.

Menú ayuda
Menú ayuda

## Menú ayuda

Kleopatra tiene un menú predeterminado de KDE Ayuda descrito en los Fundamentos de KDE.

Capítulo 4. Referencia de las opciones de la línea de órdenes
Referencia de las opciones de la línea de órdenes

# Capítulo 4. 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 (X.509, 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 Archivo → Importar certificados... (Ctrl+I) .

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

Capítulo 5. Configurando Kleopatra
Configurando Kleopatra

# Capítulo 5. 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 S/MIME y que servidores de claves utilizar para búsquedas de certificados OpenPGP.

### Nota

Este es una versión simple y más amigable con el usuario de las mismas preferencias que usted puede encontrar también en “Configuración del sistema GnuPG”. 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 “Configuración de aspectos de validación S/MIME”, 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 S/MIME 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, por ejemplo `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 Esquema, 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 Esquema a `http` y Puerto del servidor a `80` (el predeterminado para HTTP), entonces tómelo de ahí.

DN base

  El DN-base (solo para LDAP y LDAPS), es decir 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 X.509 (S/MIME).

  Solo los servidores LDAP (y LDAPS) se admiten para S/MIME.

OpenPGP

  Marque esta columna si esta entrada debe utilizarse para búsquedas de certificados OpenPGP.

Usted puede configurar tantos servidores S/MIME (X.509) 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 Nombre del servidor, Puerto del servidor, DN base y el habitual Contraseña y Nombre de usuario, los cuales solo se necesitan si el servidor necesita autenticación.

Para insertar directamente una entrada para certificados X.509 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, es decir 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.

### Nota

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
Configuración de apariencia

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

### Nota

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 Mostrar validez).

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 S/MIME), 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 S/MIME), 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 S/MIME:

      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 S/MIME), 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 “Crear y editar categorías de claves” en Capítulo 6, Guía del administrador.

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 (es decir 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.

### Nota

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 DNs son jerárquicos, el orden de los componentes individuales (llamados DNs relativos (RDN), o atributos DNs) 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.

### Nota

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 (por ejemplo 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
Configuración de operaciones de cifrado

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

### Nota

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 “Configuración de programas de suma de verificación para su uso con crear/verificar sumas de verificación” en Capítulo 6, Guía del administrador para más detalles.

Configuración de aspectos de validación S/MIME
Configuración de aspectos de validación S/MIME

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

En esta página, usted puede configurar ciertos aspectos de la validación de certificados S/MIME.

### Nota

En su mayor parte, esto es sencillamente una versión más amigable de las mismas preferencias que usted encontrará en “Configuración del sistema GnuPG”. Todo lo que usted configure aquí, lo puede configurar allí también, con la excepción de Comprobar la validez del certificado cada `N` horas, 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 Ver → Volver a mostrar (F5) ; no hay ninguna disposición para planificación de intervalos de Herramientas → Refrescar certificados OpenPGP o herramientas → Refrescar certificados X.509 .

  ### Nota

  La validación se ejecuta implícitamente cuando cambian archivos significativos en `~/.gnupg`. Esta opción, al igual que Herramientas → Refrescar certificados OpenPGP y herramientas → Refrescar certificados X.509 , 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 S/MIME se validarán usando Listas de Revocación de Certificados (CRL).

  Consulte Validar certificados en línea (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 S/MIME se validan con conexión usando el protocolo de estado de certificados en línea (OCSP).

  ### Aviso

  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 (por ejemplo) correos.

  Para usar este método usted necesita introducir la URL de respuesta del OCSP en URL de respuesta del OCSP.

  Consulte Validar certificados en línea (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 S/MIME contiene, generalmente la URL de sus respuestas OCSP del emisor ( Certificados → Volcar certificado 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 por ejemplo 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 S/MIME.

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.

  ### Nota

  La activación de esta funcionalidad en el motor puede llevar a ventanas emergentes de PinEntry en momentos inoportunos (por ejemplo 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 Certificados → Certificado raíz de confianza y Certificados → Desconfiar de certificado raíz .

  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 S/MIME.

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 URLs 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``, por ejemplo `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 S/MIME.

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
Configuración del sistema GnuPG

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

### Nota

Las opciones más útiles se han duplicado en páginas separadas en el diálogo de configuración de Kleopatra. Consulte “Configuración de servicios de directorio” y “Configuración de aspectos de validación S/MIME” 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:

Tabla 5.1. 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` | N/A | Editor de línea
`int32` | Editor de línea (sin formato) | Cuadro de número
`uint32`
`nombre de ruta` | N/A | control especializado
`servidor ldap` | control especializado | N/A
`huella dactilar de clave` | N/A
`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.

Capítulo 6. Guía del administrador
Guía del administrador

# Capítulo 6. 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).

### Sugerencia

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
Crear y editar categorías de claves

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

Tabla 6.1, “Configuración de filtro de claves Definir las propiedades de visualización” lista todas las claves que definen las propiedades de visualización de claves que pertenecen a esa categoría (es decir las claves que se pueden ajustar en el diálogo de configuración), mientras que Tabla 6.2, “Configuración de filtros de claves Definir claves Criterios de filtrado” lista todas las claves que definen los criterios con los que el filtro empareja las claves.

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

Tabla 6.2. 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[a] | 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 S/MIME.
`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 (por ejemplo, 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 S/MIME (`false` - n.t. falso).
`was-validated` | boolean (n.t. booleano) | la clave ha sido validada.

``prefix`-ownertrust`

validity (validez)[b]

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.

[a] Contexto es una enumeración con los siguientes valores posibles: `apariencia`, `filtrado` y `cualquiera`.

[b] 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.

### Nota

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, por ejemplo 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”, es decir 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 (es decir 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, es decir 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.

Ejemplo 6.1. 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
Configurar archivadores para utilizar con archivos de firmado/cifrado

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

### Nota

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.

   ### Nota

   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
Configuración de programas de suma de verificación para su uso con crear/verificar sumas de verificación

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

### Nota

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 `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.[2]

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.

  ### Nota

  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 `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 `pack-command` in “Configurar archivadores para utilizar con archivos de firmado/cifrado”.

`verify-command`

  Lo mismo que `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

[2] 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.

Capítulo 7. Créditos y licencia
Créditos y licencia

# Capítulo 7. 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 `(mutz AT kde.org)`

- David Faure `(faure AT kde.org)`

- Steffen Hansen `(hansen AT kde.org)`

- Matthias Kalle Dalheimer `(kalle AT kde.org)`

- Jesper Pedersen `(blackie AT kde.org)`

- Daniel Molkentin `(molkentin AT kde.org)`

Traducido por Juan Manuel García Molina `(juanma AT superiodico.net)` y Javier Viñal `(fjvinal AT gmail.com)`

Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.

Este programa está sujeto a los términos de la Licencia Pública General GNU.