Usage Guide¶
Nitrokey Python SDK understøtter i øjeblikket enhederne Nitrokey 3 (nitrokey.nk3.NK3) og Nitrokey Passkey (nitrokey.nkpk.NKPK). Begge enheder er baseret på den samme platform, Trussed, og deler derfor den samme basisklasse nitrokey.trussed.TrussedDevice.
Trussed-enheder kan genstartes i en bootloader-tilstand, der bruges til at anvende firmwareopdateringer. Enheder i bootloader-tilstand kan tilgås ved hjælp af nitrokey.nk3.NK3Bootloader og nitrokey.nkpk.NKPKBootloader (basisklasse 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}")
Hvis du kender den model, du vil oprette forbindelse til, kan du også bruge funktionerne list og open i modulerne nitrokey.nk3 eller nitrokey.nkpk. Hvis du også kender enhedens type, kan du bruge metoderne list og open i klasserne nitrokey.nk3.NK3, nitrokey.nkpk.NKPK, nitrokey.nk3.NK3Bootloader og nitrokey.nkpk.NKPKBootloader.
Using Applications¶
Nitrokey Python SDK understøtter disse applikationer for alle Trussed-enheder:
nitrokey.trussed.admin_app.AdminApp: Få adgang til enhedens metadata og administrer enhedens konfigurationstilstandnitrokey.trussed.provisioner_app.ProvisionerApp: opsæt enhed i provisioner-tilstand (gælder kun for Hacker-enheder)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: sikker opbevaring af adgangskoder og legitimationsoplysninger
Se API-referencen for applikationsklasserne for mere information.