Installazione di nitropy con pipx¶

Questa guida spiega come installare nitropy con pipx. pipx crea un ambiente virtuale per nitropy. Ciò significa che nitropy e le sue dipendenze non entrano in conflitto con altri pacchetti installati sul sistema.

Nota

Per gli utenti di Windows: Il supporto di Windows è ancora sperimentale: usare con cautela. È anche possibile utilizzare binari precompilati o un programma di installazione MSI, vedere Installazione di nitropy su Windows.

Installazione su Linux¶

Ubuntu, Debian¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

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

Dopo il logout o il riavvio del sistema, nitropy sarà ora disponibile.

Arco¶

È possibile installare nitropy insieme a tutte le altre dipendenze necessarie utilizzando:

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

Se avete già installato Python sul vostro sistema, potete semplicemente eseguire:

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

Dopo il logout o il riavvio del sistema, nitropy sarà ora disponibile.

Installazione su altre distribuzioni/sistemi operativi¶

Preparazione¶

Python 3.9, 3.10 o 3.11¶

Python è già installato sulla maggior parte dei sistemi macOS e Linux o può essere scaricato da python.org. Per ulteriori informazioni, consultare la Guida al download di Python.

pip¶

È possibile installare pip con il gestore di pacchetti di sistema o con python3 -m ensurepip. Per ulteriori informazioni, consultare la Guida all’installazione di pip.

pipx¶

Prima di installare nitropy, è necessario installare e configurare pipx:

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

Per ulteriori informazioni, consultare la Guida all’installazione di pipx.

Nota

Per gli utenti Linux - attualmente una dipendenza transitoria (oscrypto) sta generando problemi su alcune distribuzioni Linux. Il rispettivo problema di GitHub documenta il workaround attualmente necessario:

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

Installazione¶

Ora è possibile installare nitropy dal pacchetto pynitrokey:

pipx install pynitrokey

nitropy è ora disponibile nel percorso:

nitropy --help

Aggiornamento¶

È possibile aggiornare il pacchetto con il seguente comando:

pipx upgrade pynitrokey

Risoluzione dei problemi¶

In caso di problemi, assicurarsi di utilizzare la versione più recente confrontando l’output di nitropy version con l’elenco delle release ` <https://github.com/Nitrokey/pynitrokey/releases>`_ su GitHub. Se un aggiornamento non installa l’ultima versione, è possibile che si sia verificato uno dei seguenti problemi.

Versione di Python sbagliata¶

nitropy richiede Python 3.9 o 3.10. Se l’installazione predefinita di Python è più vecchia o più recente e non può essere aggiornata, è necessario installare anche Python 3.9 e specificare il nome del suo eseguibile Python quando si chiama pipx, per esempio:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib non trovato¶

Quando si esegue nitropy su macOS, è possibile che venga visualizzato un messaggio di errore che indica la mancanza del file libusb-1.0.dylib. Questo problema può essere risolto installando manualmente libusb, ad esempio con homebrew:

$ brew install libusb

Note d’uso¶

Tutte le piattaforme¶

Se si desidera utilizzare nitropy con un dispositivo Nitrokey Pro o Nitrokey Storage, è necessario installare anche libnitrokey.

Windows¶

Il supporto per Windows è ancora sperimentale: usare con cautela.

Potrebbe essere necessario eseguire nitropy con i diritti di amministratore per potersi collegare a un dispositivo.

Linux¶

Sui sistemi Linux sono necessarie anche le regole Nitrokey udev. Queste vengono fornite con libnitrokey. In alternativa, è possibile installarle 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/

Per ulteriori informazioni, vedere Impostazione delle regole udev.

Usage of PIV features¶

Per poter utilizzare la funzionalità PIV di nitropia (nitropy nk3 piv), è necessario installare anche la dipendenza pyscard:

pipx install pynitrokey[pcsc]

I prossimi passi¶

Per ulteriori informazioni sull’uso di nitropy, consultare queste guide: