Usage Guide¶
В настоящее время Nitrokey Python SDK поддерживает устройства Nitrokey 3 (nitrokey.nk3.NK3) и Nitrokey Passkey (nitrokey.nkpk.NKPK). Оба устройства основаны на одной и той же платформе, Trussed, и поэтому имеют один и тот же базовый класс nitrokey.trussed.TrussedDevice.
Устройства с фермой могут быть перезагружены в режим загрузчика, который используется для применения обновлений прошивки. Доступ к устройствам в режиме загрузчика можно получить с помощью 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 поддерживает эти приложения для всех устройств Trussed:
nitrokey.trussed.admin_app.AdminApp: доступ к метаданным устройства и управление состоянием конфигурации устройстваnitrokey.trussed.provisioner_app.ProvisionerApp: настройка устройства в режиме провайдера (применимо только для устройств Hacker)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: безопасное хранение паролей и учетных данных
Дополнительные сведения см. в справочнике API для классов приложений.