Nitroopia paigaldamine pipxiga¶

Selles juhendis selgitatakse, kuidas paigaldada nitropy koos pipx. pipx loob nitropy jaoks virtuaalse keskkonna. See tähendab, et nitropy ja selle sõltuvused ei lähe vastuollu teiste teie süsteemi paigaldatud pakettidega.

Märkus

Windowsi kasutajatele: Windowsi tugi on veel eksperimentaalne – palun kasutage seda ettevaatlikult. Võite kasutada ka eelkompileeritud binaarsüsteeme või MSI paigaldusprogrammi, vt Nitropy installimine Windowsis.

Paigaldamine Linuxile¶

Ubuntu, Debian¶

Saate nitropy koos kõigi teiste vajalike sõltuvustega installeerida, kasutades:

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

Pärast välja logimist või süsteemi taaskäivitamist on nitropy nüüd saadaval.

Arch¶

Saate nitropy koos kõigi teiste vajalike sõltuvustega installeerida, kasutades:

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

Kui olete oma süsteemi juba Pythoni installeerinud, võite lihtsalt käivitada:

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

Pärast välja logimist või süsteemi taaskäivitamist on nitropy nüüd saadaval.

Paigaldamine muudesse jaotus-/käitlussüsteemidesse¶

Ettevalmistus¶

Python 3.9, 3.10 või 3.11¶

Python on enamikus macOS- ja Linux-süsteemides juba installeeritud või seda saab alla laadida aadressilt python.org. Lisateavet leiate Pythoni allalaadimise juhendist.

pip¶

Pipi saab paigaldada oma süsteemi paketihalduriga või python3 -m ensurepip. Lisateavet leiate pip-i paigaldusjuhendist.

pipx¶

Enne nitropy installimist tuleb paigaldada ja konfigureerida pipx:

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

Lisateavet leiate veebilehelt pipx Installation Guide.

Märkus

Linuxi kasutajatele - praegu tekitab ajutine sõltuvus (oscrypto) probleeme mõnes Linuxi distributsioonis. Vastav GitHub issue dokumenteerib hetkel vajaliku lahenduse:

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

Paigaldamine¶

Nüüd saate paigaldada nitropy pynitrokey paketist:

pipx install pynitrokey

nitropy on nüüd saadaval teie tee:

nitropy --help

Uuendamine¶

Paketti saab uuendada järgmise käsuga:

pipx upgrade pynitrokey

Veaotsing¶

Kui teil tekib probleeme, veenduge, et kasutate uusimat versiooni, võrreldes nitropy version väljundit väljalaske nimekirjaga GitHubis. Kui uuendus ei paigalda uusimat versiooni, võib teil olla üks järgmistest probleemidest.

Vale Python versioon¶

nitropy nõuab Python 3.9 või 3.10. Kui teie Pythoni vaikimisi installatsioon on sellest vanem või uuem ja seda ei saa uuendada, peate te lisaks installima Python 3.9 ja täpsustama selle Pythoni käivitatava faili nime, kui te kutsute pipx-i, näiteks:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib ei leitud¶

Kui käivitate nitropy’t macOS-i peal, võite näha veateadet, et puudub libusb-1.0.dylib fail. Seda saab parandada libusb-i käsitsi paigaldamisega, nt homebrew:

$ brew install libusb

Kasutamise märkused¶

Kõik platvormid¶

Kui soovite kasutada nitrokey’t koos Nitrokey Pro või Nitrokey Storage seadmega, peate paigaldama ka libnitrokey.

Windows¶

Windowsi tugi on veel eksperimentaalne - palun kasutage seda ettevaatlikult.

Seadmega ühenduse loomiseks võib olla vajalik nitropy käivitamine administraatori õigustega.

Linux¶

Linuxi süsteemides on vaja ka Nitrokey udev-reegleid. Need tarnitakse koos libnitrokey. Alternatiivselt võite neid käsitsi paigaldada:

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

Vaata udev reeglite seadistamine lisateavet.

Usage of PIV features¶

Selleks, et kasutada nitropy PIV-funktsioone (nitropy nk3 piv), tuleb paigaldada ka pyscard sõltuvus:

pipx install pynitrokey[pcsc]

Järgmised sammud¶

Lisateavet nitroopia kasutamise kohta leiate nendest juhenditest: