rDNIe: un driver en Rust para el DNIe que funciona igual en Linux, Windows y macOS

Ilustración de una tarjeta inteligente en un lector conectado a tres sistemas operativos

rDNIe es una biblioteca de código abierto escrita en Rust para trabajar con el DNI electrónico español (DNIe) directamente por PC/SC, sin PKCS#11, OpenSC ni drivers del sistema, y con el mismo comportamiento en Linux, Windows y macOS. Es un port de JMulticard, el controlador en Java que usa AutoFirma, y su autor, el desarrollador sgomez, lo ha creado para llevar a macOS su aplicación de firma rFirma sin depender de Java. Se publica con licencia EUPL-1.2 en GitHub y crates.io.

Las claves de rDNIe en 30 segundos

  • Lee y firma con el DNIe 3.0 y 4.0 por PC/SC en Linux, Windows y macOS.
  • No resetea la tarjeta, así que no interrumpe a otros programas que la usan.
  • En la prueba de su autor tarda 416 ms frente a 1.323 ms de JMulticard.
  • Muestra los intentos de PIN restantes y rechaza PIN mal formados sin gastar un intento.
  • Es un proyecto muy reciente, creado en octubre de 2026.

El origen es un problema que conoce cualquiera que haya intentado usar el DNIe en un Mac. Según cuenta el autor, el driver de tarjetas inteligentes que trae macOS por defecto tiene un fallo que resetea la tarjeta tras unos seis segundos sin uso y la deja inutilizable. Se soluciona instalando el driver CCID de Ludovic Rousseau, pero no es razonable pedir a cada usuario que cambie la configuración de su equipo. La alternativa era integrar JMulticard, lo que obligaba a arrastrar Java, justo la dependencia que quería eliminar para que su código fuera 100 % nativo.

Qué hace y qué no

rDNIe localiza un DNIe 3.0 o 4.0 entre los lectores por su ATR, abre el canal seguro CWA-14890, lee los certificados y, de ellos, el nombre, apellidos y número del titular, consulta los intentos de PIN que quedan sin enviar el PIN y firma resúmenes SHA-256, SHA-384 o SHA-512 con PKCS#1 v1.5. Quedan fuera los DNIe 1.0 y 2.0, la lectura por NFC y PACE, el cambio de PIN, el descifrado y otras tarjetas. En Linux necesita pcscd; en macOS y Windows no requiere nada más. Se añade a un proyecto con cargo add rdnie y exige Rust 1.87 o superior.

La diferencia de diseño con JMulticard explica sus ventajas. JMulticard resetea cada lector hasta encontrar un DNIe y resetea la tarjeta dos veces al abrirla, lo que hace que OpenSC o Firefox, si estaban usando la misma tarjeta, pierdan su estado. rDNIe lee el ATR sin resetear y solo carga lo que se le pide. En la medición que publica el autor, con un mismo DNIe y lector, rDNIe tarda 416 ms y envía 42 comandos APDU hasta tener el certificado de firma, frente a 1.323 ms y 84 APDU de JMulticard y 1.526 ms y 130 APDU de OpenSC. Es una prueba propia con una sola tarjeta, documentada en el repositorio.

El PIN, tratado con cuidado

Con tres intentos antes del bloqueo del chip, la gestión del PIN es lo que más le importa al usuario. rDNIe solo envía el PIN si antes se han leído los intentos restantes en esa sesión, y vuelve a comprobarlos justo antes de firmar: si son cero, o no coinciden con los esperados, se detiene sin enviarlo. Cada llamada hace un solo intento y nada se reintenta por su cuenta. Además, un PIN fuera del rango de 8 a 16 caracteres se rechaza antes de llegar a la tarjeta, así que un error de formato no consume uno de los tres intentos. El PIN se borra de memoria al terminar. Para una aplicación de firma, poder decir al usuario cuántos intentos le quedan, y no solo avisar del último, es una mejora práctica.

Como cualquier pieza que maneja certificados de identidad, conviene tener en cuenta que es un proyecto joven, de un solo desarrollador y con poca adopción todavía. Antes de usarlo en producción, lo sensato es revisar el código y las comparativas que incluye el repositorio, que documenta las diferencias con JMulticard en un fichero de paridad.

Preguntas frecuentes

¿Qué es rDNIe?

Una biblioteca en Rust para leer certificados y firmar con el DNIe 3.0 y 4.0 por PC/SC en Linux, Windows y macOS.

¿Necesita Java u OpenSC?

No. Habla directamente con la tarjeta por PC/SC, sin PKCS#11, OpenSC ni Java. En Linux solo requiere pcscd.

¿Puede bloquear mi DNIe?

Está diseñado para evitarlo: comprueba los intentos antes de enviar el PIN, no reintenta solo y rechaza PIN mal formados sin gastar intentos.

Fuentes:

Suscríbete al boletín SysAdmin

Este es tu recurso para las últimas noticias y consejos sobre administración de sistemas, Linux, Windows, cloud computing, seguridad de la nube, etc. Lo enviamos 2 días a la semana. Recuerda revisar tu email para confirmar la suscripción.

Scroll al inicio
×