Usage Guide¶
Le SDK Nitrokey Python prend actuellement en charge les dispositifs Nitrokey 3 (nitrokey.nk3.NK3) et Nitrokey Passe-partout (nitrokey.nkpk.NKPK). Les deux appareils sont basés sur la même plateforme, Trussed, et partagent donc la même classe de base nitrokey.trussed.TrussedDevice.
Les appareils trussés peuvent être redémarrés en mode bootloader qui est utilisé pour appliquer les mises à jour du firmware. Les dispositifs en mode bootloader sont accessibles en utilisant nitrokey.nk3.NK3Bootloader et nitrokey.nkpk.NKPKBootloader (classe de base 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}")
Si vous connaissez le modèle auquel vous voulez vous connecter, vous pouvez aussi utiliser les fonctions list et open dans les modules nitrokey.nk3 ou nitrokey.nkpk. Si vous connaissez également le type du périphérique, vous pouvez utiliser les méthodes list et open des classes nitrokey.nk3.NK3, nitrokey.nkpk.NKPK, nitrokey.nk3.NK3Bootloader et nitrokey.nkpk.NKPKBootloader.
Using Applications¶
Le kit de développement logiciel Nitrokey Python prend en charge ces applications pour tous les dispositifs Trussed :
nitrokey.trussed.admin_app.AdminApp: accéder aux métadonnées de l’appareil et gérer l’état de configuration de l’appareilnitrokey.trussed.provisioner_app.ProvisionerApp: setup device in provisioner mode (only applicable for Hacker devices)
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: stocker en toute sécurité les mots de passe et les informations d’identification
Pour plus d’informations, voir la référence API des classes d’application.