Actualización del firmware#

Esta guía describe cómo actualizar el firmware del Nitrokey 3.

Advertencia

Esta guía está todavía en estado experimental.

Importante

La actualización podría conducir a la pérdida de datos, así que asegúrese de tener habilitados los métodos de inicio de sesión de respaldo adecuados y/o asegúrese de que Nitrokey Pro no sea la única forma de autenticación/2FA para sus aplicaciones/servicios.

Cómo actualizar#

Importante

No desconecte nunca el Nitrokey 3 ni aborte el proceso mientras se actualiza, ya que esto podría inutilizar su dispositivo.

  1. Asegúrese de que tiene la última versión de pynitrokey instalada, por favor compruebe las instrucciones de instalación para su sistema operativo.

  2. Descargue la última imagen estable de firmware.

Importante

Para el uso en producción debe elegir la última versión estable (por tanto, sólo las versiones que no contengan, por ejemplo, «pre-release» o «RC»).

  1. Para aplicar la actualización ejecute:

$ nitropy pro enable-update
$ nitropy pro update nitrokey-pro-firmware-<version>.bin

Método de actualización alternativo#

También se puede utilizar dfu-util para la actualización del firmware:

  1. Instalar dfu-util

Los binarios para Windows están disponibles en:
Los binarios para macOS están disponibles a través de Homebrew:

Sólo para MacOS: Instala dfu-util a través de Homebrew

brew install dfu-util

  1. Utilice Nitrokey App v1.5-RC7 o superior para cambiar el modo de arranque del Nitrokey Pro al modo de actualización.

  2. Ahora el siguiente comando para aplicar la actualización

$ dfu-util -D update_binary.bin

  1. Ahora se puede volver a cambiar el modo de arranque con la aplicación Nitrokey.

Solución de problemas#

Asunto: libnitrokey no se pudo encontrar.

En caso de que la libnitrokey no pueda ser encontrada automáticamente, la ruta a la misma puede ser proporcionada con la variable env:

$ env LIBNK_PATH=/libnk/path/libnitrokey.so nitropy pro enable-update

Para encontrar libnitrokey en su sistema utilice:

$ locate libnitrokey.so
Problema: Me sale permission denied for /dev/hidrawX durante la actualización.

Esto probablemente significa que su usuario no tiene los permisos necesarios para leer y escribir en el dispositivo. Por favor, asegúrese de que ha configurado el correcto udev-rules. Descargue este conjunto udev-rules y colóquelo en su directorio de reglas udev (por ejemplo, /etc/udev/rules.d). A continuación, retire su Nitrokey 3 de la ranura USB y ejecute: udevadm control --reload-rules && udevadm trigger o reinicia tu máquina. Después la actualización debería funcionar sin el problema de los permisos.