Usage Guide

Nitrokey Python SDK toetab praegu Nitrokey 3 (nitrokey.nk3.NK3) ja Nitrokey Passkey (nitrokey.nkpk.NKPK) seadmeid. Mõlemad seadmed põhinevad samal platvormil, Trussed, ja seetõttu on neil sama baasklass nitrokey.trussed.TrussedDevice.

Trussitud seadmeid saab taaskäivitada alglaadimisrežiimi, mida kasutatakse püsivara uuenduste rakendamiseks. Laadimisrežiimis olevaid seadmeid saab kasutada nitrokey.nk3.NK3Bootloader ja nitrokey.nkpk.NKPKBootloader (baasklass nitrokey.trussed.TrussedBootloader).

Listing and Opening Devices

Kasutage nitrokey.trussed.TrussedDevice.list() funktsiooni, et loetleda ja avada kõik ühendatud seadmed:

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}")

Kui tead seadme tee, kasuta selle asemel nitrokey.trussed.TrussedDevice.open():

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}")

Sarnased funktsioonid on saadaval nitrokey.nk3.NK3Bootloader ja nitrokey.nkpk.NKPKBootloader jaoks. Nii tavaliste kui ka alglaadimisseadmete loetlemiseks kasutage nitrokey.nk3.list() ja nitrokey.nkpk.list().

Märkus

Praegu kehtivad nitrokey.trussed.TrussedDevice.list(), nitrokey.nk3.list() ja nitrokey.nkpk.list() poolt tagastatud seadmed ainult kuni nende funktsioonide järgmise väljakutsumiseni. Lisateavet vt issue 31.

Using Applications

Nitrokey Python SDK toetab neid rakendusi kõigi Trussed-seadmete puhul:

• nitrokey.trussed.admin_app.AdminApp: juurdepääs seadme metaandmetele ja seadme konfiguratsiooni oleku haldamine

• nitrokey.trussed.provisioner_app.ProvisionerApp: seadme seadistamine proviisorirežiimis (kehtib ainult Hacker-seadmete puhul)

The Nitrokey 3 also provides these applications:

• nitrokey.nk3.secrets_app.SecretsApp: paroolide ja volituste turvaline salvestamine.

Lisateavet leiate rakendusklasside API-viitedest.