Usage Guide¶
Nitrokey Python SDK trenutno podpira naprave Nitrokey 3 (nitrokey.nk3.NK3) in Nitrokey Passkey (nitrokey.nkpk.NKPK). Obe napravi temeljita na isti platformi, Trussed, in imata zato isti osnovni razred nitrokey.trussed.TrussedDevice.
Naprave z vezjo je mogoče ponovno zagnati v način zagonskega nalagalnika, ki se uporablja za uporabo posodobitev vdelane programske opreme. Do naprav v načinu bootloader lahko dostopate z uporabo nitrokey.nk3.NK3Bootloader in nitrokey.nkpk.NKPKBootloader (osnovni razred nitrokey.trussed.TrussedBootloader).
Listing and Opening Devices¶
Uporabite funkcijo nitrokey.trussed.TrussedDevice.list() za seznam in odprtje vseh povezanih naprav:
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}")
Če poznate pot do naprave, namesto tega uporabite 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}")
Podobne funkcije so na voljo za nitrokey.nk3.NK3Bootloader in nitrokey.nkpk.NKPKBootloader. Za seznam običajnih naprav in naprav z zagonskim nalagalnikom uporabite nitrokey.nk3.list() in nitrokey.nkpk.list().
Opomba
Trenutno so naprave, ki jih vrnejo funkcije nitrokey.trussed.TrussedDevice.list(), nitrokey.nk3.list() in nitrokey.nkpk.list(), veljavne le do naslednjega klica katere koli od teh funkcij. Za več informacij glejte številka 31.
Using Applications¶
Nitrokey Python SDK podpira te aplikacije za vse naprave Trussed:
nitrokey.trussed.admin_app.AdminApp: dostop do metapodatkov naprave in upravljanje stanja konfiguracije napravenitrokey.trussed.provisioner_app.ProvisionerApp: nastavitev naprave v načinu provisioner (velja samo za naprave Hacker)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: varno shranjevanje gesel in poverilnic
Za več informacij glejte referenco API za aplikacijske razrede.