Instalación de nitropy con pipx¶

Esta guía explica cómo instalar nitropy con pipx. pipx crea un entorno virtual para nitropy. Esto significa que nitropy y sus dependencias no entran en conflicto con otros paquetes instalados en su sistema.

Nota

Para los usuarios de Windows: El soporte de Windows es todavía experimental - por favor, utilícelo con precaución. También puede utilizar binarios precompilados o un instalador MSI, véase Instalación de nitropy en Windows.

Instalación en Linux¶

Ubuntu, Debian¶

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

sudo apt install pipx && pipx ensurepath && pipx install pynitrokey

Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.

Arch¶

Puede instalar nitropy junto con el resto de dependencias necesarias mediante:

sudo pacman -S python python-pipx && pipx ensurepath && pipx install pynitrokey

Si ya ha instalado Python en su sistema, sólo tiene que ejecutar:

sudo pacman -S python-pipx && pipx ensurepath && pipx install pynitrokey

Tras cerrar la sesión o reiniciar el sistema, nitropy estará disponible.

Instalación en otras distribuciones/sistemas operativos¶

Preparación¶

Python 3.9, 3.10 o 3.11¶

Python ya está instalado en la mayoría de los sistemas macOS y Linux o puede descargarse desde python.org. Consulte la Guía de descarga de Python para obtener más información.

pip¶

Puede instalar pip con el gestor de paquetes de su sistema o con python3 -m ensurepip. Consulte la Guía de instalación de pip para obtener más información.

pipx¶

Antes de instalar nitropy, hay que instalar y configurar pipx:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Consulte la Guía de instalación de pipx para obtener más información.

Nota

Para usuarios de Linux - actualmente una dependencia transitoria (oscrypto) está generando problemas en algunas distribuciones de Linux. El respectivo GitHub tema documenta la solución actualmente necesaria:

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

Instalación¶

Ahora puedes instalar nitropy desde el paquete pynitrokey:

pipx install pynitrokey

nitropy está ahora disponible en su ruta:

nitropy --help

Actualizar¶

Puede actualizar el paquete con el siguiente comando:

pipx upgrade pynitrokey

Solución de problemas¶

Si tiene problemas, asegúrese de que utiliza la última versión comparando la salida de nitropy version con la lista de versiones ` en GitHub. Si una actualización no instala la última versión, es posible que te encuentres con uno de los siguientes problemas.

Versión incorrecta de Python¶

nitropy requiere Python 3.9 o 3.10. Si su instalación por defecto de Python es más antigua o más reciente que eso y no se puede actualizar, tiene que instalar adicionalmente Python 3.9 y especificar el nombre de su ejecutable Python al llamar a pipx, por ejemplo:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib no encontrado¶

Al ejecutar nitropy en macOS, es posible que aparezca un mensaje de error indicando que falta el archivo libusb-1.0.dylib. Esto puede solucionarse instalando manualmente libusb, por ejemplo, con homebrew:

$ brew install libusb

Notas de uso¶

Todas las plataformas¶

Si quieres usar nitropy con un dispositivo Nitrokey Pro o Nitrokey Storage, también tienes que instalar libnitrokey.

Windows¶

La compatibilidad con Windows es todavía experimental: utilícela con precaución.

Es posible que tengas que ejecutar nitropy con derechos de administrador para poder conectarte a un dispositivo.

Linux¶

En los sistemas Linux, también necesita las reglas udev de Nitrokey. Se suministran con libnitrokey. Alternativamente, puede instalarlos manualmente:

wget https://raw.githubusercontent.com/Nitrokey/nitrokey-udev-rules/refs/heads/main/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Consulte Configuración de las reglas udev para más información.

Usage of PIV features¶

Para poder utilizar la funcionalidad PIV de nitropía (nitropy nk3 piv), necesita instalar también la dependencia pyscard:

pipx install pynitrokey[pcsc]

Próximos pasos¶

Puedes encontrar más información sobre el uso de nitropía en estas guías: