Usage Guide¶
De Nitrokey Python SDK ondersteunt momenteel Nitrokey 3 (nitrokey.nk3.NK3) en Nitrokey Passkey (nitrokey.nkpk.NKPK) apparaten. Beide apparaten zijn gebaseerd op hetzelfde platform, Trussed, en delen daarom dezelfde basisklasse nitrokey.trussed.TrussedDevice.
Apparaten met een truss kunnen opnieuw worden opgestart in een bootloadermodus die wordt gebruikt om firmware-updates toe te passen. Apparaten in bootloader-modus zijn toegankelijk met nitrokey.nk3.NK3Bootloader en 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}")
Als je weet met welk model je verbinding wilt maken, kun je ook de functies list en open in de modules nitrokey.nk3 of nitrokey.nkpk gebruiken. Als u ook het type van het apparaat kent, kunt u de methoden list en open van de klassen nitrokey.nk3.NK3, nitrokey.nkpk.NKPK, nitrokey.nk3.NK3Bootloader en nitrokey.nkpk.NKPKBootloader gebruiken.
Using Applications¶
De Nitrokey Python SDK ondersteunt deze toepassingen voor alle Trussed apparaten:
nitrokey.trussed.admin_app.AdminApp: toegang tot apparaatmetagegevens en beheer van apparaatconfiguratietoestandnitrokey.trussed.provisioner_app.ProvisionerApp: apparaat instellen in provisioner-modus (alleen van toepassing op Hacker-apparaten)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: veilig opslaan van wachtwoorden en referenties
Raadpleeg de API-referentie voor de applicatieklassen voor meer informatie.