nitrokey.trussed¶

Submodules

Αντικείμενα συσκευής με δέστρες¶

class nitrokey.trussed.TrussedBase¶

Βασική κλάση για συσκευές Nitrokey που χρησιμοποιούν το πλαίσιο Trussed και εκτελούν το firmware ή τον bootloader.

abstract close()¶

Επιστρεφόμενος τύπος:: None

abstract reboot()¶

Επιστρεφόμενος τύπος:: bool

abstract uuid()¶

Επιστρεφόμενος τύπος:: Uuid | None

abstract property model: Model¶

abstract property name: str¶

abstract property path: str¶

abstract property pid: int¶

property vid: int¶

class nitrokey.trussed.TrussedDevice¶

Βάσεις: TrussedBase

__init__(device, fido2_certs)¶

Παράμετροι:

device (CtapHidDevice)
fido2_certs (Sequence[Fido2Certs])

Επιστρεφόμενος τύπος:

None

close()¶

Επιστρεφόμενος τύπος:: None

abstract classmethod from_device(device)¶

Παράμετροι:: device (CtapHidDevice)
Επιστρεφόμενος τύπος:: T

abstract classmethod list()¶

Επιστρεφόμενος τύπος:: List[T]

classmethod open(path)¶

Παράμετροι:: path (str)
Επιστρεφόμενος τύπος:: T | None

reboot()¶

Επιστρεφόμενος τύπος:: bool

uuid()¶

Επιστρεφόμενος τύπος:: Uuid | None

wink()¶

Επιστρεφόμενος τύπος:: None

property path: str¶

class nitrokey.trussed.TrussedBootloader¶

Βάσεις: TrussedBase

abstract update(image, callback=None)¶

Παράμετροι:

image (bytes)
callback (Callable[[int, int], None] | None)

Επιστρεφόμενος τύπος:

None

abstract property variant: Variant¶

Update Container Objects¶

nitrokey.trussed.parse_firmware_image(variant, data, model)¶

Παράμετροι:

variant (Variant)
data (bytes)
model (Model)

Επιστρεφόμενος τύπος:

FirmwareMetadata

class nitrokey.trussed.FirmwareContainer¶

FirmwareContainer(version: nitrokey.trussed._utils.Version, pynitrokey: Optional[nitrokey.trussed._utils.Version], sdk: Optional[nitrokey.trussed._utils.Version], images: Dict[nitrokey.trussed._bootloader.Variant, bytes])

__init__(version, pynitrokey, sdk, images)¶

Παράμετροι:

version (Version)
pynitrokey (Version | None)
sdk (Version | None)
images (Dict[Variant, bytes])

Επιστρεφόμενος τύπος:

None

classmethod parse(path, model)¶

Παράμετροι:

path (str | BytesIO)
model (Model)

Επιστρεφόμενος τύπος:

FirmwareContainer

images: Dict[Variant, bytes]¶

pynitrokey: Version | None¶

sdk: Version | None¶

version: Version¶

class nitrokey.trussed.FirmwareMetadata¶

FirmwareMetadata(version: Nitrokey.trussed._utils.Version, signed_by: Optional[str] = None, signed_by_nitrokey: bool = False)

__init__(version, signed_by=None, signed_by_nitrokey=False)¶

Παράμετροι:

version (Version)
signed_by (str | None)
signed_by_nitrokey (bool)

Επιστρεφόμενος τύπος:

None

signed_by: str | None = None¶

signed_by_nitrokey: bool = False¶

version: Version¶

class nitrokey.trussed.Variant¶

Βάσεις: Enum

classmethod from_str(s)¶

Παράμετροι:: s (str)
Επιστρεφόμενος τύπος:: Variant

LPC55 = 'lpc55'¶

NRF52 = 'nrf52'¶

Αντικείμενα κοινής ωφέλειας¶

class nitrokey.trussed.App¶

Βάσεις: Enum

Εντολές CTAPHID ειδικά για τον προμηθευτή για εφαρμογές Trussed.

ADMIN = 114¶

PROVISIONER = 113¶

SECRETS = 112¶

class nitrokey.trussed.Fido2Certs¶

Fido2Certs(start: Nitrokey.trussed._utils.Version, hashes: list[str])

__init__(start, hashes)¶

Παράμετροι:

start (Version)
hashes (list[str])

Επιστρεφόμενος τύπος:

None

static get(certs, version)¶

Παράμετροι:

certs (Sequence[Fido2Certs])
version (Version)

Επιστρεφόμενος τύπος:

Fido2Certs | None

hashes: list[str]¶

start: Version¶

class nitrokey.trussed.Model¶

Βάσεις: Enum

classmethod from_str(s)¶

Παράμετροι:: s (str)
Επιστρεφόμενος τύπος:: Model

NK3 = 'Nitrokey 3'¶

NKPK = 'Nitrokey Passkey'¶

class nitrokey.trussed.Uuid¶

UUID of a Nitrokey Trussed device.

__init__(value)¶

Παράμετροι:: value (int)
Επιστρεφόμενος τύπος:: None

value: int¶

class nitrokey.trussed.Version¶

Η έκδοση μιας συσκευής Nitrokey Trussed, σύμφωνα με το Semantic Versioning 2.0.0.

Ορισμένες πηγές πληροφοριών για την έκδοση, δηλαδή η έκδοση που επιστρέφεται από παλαιότερες συσκευές και τα δυαδικά αρχεία υλικολογισμικού, δεν περιέχουν το στοιχείο προ-έκδοσης. Αυτές οι περιπτώσεις επισημαίνονται με complete=False. Αυτή η σημαία επηρεάζει τη σύγκριση: Η προ-έκδοση λαμβάνεται υπόψη μόνο εάν και οι δύο περιπτώσεις έκδοσης είναι πλήρεις.

>>> Version(1, 0, 0)
Version(major=1, minor=0, patch=0, pre=None, build=None)
>>> Version.from_str("1.0.0")
Version(major=1, minor=0, patch=0, pre=None, build=None)
>>> Version.from_v_str("v1.0.0")
Version(major=1, minor=0, patch=0, pre=None, build=None)
>>> Version(1, 0, 0, "rc.1")
Version(major=1, minor=0, patch=0, pre='rc.1', build=None)
>>> Version.from_str("1.0.0-rc.1")
Version(major=1, minor=0, patch=0, pre='rc.1', build=None)
>>> Version.from_v_str("v1.0.0-rc.1")
Version(major=1, minor=0, patch=0, pre='rc.1', build=None)
>>> Version.from_v_str("v1.0.0-rc.1+git")
Version(major=1, minor=0, patch=0, pre='rc.1', build='git')

__init__(major, minor, patch, pre=None, build=None, complete=False)¶

Παράμετροι:

major (int)
minor (int)
patch (int)
pre (str | None)
build (str | None)
complete (bool)

Επιστρεφόμενος τύπος:

None

core()¶

Επιστρέφει το βασικό μέρος αυτής της έκδοσης, δηλαδή την έκδοση χωρίς τα στοιχεία προ-έκδοσης και κατασκευής.

>>> Version(1, 0, 0).core()
Version(major=1, minor=0, patch=0, pre=None, build=None)
>>> Version(1, 0, 0, "rc.1").core()
Version(major=1, minor=0, patch=0, pre=None, build=None)
>>> Version(1, 0, 0, "rc.1", "git").core()
Version(major=1, minor=0, patch=0, pre=None, build=None)

Επιστρεφόμενος τύπος:: Version

classmethod from_int(version)¶

Παράμετροι:: version (int)
Επιστρεφόμενος τύπος:: Version

classmethod from_str(s)¶

Παράμετροι:: s (str)
Επιστρεφόμενος τύπος:: Version

classmethod from_v_str(s)¶

Παράμετροι:: s (str)
Επιστρεφόμενος τύπος:: Version

build: str | None = None¶

complete: bool = False¶

major: int¶

minor: int¶

patch: int¶

pre: str | None = None¶

Trussed Exceptions¶

class nitrokey.trussed.TrussedException¶: Βάσεις: Exception

class nitrokey.trussed.TimeoutException¶

Βάσεις: TrussedException

__init__()¶

Επιστρεφόμενος τύπος:: None