Faq autofirma execution va ES - ctt-gob-es/clienteafirma GitHub Wiki
Si Autofirma no s'arranca quan s'inicia una operació de signatura des del navegador web o si es mostra la seua imatge splash però després no s'executa l'operació, és possible que el problema siga que el seu navegador web no es puga comunicar correctament amb Autofirma.
Autofirma i el navegador web es comuniquen mitjançant un websocket obert per l'aplicació i xifrat amb un certificat electrònic. Si este certificat electrònic no es troba en la llista de certificats de confiança de l'aplicació, el navegador no podrà establir la connexió i enviar l'ordre de signatura a Autofirma. Per a solucionar este problema, verifique primerament que Autofirma es troba instal·lat en l'equip. En cas d'estar-ho, òbriga l'aplicació i execute la funció restauració de la instal·lació (Menú “Eines
” -> “Restaurar la instal·lació
”).
En cas que falle la restauració de la connexió, pot instal·lar manualment els certificats de confiança de l'usuari. Per a això, primerament localitze el fitxer "Autofirma_ROOT.cer
" en el seu sistema i instal·le'l en el magatzem de confiança que utilitze el seu navegador.
Windows
Busque el fitxer "Autofirma_ROOT.cer
" en el directori:
- C:\ProgramData\Autofirma
Si no es trobara en el directori anterior, busque'l en el directori d'instal·lació d'Autofirma. Per defecte:
- C:\Program Files\Autofirma (En equips de 64 bits)
- C:\Program Files (x86)\Autofirma (En equips de 32 bits)
Per a instal·lar-ho en el magatzem de Windows:
-
Farem doble clic sobre el fitxer "
Autofirma_ROOT.cer
". -
Polsarem el botó “Instal·lar certificat…” del diàleg amb la informació del certificat.
- Polsarem el botó “Següent”.
- Seleccionarem l'opció “Col·locar tots els certificats en el següent magatzem” i polsarem el botó “Examinar…”.
- Seleccionarem el magatzem “Entitats de certificació arrel de confiança” i polsarem “Acceptar”.
-
Polsarem el botó “Següent” una vegada hem seleccionat el magatzem al qual importar el certifciado.
-
Polsarem el botó “Finalitzar” de la nova finestra.
- Finalment, se'ns mostrarà el resultat d'importar el certificat.
Per a instal·lar-ho en el magatzem de Firefox (encara que pot variar segons la versió):
- Accedim a l'opció de "
Ajustos
" des del menú del navegador.
- Accedim a l'apartat "
Privacitat & Seguretat
" del panell de l'esquerra.
- Ens desplacem a la secció Seguretat i polsem el botó "
Veure certificats
" del bloc "Certificats
".
- Accedim a la pestanya "
Autoritats
" i polsem el botó "Importar
".
- Seleccionem el fitxer "
Autofirma_ROOT.cer
" i polsem el botó "Obrir
".
- Marquem l'opció "
Confiar en esta CA per a identificar llocs web
" i polsem el botó "Acceptar
".
Linux
Busque el fitxer "Autofirma_ROOT.cer
" en el directori:
- $HOME/.afirma/AutoFirma
Si no es trobara en el directori anterior, busque'l en el directori d'instal·lació d'Autofirma. Per defecte:
- /usr/lib/AutoFirma/
Per a instal·lar-ho en el magatzem de Firefox, el procés és anàleg a l'usat en Windows. Seguisca les instruccions anteriorment llistades.
Per a instal·lar el certificat en Chrome, el procés és el següent:
- Accedim a l'opció de "
Ajustos
" ("Settings
") des del menú del navegador.
- Accedim a l'apartat "
Privacitat i Seguretat
" ("Privacy and security
") del panell de l'esquerra.
- Ens desplacem a la secció "
Administrar certificats
" ("Manage certificates
").
- Accedim al llistat de certificats instal·lats per nosaltres ("
Installed by you
").
- Polsem el botó "
Importar
" ("Import
") de la secció "Certificats de confiança
" ("Trusted certificates
").
- Seleccionem el fitxer "Autofirma_ROOT.cer" i polsem "
Acceptar
".
macOS
Busque els fitxers "Autofirma_ROOT.cer
" i "autofirma.cer
" en el directori:
- $HOME/Library/Application Support/AutoFirma
Per a instal·lar-los en el magatzem del sistema:
-
Fem doble clic sobre el fitxer "
Autofirma_ROOT.cer
" i inserisca la seua contrasenya per a permetre la importació en el clauer del sistema. -
Òbriga el menú contextual del certificat "Autofirma ROOT" en el llistat i polse en l'opció "Obtindre informació".
- Modifique el valor del llistat "En utilitzar este certificat" i seleccione l'opció "Confiar sempre".
-
Tancament la finestra i autoritze l'operació inserint la seua contrasenya d'usuari quan se li demane.
-
Repetisca els passos de l'1 al 4 amb el fitxer "
autofirma.cer
", que importarà el certificat "127.0.0.1
". -
Tancament el diàleg i autoritze l'operació inserint la seua contrasenya si se li requereix.
Per a instal·lar-ho en el magatzem de Firefox, el procés és anàleg a l'usat en Windows. Seguisca les instruccions anteriorment llistades.
Si generara un fitxer de configuració per a la importació de les opcions de configuració en Autofirma i en importar-lo es mostrara el missatge d'error “El fitxer de preferències és invàlid, no es farà cap canvi en la configuració
”, és probable que el fitxer utilitzat no siga un XML vàlid o que tinga algun problema de codificació. Verifique que el seu fitxer de configuració està ben format i que la codificació utilitzada és correcta.
Algunes versions antigues de Java 8 i les primeres versions de Java 11 no permetran carregar certificats de corba el·líptica del magatzem de Windows. Si no se li mostren els seus certificats en el magatzem comprove:
- Que s'està executant java 21 o superior o, almenys una versió recent de Java 8 o 11. Pot consultar això des del panell “
Sobre
” d'Autofirma. - Que el seu certificat no està caducat.
- Que en el llistat de certificat de Windows apareix que el seu certificat té associat una clau privada. Si el seu certificat apareix en usar directament Autofirma, però no en carregar-lo des d'un tràmit web, és probable que el tràmit estiga limitant quin tipus de certificats poden usar-se per a signar el tràmit i que el seu certificat no es trobe entre els permesos.
Moltes distribucions de Linux inclouen per defecte una versió headless de la JRE. Estes versions no suporten interfícies gràfiques, per la qual cosa la interfície gràfica d'Autofirma no es podrà obrir (encara que sí que podrà realitzar operacions per consola). Si a l'intenta obrir Autofirma des del llançador d'aplicacions del seu sistema o si en executar-lo per consola sense paràmetres es mostra l'advertiment “No es pot crear l'entorn grafico. Es tractar la peticion com una crida per consola
”, és molt probable que es veja afectat per este problema.
Per a solucionar este problema instal·le una versió completa JRE com la d'OpenJDK, configure-la per a executar-la com a versió de Java per defecte (en usar el comando java
des de la consola) i reinstal·le Autofirma.
En determinats entorns pot ocórrer que en visualitzar l'ajuda de la interfície gràfica d'Autofirma s'òbriga el navegador Firefox i indique que no es troba o que no es pot obrir la pàgina. El problema es deu a la versió de Firefox utilitzada, que no permet obrir pàgines web en disc. Se sap, per exemple, que això ocorre amb la versió de Firefox inclosa per defecte en algunes versions d'Ubuntu (confirmat en Ubuntu 22.04). Pot veure l'ajuda d'Autofirma obrint des d'un altre navegador la mateixa pàgina que s'intenta obrir, canviant el seu navegador per defecte per un altre o substituint la versió preinstal·lada de Firefox per la versió oficial.
El comportament és correcte. A partir de macOS Sequoia 15.3.2, el sistema operatiu requereix que l'usuari inserisca la seua contrasenya dues vegades, una per a accedir al certificat i una altra per a usar la seua clau de signatura.
Les noves versions de macOS ometen el títol dels diàlegs de càrrega i guardat de fitxers. En cas en què l'integrador delegue en Autofirma la selecció i el guardat de les signatures generades, hauria de tindre la precaució d'informar de l'usuari d'això perquè en tot moment sàpia quina operació està realitzant (càrrega d'un fitxer de dades per a signatura, càrrega d'un fitxer de signatura per a cosignatura/contrafirma, guardat d'una signatura generada…).