Usage Guide

Nitrokey Python SDK acceptă în prezent dispozitivele Nitrokey 3 (nitrokey.nk3.NK3) și Nitrokey Passkey (nitrokey.nkpk.NKPK). Ambele dispozitive se bazează pe aceeași platformă, Trussed, și, prin urmare, împart aceeași clasă de bază nitrokey.trussed.TrussedDevice.

Dispozitivele Trussed pot fi repornite într-un mod bootloader care este utilizat pentru a aplica actualizări de firmware. Dispozitivele în modul bootloader pot fi accesate utilizând nitrokey.nk3.NK3Bootloader și nitrokey.nkpk.NKPKBootloader (clasa de bază nitrokey.trussed.TrussedBootloader).

Listing and Opening Devices

Utilizați funcția nitrokey.trussed.TrussedDevice.list() pentru a lista și deschide toate dispozitivele conectate:

from nitrokey.nk3 import NK3
from nitrokey.nkpk import NKPK

print("Connected Nitrokey devices:")
for device in NK3.list():
    print(f"- {device.name} at {device.path}")
for device in NKPK.list():
    print(f"- {device.name} at {device.path}")

Dacă știți calea dispozitivului, utilizați nitrokey.trussed.TrussedDevice.open() în loc:

from nitrokey.nk3 import NK3
from nitrokey.nkpk import NKPK

path = "/dev/hidraw1"
device = NK3.open(path)
if device is not None:
    print(f"Found {device.name} at {path}")
device = NKPK.open(path)
if device is not None:
    print(f"Found {device.name} at {path}")

Funcții similare sunt disponibile pentru nitrokey.nk3.NK3Bootloader și nitrokey.nkpk.NKPKBootloader. Pentru a lista atât dispozitivele normale, cât și cele cu bootloader, utilizați nitrokey.nk3.list() și nitrokey.nkpk.list().

Notă

În prezent, dispozitivele returnate de nitrokey.trussed.TrussedDevice.list(), nitrokey.nk3.list() și nitrokey.nkpk.list() sunt valabile numai până la următorul apel la oricare dintre aceste funcții. Pentru mai multe informații, consultați issue 31.

Using Applications

Nitrokey Python SDK suportă aceste aplicații pentru toate dispozitivele Trussed:

• nitrokey.trussed.admin_app.AdminApp: accesează metadatele dispozitivului și gestionează starea configurației dispozitivului

• nitrokey.trussed.provisioner_app.ProvisionerApp: configurați dispozitivul în modul de furnizare (aplicabil numai pentru dispozitivele Hacker)

The Nitrokey 3 also provides these applications:

• nitrokey.nk3.secrets_app.SecretsApp: stochează în siguranță parolele și acreditările

Consultați referința API pentru clasele de aplicații pentru mai multe informații.