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.