Faq autofirma execution - ctt-gob-es/clienteafirma GitHub Wiki

Problemas de ejecución

General

No se abre Autofirma al ejecutar firmas desde el navegador

Si Autofirma no se arranca cuando se inicia una operación de firma desde el navegador web o si se muestra su imagen splash pero luego no se ejecuta la operación, es posible que el problema sea que su navegador web no se pueda comunicar correctamente con Autofirma.

Autofirma y el navegador web se comunican mediante un websocket abierto por la aplicación y cifrado con un certificado electrónico. Si este certificado electrónico no se encuentra en la lista de certificados de confianza de la aplicación, el navegador no podrá establecer la conexión y enviar la orden de firma a Autofirma. Para solventar este problema, verifique primeramente que Autofirma se encuentra instalado en el equipo. En caso de estarlo, abra la aplicación y ejecute la función restauración de la instalación (Menú “Herramientas” -> “Restaurar la instalación”).

En caso de que falle la restauración de la conexión, puede instalar manualmente los certificados de confianza del usuario. Para ello, primeramente localice el fichero "Autofirma_ROOT.cer" en su sistema e instálelo en el almacén de confianza que utilice su navegador.

Windows

Busque el fichero "Autofirma_ROOT.cer" en el directorio:

  • C:\ProgramData\Autofirma

Si no se encontrase en el directorio anterior, búsquelo en el directorio de instalación de Autofirma. Por defecto:

  • C:\Program Files\Autofirma (En equipos de 64 bits)
  • C:\Program Files (x86)\Autofirma (En equipos de 32 bits)

Para instalarlo en el almacén de Windows:

  1. Haremos doble clic sobre el fichero "Autofirma_ROOT.cer".

  2. Pulsaremos el botón “Instalar certificado…” del diálogo con la información del certificado.

  1. Pulsaremos el botón “Siguiente”.

  1. Seleccionaremos la opción “Colocar todos los certificados en el siguiente almacén” y pulsaremos el botón “Examinar…”.

  1. Seleccionaremos el almacén “Entidades de certificación raíz de confianza” y pulsaremos “Aceptar”.

  1. Pulsaremos el botón “Siguiente” una vez hemos seleccionado el almacén al que importar el certifciado.

  2. Pulsaremos el botón “Finalizar” de la nueva ventana.

  1. Finalmente, se nos mostrará el resultado de importar el certificado.

Para instalarlo en el almacén de Firefox (aunque puede variar según la versión):

  1. Accedemos a la opción de "Ajustes" desde el menú del navegador.

  1. Accedemos al apartado "Privacidad & Seguridad" del panel de la izquierda.

  1. Nos desplazamos a la sección Seguridad y pulsamos el botón "Ver certificados" del bloque "Certificados".

  1. Accedemos a la pestaña "Autoridades" y pulsamos el botón "Importar".

  1. Seleccionamos el fichero "Autofirma_ROOT.cer" y pulsamos el botón "Abrir".

  1. Marcamos la opción "Confiar en esta CA para identificar sitios web" y pulsamos el botón "Aceptar".

Linux

Busque el fichero "Autofirma_ROOT.cer" en el directorio:

  • $HOME/.afirma/AutoFirma

Si no se encontrase en el directorio anterior, búsquelo en el directorio de instalación de Autofirma. Por defecto:

  • /usr/lib/AutoFirma/

Para instalarlo en el almacén de Firefox, el proceso es análogo al usado en Windows. Siga las instrucciones anteriormente listadas.

Para instalar el certificado en Chrome, el proceso es el siguiente:

  1. Accedemos a la opción de "Ajustes" ("Settings") desde el menú del navegador.

  1. Accedemos al apartado "Privacidad y Seguridad" ("Privacy and security") del panel de la izquierda.

  1. Nos desplazamos a la sección "Administrar certificados" ("Manage certificates").

  1. Accedemos al listado de certificados instalados por nosotros ("Installed by you").

  1. Pulsamos el botón "Importar" ("Import") de la sección "Certificados de confianza" ("Trusted certificates").

  1. Seleccionamos el fichero "Autofirma_ROOT.cer" y pulsamos "Aceptar".

macOS

Busque los ficheros "Autofirma_ROOT.cer" y "autofirma.cer" en el directorio:

  • $HOME/Library/Application Support/AutoFirma

Para instalarlos en el almacén del sistema:

  1. Hacemos doble clic sobre el fichero "Autofirma_ROOT.cer" e inserte su contraseña para permitir la importación en el llavero del sistema.

  2. Abra el menú contextual del certificado "Autofirma ROOT" en el listado y pulse en la opción "Obtener información".

  1. Modifique el valor del listado "Al utilizar este certificado" y seleccione la opción "Confiar siempre".

  1. Cierre la ventana y autorice la operación insertando su contraseña de usuario cuando se le pida.

  2. Repita los pasos del 1 al 4 con el fichero "autofirma.cer", que importará el certificado "127.0.0.1".

  3. Cierre el diálogo y autorice la operación insertando su contraseña si se le requiere.

Para instalarlo en el almacén de Firefox, el proceso es análogo al usado en Windows. Siga las instrucciones anteriormente listadas.

Error al importar las opciones de configuración desde un fichero

Si generase un fichero de configuración para la importación de las opciones de configuración en Autofirma y al importarlo se mostrase el mensaje de error “El fichero de preferencias es inválido, no se realizará ningún cambio en la configuración”, es probable que el fichero utilizado no sea un XML válido o que tenga algún problema de codificación. Verifique que su fichero de configuración está bien formado y que la codificación utilizada es correcta.

Windows

No se muestran certificados de curva elíptica del almacén de Windows

Algunas versiones antiguas de Java 8 y las primeras versiones de Java 11 no permitirán cargar certificados de curva elíptica del almacén de Windows. Si no se le muestran sus certificados en el almacén compruebe:

  • Que se está ejecutando java 21 o superior o, al menos una versión reciente de Java 8 u 11. Puede consultar esto desde el panel “Acerca de” de Autofirma.
  • Que su certificado no está caducado.
  • Que en el listado de certificado de Windows aparece que su certificado tiene asociado una clave privada. Si su certificado aparece al usar directamente Autofirma, pero no al cargarlo desde un trámite web, es probable que el trámite esté limitando qué tipo de certificados pueden usarse para firmar el trámite y que su certificado no se encuentre entre los permitidos.

Linux

No se abre la interfaz gráfica de Autofirma

Muchas distribuciones de Linux incluyen por defecto una versión headless de la JRE. Estas versiones no soportan interfaces gráficas, por lo que la interfaz gráfica de Autofirma no se podrá abrir (aunque sí podrá realizar operaciones por consola). Si al intenta abrir Autofirma desde el lanzador de aplicaciones de su sistema o si al ejecutarlo por consola sin parámetros se muestra la advertencia “No se puede crear el entorno grafico. Se tratar la peticion como una llamada por consola”, es muy probable que se vea afectado por este problema. Para solventar este problema instale una versión completa JRE como la de OpenJDK, configúrela para ejecutarla como versión de Java por defecto (al usar el comando java desde la consola) y reinstale Autofirma.

No se abre la ayuda de Autofirma

En determinados entornos puede ocurrir que al visualizar la ayuda de la interfaz gráfica de Autofirma se abra el navegador Firefox e indique que no se encuentra o que no se puede abrir la página. El problema se debe a la versión de Firefox utilizada, que no permite abrir páginas web en disco. Se sabe, por ejemplo, que esto ocurre con la versión de Firefox incluida por defecto en algunas versiones de Ubuntu (confirmado en Ubuntu 22.04). Puede ver la ayuda de Autofirma abriendo desde otro navegador la misma página que se intenta abrir, cambiando su navegador por defecto por otro o sustituyendo la versión preinstalada de Firefox por la versión oficial.

macOS

Se pide la contraseña del sistema por duplicado para firmar

El comportamiento es correcto. A partir de macOS Sequoia 15.3.2, el sistema operativo requiere que el usuario inserte su contraseña dos veces, una para acceder al certificado y otra para usar su clave de firma.

No muestra el título de los diálogos de cargar y guardado de ficheros en macOS

Las nuevas versiones de macOS omiten el título de los diálogos de carga y guardado de ficheros. En caso en que el integrador delegue en Autofirma la selección y el guardado de las firmas generadas, debería tener la precaución de informar al usuario de esto para que en todo momento sepa qué operación está realizando (carga de un fichero de datos para firma, carga de un fichero de firma para cofirma/contrafirma, guardado de una firma generada…).

⚠️ **GitHub.com Fallback** ⚠️