Faq autofirma execution gl ES - ctt-gob-es/clienteafirma GitHub Wiki
Se Autofirma non se arrinca cando se inicia unha operación de sinatura desde o navegador web ou se se mostra a súa imaxe splash pero logo non se executa a operación, é posible que o problema sexa que o seu navegador web non se poida comunicar correctamente con Autofirma.
Autofirma e o navegador web comunícanse mediante un websocket aberto pola aplicación e cifrado cun certificado electrónico. Se este certificado electrónico non se atopa na lista de certificados de confianza da aplicación, o navegador non poderá establecer a conexión e enviar a orde de firma a Autofirma. Para liquidar este problema, verifique primeiramente que Autofirma atópase instalado no equipo. En caso de estar, abra a aplicación e execute a función restauración da instalación (Menú “Ferramentas
” -> “Restaurar a instalación
”).
No caso de que falle a restauración da conexión, pode instalar manualmente os certificados de confianza do usuario. Para iso, primeiramente localice o ficheiro "Autofirma_ROOT.cer
" no seu sistema e instáleo no almacén de confianza que utilice o seu navegador.
Windows
Busque o ficheiro "Autofirma_ROOT.cer
" no directorio:
- C:\ProgramData\Autofirma
Se non se atopase no directorio anterior, búsqueo no 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 instalar no almacén de Windows:
-
Faremos dobre clic sobre o ficheiro "
Autofirma_ROOT.cer
". -
Pulsaremos o botón “Instalar certificado…” do diálogo coa información do certificado.
- Pulsaremos o botón “Seguinte”.
- Seleccionaremos a opción “Colocar todos os certificados no seguinte almacén” e pulsaremos o botón “Examinar…”.
- Seleccionaremos o almacén “Entidades de certificación raíz de confianza” e pulsaremos “Aceptar”.
-
Pulsaremos o botón “Seguinte” unha vez seleccionamos o almacén ao que importar o certifciado.
-
Pulsaremos o botón “Finalizar” da nova xanela.
- Finalmente, mostrarásenos o resultado de importar o certificado.
Para instalar no almacén de Firefox (aínda que pode variar segundo a versión):
- Accedemos á opción de "
Axustes
" desde o menú do navegador.
- Accedemos á apartado "
Privacidade & Seguridade
" do panel da esquerda.
- Desprazámonos á sección Seguridade e pulsamos o botón "
Ver certificados
" do bloque "Certificados
".
- Accedemos á pestana "
Autoridades
" e pulsamos o botón "Importar
".
- Seleccionamos o ficheiro "
Autofirma_ROOT.cer
" e pulsamos o botón "Abrir
".
- Marcamos a opción "
Confiar neste CA para identificar sitios web
" e pulsamos o botón "Aceptar
".
Linux
Busque o ficheiro "Autofirma_ROOT.cer
" no directorio:
- $HOME/.afirma/AutoFirma
Se non se atopase no directorio anterior, búsqueo no directorio de instalación de Autofirma. Por defecto:
- /usr/lib/AutoFirma/
Para instalar no almacén de Firefox, o proceso é análogo ao usado en Windows. Siga as instrucións anteriormente listadas.
Para instalar o certificado en Chrome, o proceso é o seguinte:
- Accedemos á opción de "
Axustes
" ("Settings
") desde o menú do navegador.
- Accedemos á apartado "
Privacidade e Seguridade
" ("Privacy and security
") do panel da esquerda.
- Desprazámonos á sección "
Administrar certificados
" ("Manage certificates
").
- Accedemos á listaxe de certificados instalados por nós ("
Installed by you
").
- Pulsamos o botón "
Importar
" ("Import
") da sección "Certificados de confianza
" ("Trusted certificates
").
- Seleccionamos o ficheiro "Autofirma_ROOT.cer" e pulsamos "
Aceptar
".
macOS
Busque os ficheiros "Autofirma_ROOT.cer
" e "autofirma.cer
" no directorio:
- $HOME/Library/Application Support/AutoFirma
Para instalalos no almacén do sistema:
-
Facemos dobre clic sobre o ficheiro "
Autofirma_ROOT.cer
" e insira o seu contrasinal para permitir a importación no llavero do sistema. -
Abra o menú contextual do certificado "Autofirma ROOT" na listaxe e pulse na opción "Obter información".
- Modifique o valor da listaxe "Ao utilizar este certificado" e seleccione a opción "Confiar sempre".
-
Peche a xanela e autorice a operación inserindo o seu contrasinal de usuario cando se lle pida.
-
Repita os pasos do 1 ao 4 co ficheiro "
autofirma.cer
", que importará o certificado "127.0.0.1
". -
Peche o diálogo e autorice a operación inserindo o seu contrasinal se se lle require.
Para instalar no almacén de Firefox, o proceso é análogo ao usado en Windows. Siga as instrucións anteriormente listadas.
Se xerase un ficheiro de configuración para a importación das opcións de configuración en Autofirma e ao importalo mostrásese a mensaxe de erro “O ficheiro de preferencias é inválido, non se realizará ningún cambio na configuración
”, é probable que o ficheiro utilizado non sexa un XML válido ou que teña algún problema de codificación. Verifique que o seu ficheiro de configuración está ben formado e que a codificación utilizada é correcta.
Algunhas versións antigas de Java 8 e as primeiras versións de Java 11 non permitirán cargar certificados de curva elíptica do almacén de Windows. Se non se lle mostran os seus certificados no almacén comprobe:
- Que se está executando Java 21 ou superior ou, polo menos unha versión recente de Java 8 ou 11. Pode consultar isto desde o panel “
Acerca de
” de Autofirma. - Que o seu certificado non está caducado.
- Que na listaxe de certificado de Windows aparece que o seu certificado ten asociado unha clave privada. Se o seu certificado aparece ao usar directamente Autofirma, pero non ao cargalo desde un trámite web, é probable que o trámite estea a limitar que tipo de certificados poden usarse para asinar o trámite e que o seu certificado non se atope entre os permitidos.
Moitas distribucións de Linux inclúen por defecto unha versión headless do JRE. Estas versións non soportan interfaces gráficas, polo que a interface gráfica de Autofirma non se poderá abrir (aínda que si poderá realizar operacións por consola). Se ao tenta abrir Autofirma desde o lanzador de aplicacións do seu sistema ou se ao executalo por consola sen parámetros móstrase a advertencia “Non se pode crear a contorna grafico. Tratarse a peticion como unha chamada por consola
”, é moi probable que se vexa afectado por este problema.
Para liquidar este problema instale unha versión completa JRE como a de OpenJDK, configúrea para executala como versión de Java por defecto (ao usar o comando java
desde a consola) e reinstale Autofirma.
En determinadas contornas pode ocorrer que ao visualizar a axuda da interface gráfica de Autofirma ábrase o navegador Firefox e indique que non se atopa ou que non se pode abrir a páxina. O problema débese á versión de Firefox utilizada, que non permite abrir páxinas web en disco. Sábese, por exemplo, que isto ocorre coa versión de Firefox incluída por defecto nalgunhas versións de Ubuntu (confirmado en Ubuntu 22.04). Pode ver a axuda de Autofirma abrindo desde outro navegador a mesma páxina que se tenta abrir, cambiando o seu navegador por defecto por outro ou substituíndo a versión preinstalada de Firefox pola versión oficial.
O comportamento é correcto. A partir de macOS Sequoia 15.3.2, o sistema operativo require que o usuario insira o seu contrasinal dúas veces, unha para acceder ao certificado e outra para usar a súa clave de firma.
As novas versións de macOS omiten o título dos diálogos de carga e gardado de ficheiros. En caso en que o integrador delegue en Autofirma a selección e o gardado das firmas xeradas, debería ter a precaución de informar o usuario disto para que en todo momento saiba que operación está a realizar (carga dun ficheiro de datos para firma, carga dun ficheiro de firma para cofirma/contrafirma, gardado dunha firma xerada…).