Axuda

AutoFirma en Mac: por que falla e onde encaixa DNIe para Mac

Guía actualizada: 29 de setembro de 2026 · por David Pelayo (nexoapex)

Cando AutoFirma non funciona nun Mac, os fallos habituais repártense en cinco grupos: macOS non deixa abrila ou non arranca (Gatekeeper, Apple Silicon, unha instalación mesturada), o Mac ou AutoFirma non ven o lector, AutoFirma non ve o certificado («No se han encontrado certificados válidos en el almacén»), o navegador non consegue conectar con ela («No se pudo contactar con AutoFirma», SAF_45), ou o certificado do DNIe caducou ou o PIN está bloqueado. Máis abaixo, como distinguir cada caso.

AutoFirma é a aplicación oficial de sinatura electrónica do Goberno de España, e moitas sedes electrónicas invócana directamente para asinar. DNIe para Mac non a substitúe á forza: é interoperable con ela, e ademais cobre pola súa conta a identificación no navegador, con DNIe Pro, e a sinatura de documentos soltos, sen saír do teu Mac.

Que é AutoFirma?

AutoFirma é o cliente de sinatura electrónica que distribúe gratuitamente o Goberno de España. Moitas sedes electrónicas (Agencia Tributaria, Seguridad Social, DGT e outras) invócana desde o navegador cando precisan que asines un trámite no momento. DNIe para Mac non é AutoFirma nin un substituto oficial: é unha aplicación independente de nexoapex que le o teu DNIe, te identifica e asina documentos pola súa conta.

AutoFirma non funciona no teu Mac: os fallos máis comúns

Estes son os motivos polos que AutoFirma adoita fallar en macOS e como saber se o problema está en AutoFirma, no teu lector de tarxetas ou no propio DNIe. Para os fallos de AutoFirma en si, a fonte autorizada é a súa web oficial; aquí axudámoste a localizar onde está o problema.

macOS non deixa abrir AutoFirma (desenvolvedor non identificado ou software malicioso)

É Gatekeeper, o control de aplicacións de macOS, non un fallo do programa. Desde macOS 15 Sequoia, Apple xa non permite saltar o bloqueo abrindo a app con Control-clic (ou co botón dereito) → Abrir. Intenta abrila unha vez, vai a Axustes do Sistema → Privacidade e seguridade, baixa ata Seguridade e preme Abrir igualmente: o botón aparece durante unha hora, máis ou menos, despois do intento. Introduce o teu contrasinal de inicio de sesión e macOS gardará AutoFirma como excepción; a partir de entón ábrese con dobre clic, como explica o Manual de uso do Mac. En macOS 13 Ventura e 14 Sonoma tamén serve facer Control-clic (ou botón dereito) sobre a app no Finder, escoller Abrir e confirmar. Descarga AutoFirma sempre desde a web oficial do Goberno, nunca dun repositorio de terceiros.

AutoFirma non mostra o certificado do DNIe

É o fallo máis habitual no Mac, e hai tres capas que descartar por orde: que macOS recoñeza o lector, que a tarxeta se lea, e que o almacén de certificados que usa AutoFirma vexa o DNIe. Para separar as dúas primeiras da terceira: se DNIe para Mac le a túa tarxeta e amosa os teus datos e o estado dos teus certificados, o lector e o DNIe funcionan, e o que queda é configuración de AutoFirma. Se tampouco os ve, o problema está antes: lector ou tarxeta.

O Mac non recoñece o lector de tarxetas

Os lectores de contacto compatibles con CCID funcionan en macOS sen instalar ningún driver. Compróbao en Menú Apple → Acerca deste Mac → Máis información → Informe do sistema → USB: o lector debe aparecer na lista. Se non aparece, proba outro porto ou outro cable e evita os hubs sen alimentación propia. Insire a tarxeta co chip por diante e ata o fondo. Se estás a escoller lector, ou dubidas de se o teu serve, a guía completa está en que lector de DNIe vale nun Mac.

macOS ve o lector pero AutoFirma di que non hai ningún

Convén separalo do caso anterior: o lector está ben e macOS recoñéceo, pero o contorno Java que AutoFirma leva dentro non chega ata el e a aplicación anota «No se detectaron lectores de tarjetas en el sistema» ou un erro de tarxeta non presente. Que macOS o vexa compróbase no Terminal con system_profiler SPSmartCardsDataType: o teu lector debe aparecer baixo Readers.

Se aparece aí e AutoFirma segue sen velo, o fallo non está no lector nin na tarxeta, e non hai axuste do hardware que o arranxe: é cousa de AutoFirma e a súa solución correspóndelle a firmaelectronica.gob.es. Está documentado na incidencia 523 do repositorio oficial de AutoFirma. DNIe para Mac non pasa por Java: fala co lector a través de CryptoTokenKit, a capa de tarxetas intelixentes de macOS.

AutoFirma dá un erro de Java

As versións actuais de AutoFirma para macOS traen o seu propio contorno de execución de Java, así que reinstalar a versión vixente desde a web oficial adoita resolver os erros herdados dunha instalación antiga que dependía do Java do sistema. DNIe para Mac non usa Java en absoluto: é unha aplicación nativa de macOS.

AutoFirma non abre nun Mac con Apple Silicon (M1, M2, M3, M4, M5 ou MacBook Neo)

AutoFirma distribúese en dúas versións para Mac, unha para Intel e outra para Apple Silicon. Segundo cal instales, macOS pode pedirche Rosetta 2 para executar compoñentes compilados para Intel; se a app non chega a abrirse, instálao desde o Terminal con softwareupdate --install-rosetta e téntao de novo. Apple avisa nas notas da versión de macOS 27 de que a actualización non restaura Rosetta aínda que xa estivese no teu Mac. Se AutoFirma deixa de abrirse despois de actualizar, volve executar ese comando ou, mellor, instala a versión de AutoFirma para Apple Silicon (na web oficial, «para MacOS procesadores M1 y siguientes»). Nesas mesmas notas advirte de que o software para Intel deixará de ser compatible con macOS 28, agás os xogos antigos. DNIe para Mac funciona de forma nativa en Apple Silicon e non precisa Rosetta.

O navegador abre AutoFirma pero despois di que non pode contactar con ela

É o fallo máis repetido despois do do certificado. A sede abre unha ligazón afirma://, AutoFirma arranca en segundo plano e levanta un pequeno servidor local; o navegador ten que conectarse a el por wss://127.0.0.1 cun certificado SSL que o instalador de AutoFirma xera no teu Mac e engade ao chaveiro. Se ese certificado non está ou non é de confianza, o navegador corta a conexión e verás «No se pudo contactar con AutoFirma» aínda que a aplicación estea aberta.

O que lle funciona á maioría é a función de reparación da propia aplicación: Herramientas → Restaurar instalación. Se non chega a completarse, instala os certificados a man: abre ~/Library/Application Support/AutoFirma, fai dobre clic en AutoFirma_ROOT.cer e en autofirma.cer, e no chaveiro do sistema (Acceso a Chaveiros, Keychain Access) marca os dous como sempre de confianza; o segundo aparece como «127.0.0.1» ou como «localhost», segundo a instalación. Non busques un porto fixo como o 8080: AutoFirma abre portos dinámicos e é normal que cambien en cada intento. En macOS Tahoe hai ademais unha incidencia, a 551, aberta o 31 de xullo de 2026 e sen pechar a 16 de setembro: un usuario de AutoFirma 1.9.2 en macOS 26.5, nun Mac con Apple Silicon, informa de que AutoFirma non chega a abrir o seu servizo de comunicación local. Un colaborador do proxecto suxeriulle restaurar a instalación, aceptar o aviso de permiso do navegador e actualizar a macOS Tahoe 26.6.

En Chrome e Edge hai outra causa. Para o navegador, unha páxina que se conecta a 127.0.0.1 (o teu propio Mac) está a acceder á rede local, e iso precisa o teu permiso. Desde a versión 147, publicada en abril de 2026, Chrome e Edge tamén o piden para as conexións WebSocket, que son a vía principal de AutoFirma. Non é unha xanela que bloquee a páxina, senón un aviso pequeno que, segundo ese mesmo colaborador de AutoFirma, adoita saír arriba á esquerda. Pide acceso a outras aplicacións e servizos do teu dispositivo ou, nalgunhas versións, aos dispositivos da túa rede local; o texto exacto cambia segundo a versión e o navegador. Se o ignoras ou o rexeitas, a sede non pode comunicarse con AutoFirma e mostra un erro de conexión, como «No se pudo contactar con AutoFirma», aínda que o certificado estea ben. Acéptao e repite o trámite; se xa o rexeitaches, revisa os permisos dese sitio web nos axustes do navegador.

AutoFirma dá o erro SAF_45 («non se puido abrir un socket»)

É o mesmo escenario visto desde AutoFirma: a aplicación arranca, pero non consegue levantar o servidor local porque non pode ler o almacén co que cifra esa conexión. En macOS viuse que o instalador deixa o cartafol ~/Library/Application Support/AutoFirma con root como propietario, de xeito que o teu usuario non o pode abrir. Está documentado na incidencia 488 do repositorio oficial de AutoFirma.

Compróbao no Terminal con ls -ld ~/Library/Application\ Support/AutoFirma. Se o propietario é root, devólveo ao teu usuario con sudo chown -R "$(whoami):staff" ~/Library/Application\ Support/AutoFirma e repite o trámite. O rexistro da aplicación, en ~/.afirma/AUTOFIRMA.afirma.log.xml, anota xusto antes do SAF_45 que non puido abrir o socket.

AutoFirma deixa de abrirse despois de reiniciar o Mac

Ocorre cando instalas unha versión nova enriba doutra anterior. O disco de macOS non distingue maiúsculas de minúsculas, así que AutoFirma.app e Autofirma.app son o mesmo cartafol e o instalador pode mesturar as dúas versións, deixando dentro ficheiros vellos que non encaixan coa sinatura de código nova. Ata que reinicias funciona; despois macOS rexéitaa e di que non se pode abrir. Está documentado na incidencia 524 do repositorio oficial de AutoFirma.

Compróbase no Terminal con codesign -vv /Applications/AutoFirma.app: se responde «a sealed resource is missing or invalid», o paquete está mesturado. A solución é arrastrar a aplicación ao Lixo, baleiralo e volver instalar desde a web oficial, sen conservar a instalación anterior.

AutoFirma 1.9 e 1.9.1 podían deixar inaccesible o chaveiro de inicio de sesión

En macOS Tahoe 26.4 e 26.4.1, instalar ou restaurar esas versións podía deixar inservible o chaveiro de inicio de sesión: o sistema comeza a pedir o seu contrasinal e a rexeitalo, e tras reiniciar aparece un chaveiro novo e baleiro. O antigo segue en ~/Library/Keychains con «rename» engadido ao nome, pero xa non se abre. Está documentado na incidencia 512 do repositorio oficial de AutoFirma, onde o seu equipo explica que o fallo non se produce en macOS 26.5 e que AutoFirma 1.9.2 deixa de usar a operación que o provocaba. Ollo ao descargala: a 16 de setembro de 2026, a páxina de descargas oficial mostra a 1.9.1 como versión principal para Mac, e a 1.9.2 aparece máis abaixo, despois de «Versiones anteriores», baixo o seu propio rótulo «Tahoe 26.4 /26.4.1». Se segues en macOS 26.4 ou 26.4.1, instala esa 1.9.2 ou, mellor, actualiza macOS.

O que se perde son os contrasinais gardados e os certificados de software que houbese nese chaveiro; se tes Time Machine, restaurar ~/Library/Keychains/login.keychain-db desde unha copia anterior adoita recuperalos. Os certificados do DNIe non están aí: viven no chip da tarxeta, así que un chaveiro danado non os leva e volven estar dispoñibles en canto conectas o lector coa tarxeta dentro.

AutoFirma di «No se han encontrado certificados válidos en el almacén» (erro SAF_19)

É o aviso de AutoFirma cando a súa lista de certificados sae baleira: «No se han encontrado certificados válidos en el almacén. Inserte una tarjeta inteligente en el lector y pulse Recargar, o cargue un almacén externo». Ou non atopa ningún certificado no almacén que usa, ou ningún serve para esa sinatura, porque caducou ou porque a sede pediu só un tipo concreto de certificado. No seu rexistro aparece como «No habia certificados validos en el almacen del usuario» e, cando a sinatura a lanza unha sede, esta recibe o código SAF_19 («No hay ningun certificado válido en su almacén»), segundo as mensaxes e o xestor de erros do código de AutoFirma. Nun Mac, o primeiro é saber se asinas co DNIe ou cun certificado instalado no chaveiro.

• Co DNIe. AutoFirma usa o chaveiro de Apple como almacén, pero o DNIe non depende del: leo co seu propio controlador Java, JMulticard, activado de serie. Comproba en Herramientas → Preferencias → General que segue marcada a opción «Habilitar JMulticard para el uso de tarjetas de la FNMT y DNIe». Segundo o seu manual de instalación, se se desactiva, AutoFirma precisa o controlador oficial da tarxeta instalado no sistema, e o cambio aplícase a próxima vez que abras a aplicación. Se está marcada, descarta por orde o lector, a tarxeta e a caducidade dos certificados (duran dous anos, segundo o Real Decreto 255/2025), como explican os demais apartados desta guía.
• Cun certificado de software, como o da FNMT. Para saber se o problema está no certificado ou en AutoFirma, executa security find-identity -v no Terminal: lista só os certificados que conservan a súa chave privada e que, polo tanto, poden asinar. Se o teu non sae aí, non asinará en ningunha aplicación. En AutoFirma 1.8.3 e 1.8.4 comprobouse que marcar o certificado como sempre de confianza en Acceso a Chaveiros fai que o Java que acompaña esas versións deixe de velo; devolvelo á confianza por omisión, na lapela de confianza, faino reaparecer. Confírmao o equipo de AutoFirma na incidencia 413 do seu repositorio oficial, e outros usuarios descríbeno na 462.
• En macOS Tahoe con AutoFirma 1.9.2. Hai dúas incidencias abertas no repositorio oficial con este mesmo síntoma, a 520 (macOS 26.4.1) e a 548 (macOS 26.5.2, Mac con M4), as dúas en Mac con Apple Silicon: certificados de software instalados no chaveiro coa súa chave privada non aparecen en AutoFirma (na 520, eses mesmos certificados funcionan nos navegadores). Na 548, un colaborador do proxecto pediu actualizar á última versión de macOS Tahoe, e quen abriu a incidencia respondeu que o fallo seguía despois de actualizar. A 16 de setembro de 2026 as dúas seguen abertas.

DNIe para Mac non xestiona certificados de software como os da FNMT: traballa cos do DNIe, que están na tarxeta.

O certificado do DNIe caducou ou o PIN está bloqueado

Entón non é AutoFirma: ningunha aplicación pode asinar cun certificado caducado nin co PIN bloqueado, e o DNIe non ten PUK. As dúas cousas resólvense en persoa, de balde e sen cita previa, nun Punto de Actualización do DNIe (PAD). Contámosche o paso a paso na guía de PIN bloqueado ou caducado.

DNIe para Mac é unha alternativa a AutoFirma?

Para asinar os teus propios documentos e validar sinaturas, si: DNIe para Mac asina en PAdES, CAdES e XAdES, de balde e sen Java. Para os trámites nos que a sede invoca AutoFirma, non: aí a sede chámaa directamente para asinar, e iso non cambia. As dúas poden estar instaladas no mesmo Mac, e AutoFirma segue lendo o DNIe pola súa conta, con JMulticard. Para identificarte nunha sede tampouco fai falta AutoFirma: con DNIe Pro, o teu certificado aparece no propio diálogo do navegador, como explica a guía do DNIe en Safari e Chrome.

Cando usas cada unha

AutoFirma e DNIe para Mac, lado a lado

A fila de AutoFirma resume a súa función pública e o seu custo; para o resto das súas características, consulta a fonte oficial en firmaelectronica.gob.es.

Preciso instalar Java para todo isto?

Para DNIe para Mac, non: é unha aplicación nativa de macOS, sen Java, sen configuracións de sistema nin perfís. Só precisas macOS 13 ou posterior, un lector de tarxetas USB de contacto, o teu DNIe e o teu PIN. Se partes de cero, a guía para instalar o DNIe nun Mac explica as dúas vías, a oficial e a da app.

E en Firefox?

Firefox non fala coa tarxeta a través da integración nativa de macOS, pero si le os certificados de cliente do sistema, e nas versións actuais vén activado de serie. Por iso o DNIe que publica DNIe para Mac aparece tamén en Firefox, sen cargar ningún módulo PKCS#11. Se no teu equipo non aparecese, a guía do DNIe en Firefox explica a vía do módulo oficial.

Máis sobre que fai DNIe para Mac ou como conseguilo. Se o que buscas é axuda cun PIN bloqueado ou un certificado caducado, consulta a guía de PIN bloqueado ou caducado.

Tes un certificado software FNMT nun ficheiro .p12 ou .pfx? Segue a guía do certificado dixital en Mac para importalo en Acceso a Chaveiros. É distinto do DNIe, cuxa clave privada permanece na tarxeta; a app DNIe non xestiona certificados software.