Usage Guide¶
Nitrokey Python SDK v současnosti podporuje zařízení Nitrokey 3 (nitrokey.nk3.NK3) a Nitrokey Passkey (nitrokey.nkpk.NKPK). Obě zařízení jsou založena na stejné platformě Trussed, a proto sdílejí stejnou základní třídu nitrokey.trussed.TrussedDevice.
Zařízení s příhradovým systémem lze restartovat do režimu zavaděče, který se používá k aktualizaci firmwaru. K zařízením v režimu zavaděče lze přistupovat pomocí nitrokey.nk3.NK3Bootloader a nitrokey.nkpk.NKPKBootloader (základní třída nitrokey.trussed.TrussedBootloader).
Listing and Opening Devices¶
Use the nitrokey.trussed.list() function to list and open all connected devices:
import nitrokey.trussed
print("Connected Nitrokey devices:")
for device in nitrokey.trussed.list():
print(f"- {device.name} at {device.path}")
If you know the device path, use nitrokey.trussed.open() instead:
import nitrokey.trussed
path = "/dev/hidraw1"
device = nitrokey.trussed.open(path)
if device is not None:
print(f"Found {device.name} at {path}")
else:
print(f"No device found at {path}")
Pokud znáte model, ke kterému se chcete připojit, můžete také použít funkce list a open v modulech nitrokey.nk3 nebo nitrokey.nkpk. Pokud znáte i typ zařízení, můžete použít metody list a open ve třídách nitrokey.nk3.NK3, nitrokey.nkpk.NKPK, nitrokey.nk3.NK3Bootloader a nitrokey.nkpk.NKPKBootloader.
Using Applications¶
Nitrokey Python SDK podporuje tyto aplikace pro všechna zařízení Trussed:
nitrokey.trussed.admin_app.AdminApp: přístup k metadatům zařízení a správa stavu konfigurace zařízenínitrokey.trussed.provisioner_app.ProvisionerApp: nastavení zařízení v režimu provisioner (platí pouze pro zařízení Hacker)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: bezpečné ukládání hesel a pověření
Další informace naleznete v referenci API pro třídy aplikací.