Nitropyn asentaminen pipx:llä#

Tässä oppaassa kerrotaan, miten nitropy asennetaan pipx. pipx luo virtuaalisen ympäristön nitropylle. Tämä tarkoittaa, että nitropy ja sen riippuvuudet eivät ole ristiriidassa muiden järjestelmään asennettujen pakettien kanssa.

Muista

Windows-käyttäjille: Windows-tuki on vielä kokeellinen - käytä sitä varoen. Voit myös käyttää valmiiksi käännettyjä binääripaketteja tai MSI-asennusohjelmaa, katso Nitropyn asentaminen Windowsissa.

Asennus Linuxiin#

Ubuntu, Debian#

Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:

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

Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.

Arch#

Voit asentaa nitropyn ja kaikki muut tarvittavat riippuvuudet käyttämällä:

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

Jos olet jo asentanut Pythonin järjestelmääsi, voit yksinkertaisesti ajaa:

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

Kun olet kirjautunut ulos tai käynnistänyt järjestelmän uudelleen, nitropy on nyt käytettävissä.

Asennus muihin jakelu-/käyttöjärjestelmiin#

Valmistelu#

Python 3.9, 3.10 tai 3.11.#

Python on jo asennettu useimpiin macOS- ja Linux-järjestelmiin tai sen voi ladata osoitteesta python.org. Katso lisätietoja Pythonin latausoppaasta.

pip#

Voit asentaa pipin järjestelmän paketinhallinnan avulla tai python3 -m ensurepip. Katso lisätietoja pipin asennusoppaasta.

pipx#

Ennen nitropyn asentamista sinun on asennettava ja konfiguroitava pipx:

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

Lisätietoja on osoitteessa pipx Installation Guide.

Muista

Linux-käyttäjille - tällä hetkellä väliaikainen riippuvuus (oscrypto) aiheuttaa ongelmia joissakin Linux-jakeluissa. Vastaava GitHub-ongelma dokumentoi tällä hetkellä tarvittavan ratkaisun:

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

Asennus#

Nyt voit asentaa nitropyn pynitrokey-paketista:

pipx install pynitrokey

nitropy on nyt saatavilla polussasi:

nitropy --help

Päivitys#

Voit päivittää paketin seuraavalla komennolla:

pipx upgrade pynitrokey

Vianmääritys#

Jos kohtaat ongelmia, varmista, että käytät uusinta versiota vertaamalla nitropy version:n tulosta julkaisuluetteloon GitHubissa. Jos päivitys ei asenna uusinta versiota, sinulla saattaa olla jokin seuraavista ongelmista.

Väärä Python-versio#

nitropy vaatii Python 3.9 tai 3.10. Jos oletusarvoinen Python-asennuksesi on vanhempi tai uudempi eikä sitä voi päivittää, sinun on lisäksi asennettava Python 3.9 ja määritettävä sen Python-ohjelman nimi, kun kutsut pipx:ää, esimerkiksi:

$ pipx install --python python3.9 pynitrokey

Käsivarsi Ei tuettu#

Tällä hetkellä viimeisimpiä nitropy-versioita ei voi asentaa Arm-alustoille riippuvuusongelman vuoksi (GitHub issue). Vaihtoehtona voit käyttää x86 Python-asennusta Rosetta-päätteessä, kuten on kuvattu tässä keskustelussa).

libusb-1.0.dylib ei löydy#

Kun käytät nitropy-ohjelmaa macOS:ssä, saatat nähdä virheilmoituksen, joka kertoo puuttuvasta libusb-1.0.dylib-tiedostosta. Tämä voidaan korjata asentamalla libusb manuaalisesti, esimerkiksi homebrew:

$ brew install libusb

Käyttöä koskevat huomautukset#

Kaikki alustat#

Jos haluat käyttää nitropyä Nitrokey Pro- tai Nitrokey Storage -laitteen kanssa, sinun on myös asennettava libnitrokey.

Windows#

Windows-tuki on vielä kokeellinen - käytä sitä varoen.

Sinun on ehkä suoritettava nitropy järjestelmänvalvojan oikeuksin voidaksesi muodostaa yhteyden laitteeseen.

Linux#

Linux-järjestelmissä tarvitset myös Nitrokey udev-säännöt. Nämä toimitetaan libnitrokey mukana. Vaihtoehtoisesti voit asentaa ne manuaalisesti:

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

Katso udev-sääntöjen määrittäminen lisätietoja.

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]

Seuraavat vaiheet#

Näistä oppaista löydät lisätietoja nitropian käytöstä: