Si Autofirma no s'arrenca quan s'inicia una operació de signatura des del navegador web o si es mostra la seva imatge splash però després no s'executa l'operació, és possible que el problema sigui que el seu navegador web no es pugui 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 aquest 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 aquest problema, verifiqui primerament que Autofirma es troba instal·lat en l'equip. En cas d'estar-ho, obri l'aplicació i executi la funció restauració de la instal·lació (Menú “Eines” -> “Restaurar la instal·lació”).

En cas que falli la restauració de la connexió, pot instal·lar manualment els certificats de confiança de l'usuari. Per a això, primerament localitzi el fitxer "Autofirma_ROOT.cer" en el seu sistema i instal·li'l en el magatzem de confiança que utilitzi el seu navegador.

Windows

Busqui el fitxer "Autofirma_ROOT.cer" en el directori:

• C:\ProgramData\Autofirma

Si no es trobés en el directori anterior, busqui'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:

1. Farem doble clic sobre el fitxer "Autofirma_ROOT.cer".

2. Premerem el botó “Instal·lar certificat…” del diàleg amb la informació del certificat.

3. Premerem el botó “Següent”.

4. Seleccionarem l'opció “Col·locar tots els certificats en el següent magatzem” i premerem el botó “Examinar…”.

5. Seleccionarem el magatzem “Entitats de certificació arrel de confiança” i premerem “Acceptar”.

6. Premerem el botó “Següent” una vegada hem seleccionat el magatzem al qual importar el certifciado.

7. Premerem el botó “Finalitzar” de la nova finestra.

8. 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ó):

1. Accedim a l'opció de "Ajustos" des del menú del navegador.

2. Accedim a l'apartat "Privacitat & Seguretat" del panell de l'esquerra.

3. Ens desplacem a la secció Seguretat i premem el botó "Veure certificats" del bloc "Certificats".

4. Accedim a la pestanya "Autoritats" i premem el botó "Importar".

5. Seleccionem el fitxer "Autofirma_ROOT.cer" i premem el botó "Obrir".

6. Marquem l'opció "Confiar en aquesta CA per a identificar llocs web" i premem el botó "Acceptar".

Linux

Busqui el fitxer "Autofirma_ROOT.cer" en el directori:

• $HOME/.afirma/AutoFirma

Si no es trobés en el directori anterior, busqui'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. Segueixi les instruccions anteriorment llistades.

Per a instal·lar el certificat en Chrome, el procés és el següent:

1. Accedim a l'opció de "Ajustos" ("Settings") des del menú del navegador.

2. Accedim a l'apartat "Privacitat i Seguretat" ("Privacy and security") del panell de l'esquerra.

3. Ens desplacem a la secció "Administrar certificats" ("Manage certificates").

4. Accedim al llistat de certificats instal·lats per nosaltres ("Installed by you").

5. Premem el botó "Importar" ("Import") de la secció "Certificats de confiança" ("Trusted certificates").

6. Seleccionem el fitxer "Autofirma_ROOT.cer" i premem "Acceptar".

macOS

Busqui 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:

1. Fem doble clic sobre el fitxer "Autofirma_ROOT.cer" i insereixi la seva contrasenya per a permetre la importació en el clauer del sistema.

2. Obri el menú contextual del certificat "Autofirma ROOT" en el llistat i premi en l'opció "Obtenir informació".

3. Modifiqui el valor del llistat "En utilitzar aquest certificat" i seleccioni l'opció "Confiar sempre".

4. Tancament la finestra i autoritzi l'operació inserint la seva contrasenya d'usuari quan se li demani.

5. Repeteixi els passos de l'1 al 4 amb el fitxer "autofirma.cer", que importarà el certificat "127.0.0.1".

6. Tancament el diàleg i autoritzi l'operació inserint la seva 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. Segueixi les instruccions anteriorment llistades.

Si generés un fitxer de configuració per a la importació de les opcions de configuració en Autofirma i en importar-lo es mostrés 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 sigui un XML vàlid o que tingui algun problema de codificació. Verifiqui 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 comprovi:

• 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 estigui limitant quin tipus de certificats poden usar-se per a signar el tràmit i que el seu certificat no es trobi entre els permesos.

Moltes distribucions de Linux inclouen per defecte una versió headless de la JRE. Aquestes 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 vegi afectat per aquest problema. Per a solucionar aquest problema instal·li una versió completa JRE com la d'OpenJDK, configuri-la per a executar-la com a versió de Java per defecte (en usar el comando java des de la consola) i reinstal·li Autofirma.

En determinats entorns pot ocórrer que en visualitzar l'ajuda de la interfície gràfica d'Autofirma s'obri el navegador Firefox i indiqui 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 insereixi la seva contrasenya dues vegades, una per a accedir al certificat i una altra per a usar la seva 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 delegui en Autofirma la selecció i el guardat de les signatures generades, hauria de tenir la precaució d'informar de l'usuari d'això perquè en tot moment sàpiga quina operació està realitzant (càrrega d'un fitxer de dades per a signatura, càrrega d'un fitxer de signatura per a cosignatura/contrasigna, guardat d'una signatura generada…).