nitrokey.trussed

Submodules

Santvariniai prietaisų objektai

class nitrokey.trussed.TrussedBase

Bazinė klasė, skirta „Nitrokey“ įrenginiams, naudojantiems „Trussed“ struktūrą ir naudojantiems programinę įrangą arba įkroviklį.

abstract close()
Grąžinamos reikšmės tipas:

None

abstract reboot()
Grąžinamos reikšmės tipas:

bool

abstract uuid()
Grąžinamos reikšmės tipas:

Uuid | None

abstract property name: str
abstract property path: str
abstract property pid: int
property vid: int
class nitrokey.trussed.TrussedDevice

Bazės: TrussedBase

__init__(device, fido2_certs)
Parametrai:

  • device (CtapHidDevice)

  • fido2_certs (Sequence[Fido2Certs])

Grąžinamos reikšmės tipas:

None

close()
Grąžinamos reikšmės tipas:

None

abstract classmethod from_device(device)
Parametrai:

device (CtapHidDevice)

Grąžinamos reikšmės tipas:

T

classmethod list()
Grąžinamos reikšmės tipas:

list[T]

classmethod open(path)
Parametrai:

path (str)

Grąžinamos reikšmės tipas:

T | None

reboot()
Grąžinamos reikšmės tipas:

bool

uuid()
Grąžinamos reikšmės tipas:

Uuid | None

wink()
Grąžinamos reikšmės tipas:

None

property path: str
class nitrokey.trussed.TrussedBootloader

Bazės: TrussedBase

abstract update(image, callback=None)
Parametrai:

  • image (bytes)

  • callback (Callable[[int, int], None] | None)

Grąžinamos reikšmės tipas:

None

abstract property variant: Variant

Update Container Objects

nitrokey.trussed.parse_firmware_image(variant, data, model)
Parametrai:
Grąžinamos reikšmės tipas:

FirmwareMetadata

class nitrokey.trussed.FirmwareContainer

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

__init__(version, pynitrokey, images)
Parametrai:
Grąžinamos reikšmės tipas:

None

classmethod parse(path, model)
Parametrai:

  • path (str | BytesIO)

  • model (Model)

Grąžinamos reikšmės tipas:

FirmwareContainer

images: Dict[Variant, bytes]
pynitrokey: 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)
Parametrai:

  • version (Version)

  • signed_by (str | None)

  • signed_by_nitrokey (bool)

Grąžinamos reikšmės tipas:

None

signed_by: str | None = None
signed_by_nitrokey: bool = False
version: Version
class nitrokey.trussed.Variant

Pagrindai: Enum

classmethod from_str(s)
Parametrai:

s (str)

Grąžinamos reikšmės tipas:

Variant

LPC55 = 'lpc55'
NRF52 = 'nrf52'

Komunaliniai objektai

class nitrokey.trussed.App

Pagrindai: Enum

Pardavėjui būdingos CTAPHID komandos, skirtos „Trussed“ programoms.

ADMIN = 114
PROVISIONER = 113
SECRETS = 112
class nitrokey.trussed.Fido2Certs

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

__init__(start, hashes)
Parametrai:

  • start (Version)

  • hashes (list[str])

Grąžinamos reikšmės tipas:

None

static get(certs, version)
Parametrai:
Grąžinamos reikšmės tipas:

Fido2Certs | None

hashes: list[str]
start: Version
class nitrokey.trussed.Model

Pagrindai: Enum

classmethod from_str(s)
Parametrai:

s (str)

Grąžinamos reikšmės tipas:

Model

NK3 = 'Nitrokey 3'
NKPK = 'Nitrokey Passkey'
property firmware_pattern: Pattern[str]
property firmware_repository: Repository
class nitrokey.trussed.Uuid

UUID of a Nitrokey Trussed device.

__init__(value)
Parametrai:

value (int)

Grąžinamos reikšmės tipas:

None

value: int
class nitrokey.trussed.Version

„Nitrokey Trussed“ įrenginio versija pagal semantinę versijų sistemą 2.0.0.

Kai kuriuose versijos informacijos šaltiniuose, t. y. senesnių prietaisų grąžinamoje versijoje ir programinės įrangos dvejetainėje programoje, nėra prieš išleidimą buvusio komponento. Šie atvejai pažymėti complete=False. Ši žyma turi įtakos palyginimui: Į versiją prieš išleidimą atsižvelgiama tik tuo atveju, jei abu versijos egzemplioriai yra išsamūs.

>>> 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)
Parametrai:

  • major (int)

  • minor (int)

  • patch (int)

  • pre (str | None)

  • build (str | None)

  • complete (bool)

Grąžinamos reikšmės tipas:

None

core()

Grąžina pagrindinę šios versijos dalį, t. y. versiją be išankstinio išleidimo ir surinkimo komponentų.

>>> 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)
Grąžinamos reikšmės tipas:

Version

classmethod from_int(version)
Parametrai:

version (int)

Grąžinamos reikšmės tipas:

Version

classmethod from_str(s)
Parametrai:

s (str)

Grąžinamos reikšmės tipas:

Version

classmethod from_v_str(s)
Parametrai:

s (str)

Grąžinamos reikšmės tipas:

Version

build: str | None = None
complete: bool = False
major: int
minor: int
patch: int
pre: str | None = None

Trussed Exceptions

class nitrokey.trussed.TrussedException

Pagrindai: Exception

class nitrokey.trussed.TimeoutException

Pagrindai: TrussedException

__init__()
Grąžinamos reikšmės tipas:

None