Autofirma no funciona: qué comprobar, en orden
Autofirma no funciona y no sabes por dónde empezar. Tres preguntas que llevan a la causa: si abre a mano, en qué navegador falla y qué mensaje exacto muestra.
Actualizado el
«Autofirma no funciona» es la frase más buscada sobre la aplicación y la menos útil para arreglarla, porque detrás hay al menos seis problemas distintos que no comparten solución. Esta página no intenta resolverlos todos: intenta que en tres preguntas sepas cuál es el tuyo y llegues a la guía que lo trata a fondo. Si tienes prisa y lo único que necesitas es entregar un PDF firmado, salta al final.
Cómo funciona Autofirma (en un párrafo)
Cuando pulsas «Firmar» en una sede, la página no firma nada. Lanza una dirección especial, afirma://…, que el sistema operativo asocia a Autofirma; la aplicación arranca, abre un pequeño servidor en tu propio equipo (127.0.0.1, en un puerto como el 63117), el navegador se conecta a él, Autofirma descarga del servidor intermedio de la sede lo que hay que firmar, busca tu certificado en un almacén (el de Windows, el Llavero de Mac o el de Firefox), firma con su clave privada y devuelve el resultado. Cada eslabón de esa cadena puede romperse, y cada rotura tiene un síntoma distinto. Las tres preguntas siguientes sirven para localizar el eslabón.
Pregunta 1: ¿Autofirma se abre si la lanzas tú?
Busca Autofirma en el menú de aplicaciones (Inicio en Windows, Launchpad o Aplicaciones en Mac, el menú de tu escritorio en Linux) y ábrela sin pasar por ninguna sede.
- No se abre, o se abre y se cierra al instante. El problema es la instalación, no la sede ni el navegador: Java incompleto en Linux, un antivirus que puso en cuarentena parte de la aplicación, una instalación mezclada con otra antigua en Mac. La guía es Autofirma no se abre o se cierra sola. Si macOS muestra «Apple no ha podido verificar…», ve directamente a Autofirma no funciona en Mac.
- Se abre bien. La aplicación funciona; lo que falla es la comunicación con el navegador o con la sede, o el certificado. Sigue con la pregunta 2. Ten en cuenta que abrirla a mano no arregla nada por sí mismo: cuando la sede la llama, arranca su propia instancia con los parámetros del trámite.
Pregunta 2: ¿En qué sistema y con qué navegador falla?
Prueba el mismo trámite en otro navegador antes de nada. Es la comprobación que más información da en menos tiempo.
- Falla en Chrome, Edge o Brave y funciona en Firefox (o al revés): el problema está en cómo ese navegador lanza
afirma://o se conecta al servidor local. Chrome, Edge y Brave comparten motor y comparten fallos: Autofirma no funciona en Chrome, Edge o Brave. Firefox tiene además su propio almacén de certificados y su propia lista de autoridades de confianza: Autofirma no funciona en Firefox. - Falla en todos los navegadores pero la aplicación abre: el servidor local no arranca o algo lo bloquea (antivirus, cortafuegos, certificado raíz que falta). Ese es el terreno del error SAF_45 y, en Mac, de la Solución 5 de la guía de Mac.
- Estás en Windows 11 y la aplicación ni abre ni registra el protocolo: Autofirma no funciona en Windows 11.
- Estás en Mac y acabas de actualizar el sistema: cada versión de macOS rompe algo. Lo llevamos al día en macOS 27 y Autofirma.
- Estás en Linux: casi siempre es Java o el almacén NSS. Si la aplicación no llega a abrirse, Autofirma no se abre en Linux; para instalarla desde cero, Instalar Autofirma en Linux.
- Estás en un móvil o una tableta: Autofirma no existe para Android ni iOS, aunque la sede insista. El mapa de lo que sí existe está en Autofirma no funciona en Android o iPhone, y el paso a paso en firmar en Android y firmar en iPhone y iPad.
Pregunta 3: ¿Qué mensaje exacto ves?
El texto del error vale más que cualquier descripción. Cópialo tal cual —con su código, si lo tiene— y búscalo aquí:
| Mensaje que ves | Qué significa | Guía |
|---|---|---|
| «Autofirma no instalada o con problemas. Revise requisitos mínimos» | Lo dice la sede: no ha recibido respuesta de Autofirma en el tiempo previsto. | Sección siguiente y SAF_45 |
| «No se pudo contactar con AutoFirma» / «java.util.concurrent.TimeoutException» | Lo mismo, con otra redacción. No es un problema de Java. | ¿Autofirma necesita Java? |
| «No se pudo abrir un socket para la comunicación con la aplicación» (SAF_45) | El navegador y Autofirma no se hablan por el puerto local. | Error SAF_45 |
| «Error accediendo al almacén de claves y certificados» (SAF_08) | Autofirma no puede abrir el almacén de certificados. | Error SAF_08 |
| «No hay ningun certificado válido en su almacén» (SAF_19) | El almacén abre, pero ningún certificado le sirve. | Error SAF_19 |
| «Error al obtener los alias de los certificados» / «Error al cargar el nuevo almacén de claves» | Autofirma no consigue leer la lista de certificados. | Error al obtener los alias |
| El selector de certificados sale vacío, sin mensaje | Almacén equivocado, certificado caducado o filtro de la sede. | Autofirma no reconoce mi certificado |
| «Error en los parámetros de entrada» (SAF_03) | La sede pide algo que tu versión no entiende. | Error SAF_03 |
| «Error al recuperar los datos del servidor intermedio» (SAF_16) / «Error en el envio del resultado» (SAF_11) | Autofirma no llega al servidor de la sede: proxy, red corporativa, sesión caducada. | Error SAF_16 y SAF_11 |
| «Error realizando la firma electrónica» (SAF_09) | Certificado encontrado, pero la firma falla al calcularse. | Error SAF_09 |
Cualquier otro SAF_xx | Consulta la tabla verificada con el código fuente. | Todos los errores SAF |
| «Apple no ha podido verificar…», «quiere usar el llavero Sistema» | Avisos de macOS, no de Autofirma. | Autofirma no funciona en Mac |
«Autofirma no instalada o con problemas. Revise requisitos mínimos»
Merece un apartado propio porque es el mensaje más frecuente y el más engañoso. No lo muestra Autofirma; lo muestra la sede. Su script lanza afirma://, espera unos segundos a que la aplicación levante el servidor local y conteste, y si el plazo se agota da por hecho que no está instalada. Puede estar instalada perfectamente. Las causas reales, de más a menos frecuente:
- El navegador no ha lanzado la aplicación. Chrome muestra un diálogo «Abrir Autofirma» que hay que aceptar; si se cerró o si una extensión lo bloqueó, la sede nunca recibe respuesta. Firefox tiene su propio diálogo y recuerda la elección. Guías de Chrome y Firefox.
- La aplicación arranca pero el servidor local no. Antivirus, cortafuegos o, en Mac, el certificado
AutoFirma ROOTque falta en el Llavero. SAF_45. - La aplicación no arranca. Instalación rota. Autofirma no se abre.
- Tardó demasiado. En equipos lentos o con muchos certificados, Autofirma puede tardar más de lo que la sede espera. Vuelve a intentarlo con la aplicación ya abierta y sin otros programas pesados.
- Estás en un móvil. No existe versión, y el mensaje es literalmente cierto.
Sobre los «requisitos mínimos»: según el manual oficial de instalación, en Windows y macOS no hace falta tener Java instalado, porque el instalador incluye su propio entorno; en Linux sí, Java 8 o superior completo. El detalle, y los errores con nombre de Java, están en ¿Autofirma necesita Java?.
«He actualizado Autofirma y no funciona» y «no funciona hoy»
Dos situaciones que se repiten y que no son culpa tuya:
- Después de actualizar. Los instaladores no siempre limpian la versión anterior. En Windows, desinstala la antigua, reinicia e instala la nueva; en Mac, borra la
AutoFirma.previa antes de instalar, porque las dos se mezclan y la firma de código deja de verificar. En los dos sistemas, abre la aplicación una vez a mano después de instalar para que termine de registrar el protocoloapp afirma://. La limpieza completa, incluido el aviso «esta versión ya está instalada», está en He actualizado Autofirma y no funciona. - Funcionaba ayer. Chrome y Edge publican una versión mayor cada cuatro semanas y de vez en cuando una de ellas cambia cómo tratan los protocolos externos o las conexiones a
localhost; macOS rompe Autofirma cada septiembre; y las sedes se caen, sobre todo el último día de plazo. Antes de reinstalar nada, prueba el mismo trámite en otro navegador y prueba otra sede (por ejemplo, la firma de prueba de VALIDe). Si la otra sede funciona, el problema es del organismo, no tuyo.
Cuando no necesitas que Autofirma funcione
Antes de dedicar la tarde, decide qué tienes que hacer exactamente:
- Firmar dentro de la sede (un formulario con botón «Firmar» que lanza Autofirma, o la propia autenticación). Aquí no hay atajo: alguna de las guías de arriba tiene que funcionar, o usa Cl@ve si el organismo lo admite, u otro equipo. Cómo reconocer este caso: ¿Lo aceptará la sede?.
- Adjuntar un PDF firmado (una declaración responsable, un anexo, un contrato, una autorización). Es el caso mayoritario, y Autofirma es solo la herramienta que te recomendaron. Cualquier firma PAdES válida sirve.
En el segundo caso, FirmaLocal firma el PDF dentro del navegador con tu certificado en fichero .p12 o .pfx: sin instalar nada, sin protocolo afirma://, sin servidor local, sin almacén que acertar y sin Java. La firma PAdES-B-B se calcula en tu equipo; ni el documento ni el certificado se suben a ningún servidor. Firma tu PDF ahora. Los límites, para que no los descubras tarde: solo certificados en fichero (no DNIe ni Cl@ve), una firma por documento y sin sello de tiempo. Si no tienes el .p12, Exportar certificado FNMT a .p12 explica cómo sacarlo del navegador donde lo instalaste.
Comprobar que la firma vale
Lo hayas firmado con Autofirma o sin ella, sube el PDF a VALIDe antes de presentarlo. Si reconoce la firma y el titular del certificado, el documento está listo.
Fuentes
- Portal de Administración Electrónica, manual de instalación de Autofirma: requisitos de Java por sistema y desinstalación previa. Consultado el 2026-09-01.
- Proyecto clienteafirma, FAQ de ejecución de Autofirma: por qué no se abre desde el navegador, «Restaurar la instalación» y el certificado
Autofirma_. Consultada el 2026-09-01.ROOT. cer - Código fuente de Autofirma,
Protocol, origen de los códigosInvocation Launcher Error Manager. java SAF_xxde la tabla. Consultado el 2026-09-01. - Incidencias de clienteafirma #250 y #441, «No se pudo contactar con AutoFirma» con el servidor local en
wss://. Consultadas el 2026-09-01.127. 0. 0. 1: 63117/ - Chromium Blog, «Speeding up Chrome’s release cycle», ciclo de versiones de cuatro semanas. Consultado el 2026-09-01.