Usage Guide¶
Понастоящем Nitrokey Python SDK поддържа устройства Nitrokey 3 (nitrokey.nk3.NK3) и Nitrokey Passkey (nitrokey.nkpk.NKPK). И двете устройства се основават на една и съща платформа - Trussed, и следователно споделят един и същ базов клас nitrokey.trussed.TrussedDevice.
Свързаните устройства могат да бъдат рестартирани в режим на зареждане, който се използва за прилагане на актуализации на фърмуера. Достъпът до устройствата в режим bootloader може да се осъществи с помощта на nitrokey.nk3.NK3Bootloader и nitrokey.nkpk.NKPKBootloader (базов клас 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}")
Ако знаете модела, към който искате да се свържете, можете да използвате и функциите list и open в модулите nitrokey.nk3 или nitrokey.nkpk. Ако знаете и типа на устройството, можете да използвате методите list и open на класовете nitrokey.nk3.NK3, nitrokey.nkpk.NKPK, nitrokey.nk3.NK3Bootloader и nitrokey.nkpk.NKPKBootloader.
Using Applications¶
Nitrokey Python SDK поддържа тези приложения за всички устройства с ферми:
nitrokey.trussed.admin_app.AdminApp: достъп до метаданните на устройството и управление на състоянието на конфигурацията на устройствотоnitrokey.trussed.provisioner_app.ProvisionerApp: настройка на устройството в режим на провизор (приложимо само за устройствата Hacker)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: сигурно съхранение на пароли и пълномощия
За повече информация вижте справката за API на класовете за приложения.