Laguntza

DNIea Firefoxen Mac batean: PKCS#11 modulua

Gida eguneratua: 2026ko irailaren 16a · egilea: David Pelayo (nexoapex)

Firefoxek zure DNIea existituko ez balitz bezala jokatzen badu, ez da ezer hautsi: Firefoxek bere ziurtagiri-biltegia du eta, txartela bere kabuz irakurtzeko, PKCS#11 modulu bat behar du. Gida honek azaltzen du zein, non dagoen eta zergatik agertzen den «No es posible añadir el módulo» errorea.

Zergatik behar du Firefoxek modulu bereizi bat

Safarik, Chromek eta Edgek macOS-en giltza-sorta erabiltzen dute, eta txartel adimendunak CryptoTokenKit bidez iristen dira hara. Applek dokumentatzen du macOS-ek CCID klaseko USB irakurgailuak eta PIV txartelak berez ezagutzen dituela, baina DNIea ez da PIV txartela: bere ziurtagiria nabigatzaile horien elkarrizketa-koadroan ager dadin, giltza-sortan argitaratuko duen CryptoTokenKit luzapen bat behar da, DNIe Prok DNIe Mac-erako aplikazioan aktibatzen duena bezalakoa.

Firefoxek ez du horretan parte hartzen. Bere biltegi propioa mantentzen du (NSS) eta txartelekin PKCS#11 estandarraren bidez hitz egiten du, gailu kriptografikoetarako interfaze generikoa dena. PKCS#11 modulurik kargatu gabe, Firefoxek ez du zure DNIea ikusteko modurik.

Bada dena aldatzen duen xehetasun bat DNIea giltza-sortan argitaratzen duen aplikazio bat erabiltzen baduzu: Firefox 75etik aurrera security.osclientcerts.autoload hobespena dago, osclientcerts izeneko barne-modulu bat kargatzen duena sistemako bezero-ziurtagiriak irakurtzeko Windowsen eta macOS-en. macOS-erako Firefoxen egungo bertsioetan lehenespenez aktibatuta dator (Firefox 155ean egiaztatu genuen eta, 2026ko irailaren 16an, horrela jarraitzen du Firefox 156ren kodean eta ESR 140 eta 153 bertsioenean), eta horixe da giltza-sortan argitaratutako identitate bat, DNIe Mac-erako aplikazioak argitaratzen duena adibidez, Firefoxen ezer instalatu gabe agertzearen arrazoia. Ez duena egiten txartela bere kabuz irakurtzea da: hura argitaratzen duen aplikaziorik gabe, Firefoxek txartelaren PKCS#11 modulua behar du.

Zein modulu instalatu (eta zein ez)

DNIearen modulu ofiziala Poliziaren Zuzendaritza Nagusiak argitaratzen du dnielectronico.es guneko deskarga-eremuan. 2026ko irailaren 16an, bertsioa 1.6.8 da eta lau fitxategitan eskaintzen da:

Orriak berak adierazten du biek macOS 26 Tahoe, 15 Sequoia, 14 Sonoma eta 13 Ventura estaltzen dituztela. Oraindik ez du aipatzen macOS 27, Applek 2026ko irailaren 14an argitaratu zuena. Hemen gaizki aukeratzea da errore ohikoena, eta beherago azaltzen dugu.

Eta nahasmen klasiko bat: FNMTek beste modulu bat argitaratzen du, bere txartelerako eta DNIerako, /Library/Libpkcs11-fnmtdnie/lib/libpkcs11-fnmtdnie.so bidean instalatzen dena. Ez da fitxategi bera, ezta bide bera ere. Tutorial bat jarraitzen baduzu eta bidea instalatuta duzunarekin bat ez badator, Firefoxek ez du ezer kargatuko.

Instalatzea eta Firefoxen kargatzea

1. Deskargatu zure Macari dagokion fitxategia. Zein duzun ez badakizu: Apple menua > Mac honi buruz; txipa «Apple» hitzarekin hasten bada, _arm bertsioa behar duzu.
2. Ireki .dmg eta egin klik bikoitza instalatzailearen ikonoan (edo instalatu .pkg) eta jarraitu morroiari. Dena /Library/Libpkcs11-dnie barruan geratzen da.
3. Firefoxen, joan Ezarpenak > Pribatutasuna eta segurtasuna atalera, jaitsi Ziurtagiriak arte eta sakatu Kudeatu segurtasun-gailuak.
4. Sakatu Kargatu, jarri moduluari izen bat (eskuliburu ofizialak «DNIE Módulo P11» proposatzen du) eta adierazi bidea:
   /Library/Libpkcs11-dnie/lib/libpkcs11-dnie.so
5. Onartu. Dena ondo joan bada, modulua zerrendan agertzen da, konektatutako irakurgailu bakoitzeko erreten batekin.

Eskuliburu ofizialak menua «Preferencias > Avanzado > Cifrado > Dispositivos de seguridad» gisa deskribatzen du: hamarkada bat baino gehiago duen Firefox baten bidea da — dokumentua Mac OS X Mountain Lion eta Mavericks-erako idatzita dago. Gaurko kokapena 3. urratsekoa da; gainerakoan, modulua lehen bezala kargatzen da.

Erro-ziurtagiria inportatzea

Modulua kargatuta, Firefoxek zure ziurtagiriak ikusten ditu jada, baina oraindik baliteke nork jaulki dituen ez fidatzea. 1.6.8 instalatzaileak DNIearen erro-ziurtagiria moduluaren ondoan uzten du, baina ez eskuliburu ofizialak eta Agencia Tributariaren gidak aipatzen duten bidean:

1. Ezarpenak > Pribatutasuna eta segurtasuna > Ziurtagiriak atalean, sakatu Kudeatu ziurtagiriak eta joan Autoritateak fitxara.
2. Sakatu Inportatu eta adierazi /Library/Libpkcs11-dnie/AC RAIZ DNIE 2.crt bidea (fitxategi-hautatzailean: Macintosh HD > Biblioteca > Libpkcs11-dnie).
3. Morroiak konfiantza ezartzeko eskatuko dizu: markatu eskaintzen dizkizun lauki guztiak, instalatzaile ofizialak irekitzen duen laguntza-orriak adierazten duen bezala.

«No es posible añadir el módulo»: lau arrazoiak

Mezu horrek (Firefox euskaraz baduzu, «Ezin da modulua gehitu») gauza bakarra esan nahi du: Firefoxek fitxategia aurkitu du baina ezin izan du modulu kriptografiko gisa kargatu. Mac batean ia beti lau hauetako bat da.

• Arkitektura okerra. 84. bertsiotik aurrera, macOS-erako Firefox binario unibertsala da eta Apple Silicon duen Mac batean arm64 moduan exekutatzen da jatorriz. arm64 prozesu batek ezin du Intelerako konpilatutako liburutegi bat kargatu: modulua _arm atzizkirik gabe instalatu baduzu M1 edo berriagoa den Mac batean, errorea hori bera da. Desinstalatu eta instalatu zuzena.
• Bidea ez da existitzen. Egiaztatu Firefoxekin eztabaidatu aurretik. Terminalean:
  ls -l /Library/Libpkcs11-dnie/lib/
libpkcs11-dnie.so agertzen ez bada, instalazioa ez zen osatu eta ez dago ezer kargatzeko.
  Agencia Tributariaren gida jarraitzen baduzu, /Library/Libpkcs11-dnietif/lib/libpkcs11-dnietif.so ere ikusiko duzu: 1.6.8 pakete ofizialak ez du bide hori instalatzen, /Library/Libpkcs11-dnie/lib/libpkcs11-dnie.so baizik.
• Izen horrekin modulu bat dago jada. Firefoxek ez ditu onartzen izen bereko bi modulu. Instalazioa hainbat aldiz saiatu baduzu, begiratu Gailu kudeatzailearen zerrenda, kendu aurrekoa «Hustu» botoiarekin eta kargatu berriro.
• DNIea irakurgailuan zegoen modulua kargatzean. Errore honetarako, Agencia Tributariak Firefoxetik irtetea, DNIea ateratzea eta txartela sartu gabe berriro kargatzea adierazten du. Modulua kargatuta dagoenean, itxi Firefox, sartu DNIea, ireki berriro Firefox eta sakatu «Hasi saioa» Gailu kudeatzailean. Macek irakurgailua ere ikusten ez badu, arazoa lehenago dago: ikusi irakurgailuen gida.

Hutsetik hasi nahi baduzu, desinstalatzeko nahikoa da /Library/Libpkcs11-dnie karpeta ezabatzea, eskuliburu ofizialak adierazten duen bezala.

Funtzionatu duela egiaztatzea

Gailu kudeatzailean modulua ikusi beharko zenuke, irakurgailu bakoitzeko erreten batekin; DNIea sartuta, erretena beteta agertzen da. Benetako proba egoitza elektroniko batean sartzea da: ziurtagiria eskatzean, Firefoxek DNIearenak eskaini beharko lizkizuke eta PINa eskatu.

Atsekabeak aurrezten dituen xehetasun bat: eskuliburu ofizialak Ziurtagiriak atalean «Galdetu beti» aukera uztea gomendatzen du zerbitzari batek zure ziurtagiri pertsonala eskatzen duenerako, Firefoxek automatikoki bat aukera dezan utzi beharrean. DNIeak bi ziurtagiri ditu —bat autentifikaziorako eta bestea sinadurarako— eta identifikatzeko autentifikaziokoa da dagokiona.

DNIearekin saioa hastean, PINa sartu ondoren, Firefoxek «Falló el inicio de sesión» erantzuten badu (Firefox euskaraz baduzu, «Huts egin du saioa hastean»), Agencia Tributariak lau arrazoi jasotzen ditu: zure DNIearen bertsioarekin bateragarria ez den sistema eragile bat, azken bertsioa ez den edo Gailu kudeatzailetik ondo estekatuta ez dagoen modulu bat, DNIe 3.0rekin arazoak ematen dituzten irakurgailuen zerrendako irakurgailu bat, edo PIN blokeatua. Gailu kudeatzailean DNIearen ordez «Unnamed Slot», irakurgailuaren fabrikatzailea edo modeloa agertzen bada, itxi Firefox, konektatu berriro txartela (ahal baduzu, aldatu irakurgailua beste USB ataka batera) eta ireki Firefox berriro.

Zer ez den beharrezkoa

• Irakurgailuaren kontrolatzaileak. macOS-ek CCID irakurgailuen jatorrizko euskarria du 10.15etik.
• Java. PKCS#11 moduluak ez du erabiltzen. Java AutoFirmarekin sartzen da jokoan, eta hori beste kontu bat da: AutoFirma Macen gidak azaltzen du.
• Konfigurazio-profilak edo baimen bereziak. Tutorial batek SIP desaktibatzeko edo profil bat instalatzeko eskatzen badizu, mesfida zaitez.

Ezer instalatu nahi ez baduzu

Aurreko guztia beharrezkoa da Firefoxek txartela nondik irakurri ez duelako. DNIe Prorekin, DNIe Mac-erako aplikazioak zure DNIea macOS-en giltza-sortan argitaratzen du eta Firefoxek handik irakurtzen du, Safarik, Chromek edo Edgek bezala, modulurik eta inportatu beharreko erro-ziurtagiririk gabe. Nola aktibatu, urratsez urrats: DNIea Safarin, Chromen eta Edgen gida. Bere prezioa eta zer den doan azalean zehaztuta daude. Bide honen eta modulu ofizialaren artean zalantza baduzu, nola instalatu DNIea Mac batean gidan alderatzen ditugu.

Eta nahi duzuna dokumentu bat sinatzea bada, ez identifikatzea, nabigatzaileak ez du batere parte hartzen: ikusi nola sinatu PDF bat DNIearekin Mac batean.

Ohiko galderak