Usage Guide¶
A Nitrokey Python SDK jelenleg támogatja a Nitrokey 3 (nitrokey.nk3.NK3.NK3
) és a Nitrokey Passkey (nitrokey.nkpk.NKPK
) eszközöket. Mindkét eszköz ugyanazon a platformon, a Trussed-en alapul, ezért ugyanaz az alaposztály nitrokey.trussed.TrussedDevice
.
A fürtözött eszközök újraindíthatók bootloader üzemmódba, amely a firmware-frissítések alkalmazására szolgál. A bootloader módban lévő eszközök a nitrokey.nk3.NK3Bootloader
és nitrokey.nkpk.NKPKBootloader
(alaposztály nitrokey.trussed.TrussedBootloader
) segítségével érhetők el.
Listing and Opening Devices¶
A nitrokey.trussed.TrussedDevice.list()
függvényt használd az összes csatlakoztatott eszköz listázásához és megnyitásához:
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}")
Ha ismered az eszköz elérési útvonalát, használd helyette a nitrokey.trussed.TrussedDevice.open()
parancsot:
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}")
Hasonló funkciók állnak rendelkezésre a nitrokey.nk3.NK3Bootloader
és a nitrokey.nkpk.NKPKBootloader
esetében. A normál és a bootloader eszközök listázásához használja a nitrokey.nk3.list()
és a nitrokey.nkpk.list()
parancsokat.
Megjegyzés
Jelenleg a nitrokey.trussed.TrussedDevice.list()
, nitrokey.nk3.list()
és nitrokey.nkpk.list()
által visszaadott eszközök csak a függvények bármelyikének következő hívásáig érvényesek. További információért lásd 31. kiadás.
Using Applications¶
A Nitrokey Python SDK támogatja ezeket az alkalmazásokat az összes Trussed eszközhöz:
nitrokey.trussed.admin_app.AdminApp
: hozzáférés az eszköz metaadataihoz és az eszköz konfigurációs állapotának kezelése.nitrokey.trussed.provisioner_app.ProvisionerApp
: eszköz beállítása provisioner módban (csak Hacker eszközökre alkalmazható)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp
: jelszavak és hitelesítő adatok biztonságos tárolása
További információkért lásd az alkalmazási osztályok API-hivatkozását.