Instalação de nitropia Com pipx¶

Este guia explica como instalar a nitropia com pipx. pipx cria um ambiente virtual para a nitropia. Isto significa que a nitropia e as suas dependências não entram em conflito com outros pacotes instalados no seu sistema.

Nota

Para utilizadores de Windows: O suporte de Windows ainda é experimental – por favor use com cautela. Também pode utilizar binários pré-compilados ou um instalador MSI, ver :doc:`…/windows/installation”.

Installation on Linux¶

Fedora¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Depois de terminar a sessão ou reiniciar o sistema, a nitropia estará agora disponível.

Arco¶

Pode instalar o nitropia juntamente com todas as outras dependências necessárias utilizando:

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

Se já tiver instalado o Python no seu sistema, pode simplesmente executar:

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

Depois de terminar a sessão ou reiniciar o sistema, a nitropia estará agora disponível.

Instalação noutros sistemas de distribuição/operacionais¶

Preparação¶

Python 3.9, 3.10 or 3.11¶

Python já está instalado na maioria dos sistemas MacOS e Linux ou pode ser descarregado de python.org. Ver o Downloading Python Guide para mais informações.

pip¶

Pode instalar pip com o seu gestor de pacotes do sistema ou com python3 -m ensurepip`. Ver o guia de instalação de pip para mais informações.

pipx¶

Antes de instalar a nitropia, é necessário instalar e configurar o pipx:

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

See the pipx Installation Guide for more information.

Nota

Para utilizadores Linux - atualmente uma dependência transitória (oscrypto) está a gerar problemas em algumas distribuições Linux. A respectiva questão GitHub documenta a solução atualmente necessária:

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

Instalação¶

Agora pode instalar nitropia a partir do pacote pynitrokey:

pipx install pynitrokey

a nitropia está agora disponível no seu caminho:

nitropy --help

Actualização¶

Pode actualizar o pacote com o seguinte comando:

pipx upgrade pynitrokey

Resolução de problemas¶

Se encontrar problemas, certifique-se de que utiliza a versão mais recente comparando a saída de >>x id=»105»></x>>x id=»120»></x> com a release list no GitHub. Se uma actualização não instalar a versão mais recente, pode estar a deparar-se com um dos seguintes problemas.

Alteração do armazenamento do certificado pessoal do utilizador com <x id=»57»></x>`<x id=»59»></x><x id=»98»></x>`.¶

nitropy requires Python 3.9 or 3.10. If your default Python installation is older or newer than that and cannot be updated, you have to additionally install Python 3.9 and specify the name of its Python executable when calling pipx, for example:

$ pipx install --python python3.9 pynitrokey

libusb-1.0.dylib não encontrado¶

Ao executar o nitropia no macOS, poderá ver uma mensagem de erro indicando um ficheiro libusb-1.0.dylib em falta. Isso pode ser corrigido instalando manualmente o libusb, por exemplo, com homebrew:

$ brew install libusb

Notas de utilização¶

Todas as Plataformas¶

Se quiser usar nitropia com um dispositivo Nitrokey Pro ou Nitrokey Storage, também tem de instalar libnitrokey.

Windows¶

O suporte do Windows ainda é experimental – por favor use com cuidado.

Poderá ter de executar nitropia com direitos de administrador para se poder ligar a um dispositivo.

Linux¶

Nos sistemas Linux, também precisa das regras da Nitrokey udev. Estas são enviadas com libnitrokey. Em alternativa, pode instalá-las 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/

Ver …/linux/udev para mais informações.

Usage of PIV features¶

Para poder utilizar a funcionalidade PIV da nitropia (nitropy nk3 piv), é necessário instalar também a dependência pyscard:

pipx install pynitrokey[pcsc]

Próximos Passos¶

Pode encontrar mais informações sobre a utilização da nitropia nestes guias: