Installer nitropy avec pipx

Ce guide explique comment installer nitropy avec pipx. pipx crée un environnement virtuel pour nitropy. Cela signifie que nitropy et ses dépendances n’entrent pas en conflit avec d’autres paquets installés sur votre système.

Note

Pour les utilisateurs de Windows: Le support de Windows est encore expérimental – veuillez l’utiliser avec prudence. Vous pouvez également utiliser des binaires précompilés ou un installateur MSI, voir Installation de nitropy sous Windows.

Installation sous Linux

Ubuntu, Debian

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Après la déconnexion ou le redémarrage de votre système, nitropy sera désormais disponible.

Arche

Vous pouvez installer nitropy avec toutes les autres dépendances requises en utilisant: :

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

Si vous avez déjà installé Python sur votre système, vous pouvez simplement lancer: :

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

Après la déconnexion ou le redémarrage de votre système, nitropy sera désormais disponible.

Installation sur d’autres distributions/systèmes d’exploitation

Préparation

Python 3.9, 3.10 ou 3.11

Python est déjà installé sur la plupart des systèmes macOS et Linux ou peut être téléchargé sur python.org. Consultez le Guide de téléchargement de Python pour plus d’informations.

pip

Vous pouvez installer pip avec le gestionnaire de paquets de votre système ou avec python3 -m ensurepip. Consultez le Guide d’installation de pip pour plus d’informations.

pipx

Avant d’installer nitropy, vous devez installer et configurer pipx: :

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

Voir le pipx Installation Guide pour plus d’informations.

Note

Pour les utilisateurs de Linux - actuellement une dépendance transitoire (oscrypto) génère des problèmes sur certaines distributions Linux. Le numéro GitHub documente la solution de contournement actuellement nécessaire: :

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

Installation

Maintenant vous pouvez installer nitropy à partir du paquet pynitrokey: :

pipx install pynitrokey

nitropy est maintenant disponible dans votre chemin: :

nitropy --help

Mise à niveau

Vous pouvez mettre à jour le paquet avec la commande suivante: :

pipx upgrade pynitrokey

Dépannage

Si vous rencontrez des problèmes, veuillez vous assurer que vous utilisez la dernière version en comparant la sortie de nitropy version avec la release list sur GitHub. Si une mise à niveau n’installe pas la dernière version, vous rencontrez peut-être l’un des problèmes suivants.

Mauvaise version de Python

nitropy nécessite Python 3.9 ou 3.10. Si votre installation Python par défaut est plus ancienne ou plus récente que cela et ne peut pas être mise à jour, vous devez installer en plus Python 3.9 et spécifier le nom de son exécutable Python lorsque vous appelez pipx, par exemple : :

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib non trouvé

Lorsque vous exécutez nitropy sous macOS, vous pouvez voir un message d’erreur indiquant que le fichier libusb-1.0.dylib est manquant. Ceci peut être corrigé en installant manuellement libusb, par exemple avec homebrew: :

$ brew install libusb

Notes d’utilisation

Toutes les plateformes

Si vous voulez utiliser nitropy avec un dispositif Nitrokey Pro ou Nitrokey Storage, vous devez également installer libnitrokey.

Windows

La prise en charge de Windows est encore expérimentale - veuillez l’utiliser avec prudence.

Vous devrez peut-être exécuter nitropy avec des droits d’administrateur pour pouvoir vous connecter à un appareil.

Linux

Sur les systèmes Linux, vous avez également besoin des règles udev Nitrokey. Elles sont livrées avec libnitrokey. Alternativement, vous pouvez les installer manuellement : :

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

Voir Mise en place des règles udev pour plus d’informations.

Usage of PIV features

Pour pouvoir utiliser la fonctionnalité PIV de la nitropie (nitropy nk3 piv), vous devez également installer la dépendance pyscard :

pipx install pynitrokey[pcsc]

Les prochaines étapes

Vous trouverez de plus amples informations sur l’utilisation de la nitropy dans ces guides :