Usage Guide¶
Nitrokey Python SDK tukee tällä hetkellä Nitrokey 3 (nitrokey.nk3.NK3) ja Nitrokey Passkey (nitrokey.nkpk.NKPK) laitteita. Molemmat laitteet perustuvat samaan alustaan, Trussediin, ja siksi niillä on sama perusluokka nitrokey.trussed.TrussedDevice.
Trussatut laitteet voidaan käynnistää uudelleen bootloader-tilaan, jota käytetään laiteohjelmistopäivitysten käyttöönotossa. Käynnistyslataustilassa olevia laitteita voidaan käyttää nitrokey.nk3.NK3Bootloader ja nitrokey.nkpk.NKPKBootloader (perusluokka 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}")
Jos tiedät mallin, johon haluat muodostaa yhteyden, voit myös käyttää funktioita list ja open moduuleissa nitrokey.nk3 tai nitrokey.nkpk. Jos tiedät myös laitteen tyypin, voit käyttää nitrokey.nk3.NK3-, nitrokey.nkpk.NKPK-, nitrokey.nk3.NK3.NK3Bootloader- ja nitrokey.nkpk.NKPKBootloader-luokkien metodeja list ja open.
Using Applications¶
Nitrokey Python SDK tukee näitä sovelluksia kaikille Trussed-laitteille:
nitrokey.trussed.admin_app.AdminApp: Pääsy laitteen metatietoihin ja laitteen konfiguraatiotilan hallinta.nitrokey.trussed.provisioner_app.ProvisionerApp: Laitteen asettaminen provisiointitilaan (koskee vain Hacker-laitteita).
The Nitrokey 3 also provides these applications:
nitrokey.nk3.secrets_app.SecretsApp: salasanojen ja tunnistetietojen turvallinen tallennus.
Lisätietoja on sovellusluokkien API-viitteessä.