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

Braccio non supportato#

Attualmente, le versioni recenti di nitropy non possono essere installate su piattaforme Arm a causa di un problema di dipendenza (GitHub issue). Come soluzione alternativa, è possibile utilizzare un’installazione di Python x86 in un terminale Rosetta, come descritto in questa discussione).

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#

To be able to use the PIV functionality of nitropy (nitropy nk3 piv), you need to install the pyscard dependency too:

pipx install pynitrokey[pcsc]

I prossimi passi#

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