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

Brug funktionen nitrokey.trussed.TrussedDevice.list() til at liste og åbne alle tilsluttede enheder:

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}")

Hvis du kender enhedens sti, skal du bruge nitrokey.trussed.TrussedDevice.open() i stedet:

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}")

Lignende funktioner er tilgængelige for nitrokey.nk3.NK3Bootloader og nitrokey.nkpk.NKPKBootloader. For at liste både normale og bootloader-enheder skal du bruge nitrokey.nk3.list() og nitrokey.nkpk.list().

Bemærk

I øjeblikket er de enheder, der returneres af nitrokey.trussed.TrussedDevice.list(), nitrokey.nk3.list() og nitrokey.nkpk.list(), kun gyldige indtil det næste kald til en af disse funktioner. Se issue 31 for mere information.

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 konfigurationstilstand

• nitrokey.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.