derivepassphrase.git

src/derivepassphrase/exporter/vault_native.py          1) # SPDX-FileCopyrightText: 2024 Marco Ricci <software@the13thletter.info>

src/derivepassphrase/exporter/vault_v03_and_below.py   2) #
src/derivepassphrase/exporter/vault_v03_and_below.py   3) # SPDX-License-Identifier: MIT
src/derivepassphrase/exporter/vault_v03_and_below.py   4) 

src/derivepassphrase/exporter/vault_native.py          5) """Exporter for the vault native configuration format (v0.2 or v0.3).
src/derivepassphrase/exporter/vault_native.py          6) 
src/derivepassphrase/exporter/vault_native.py          7) The vault native formats are the configuration formats used by vault
src/derivepassphrase/exporter/vault_native.py          8) v0.2 and v0.3.  The configuration is stored as a single encrypted file,
src/derivepassphrase/exporter/vault_native.py          9) which is encrypted and authenticated.  v0.2 and v0.3 differ in some
src/derivepassphrase/exporter/vault_native.py         10) details concerning key derivation and expected format of internal
src/derivepassphrase/exporter/vault_native.py         11) structures, so they are *not* compatible.  v0.2 additionally contains
src/derivepassphrase/exporter/vault_native.py         12) cryptographic weaknesses (API misuse of a key derivation function, and
src/derivepassphrase/exporter/vault_native.py         13) a low-entropy method of generating initialization vectors for CBC block
src/derivepassphrase/exporter/vault_native.py         14) encryption mode) and should thus be avoided if possible.
src/derivepassphrase/exporter/vault_native.py         15) 
src/derivepassphrase/exporter/vault_native.py         16) The public interface is the
src/derivepassphrase/exporter/vault_native.py         17) [`derivepassphrase.exporter.vault_native.export_vault_native_data`][]
src/derivepassphrase/exporter/vault_native.py         18) function.  Multiple *non-public* classes are additionally documented
src/derivepassphrase/exporter/vault_native.py         19) here for didactical and educational reasons, but they are not part of
src/derivepassphrase/exporter/vault_native.py         20) the module API, are subject to change without notice (including
src/derivepassphrase/exporter/vault_native.py         21) removal), and should *not* be used or relied on.
src/derivepassphrase/exporter/vault_native.py         22) 
src/derivepassphrase/exporter/vault_native.py         23) """

src/derivepassphrase/exporter/vault_v03_and_below.py  24) 
src/derivepassphrase/exporter/vault_v03_and_below.py  25) from __future__ import annotations
src/derivepassphrase/exporter/vault_v03_and_below.py  26) 
src/derivepassphrase/exporter/vault_v03_and_below.py  27) import abc
src/derivepassphrase/exporter/vault_v03_and_below.py  28) import base64
src/derivepassphrase/exporter/vault_v03_and_below.py  29) import json
src/derivepassphrase/exporter/vault_v03_and_below.py  30) import logging
src/derivepassphrase/exporter/vault_v03_and_below.py  31) import warnings

src/derivepassphrase/exporter/vault_v03_and_below.py  32) from typing import TYPE_CHECKING
src/derivepassphrase/exporter/vault_v03_and_below.py  33) 
src/derivepassphrase/exporter/vault_v03_and_below.py  34) from derivepassphrase import exporter, vault
src/derivepassphrase/exporter/vault_v03_and_below.py  35) 
src/derivepassphrase/exporter/vault_v03_and_below.py  36) if TYPE_CHECKING:

src/derivepassphrase/exporter/vault_native.py         37)     from collections.abc import Sequence

src/derivepassphrase/exporter/vault_v03_and_below.py  38)     from typing import Any
src/derivepassphrase/exporter/vault_v03_and_below.py  39) 
src/derivepassphrase/exporter/vault_v03_and_below.py  40)     from typing_extensions import Buffer

src/derivepassphrase/exporter/vault_v03_and_below.py  41) 
src/derivepassphrase/exporter/vault_v03_and_below.py  42) if TYPE_CHECKING:
src/derivepassphrase/exporter/vault_v03_and_below.py  43)     from cryptography import exceptions as crypt_exceptions
src/derivepassphrase/exporter/vault_v03_and_below.py  44)     from cryptography import utils as crypt_utils
src/derivepassphrase/exporter/vault_v03_and_below.py  45)     from cryptography.hazmat.primitives import ciphers, hashes, hmac, padding
src/derivepassphrase/exporter/vault_v03_and_below.py  46)     from cryptography.hazmat.primitives.ciphers import algorithms, modes
src/derivepassphrase/exporter/vault_v03_and_below.py  47)     from cryptography.hazmat.primitives.kdf import pbkdf2
src/derivepassphrase/exporter/vault_v03_and_below.py  48) else:
src/derivepassphrase/exporter/vault_v03_and_below.py  49)     try:
src/derivepassphrase/exporter/vault_v03_and_below.py  50)         from cryptography import exceptions as crypt_exceptions
src/derivepassphrase/exporter/vault_v03_and_below.py  51)         from cryptography import utils as crypt_utils
src/derivepassphrase/exporter/vault_v03_and_below.py  52)         from cryptography.hazmat.primitives import (
src/derivepassphrase/exporter/vault_v03_and_below.py  53)             ciphers,
src/derivepassphrase/exporter/vault_v03_and_below.py  54)             hashes,
src/derivepassphrase/exporter/vault_v03_and_below.py  55)             hmac,
src/derivepassphrase/exporter/vault_v03_and_below.py  56)             padding,
src/derivepassphrase/exporter/vault_v03_and_below.py  57)         )
src/derivepassphrase/exporter/vault_v03_and_below.py  58)         from cryptography.hazmat.primitives.ciphers import algorithms, modes
src/derivepassphrase/exporter/vault_v03_and_below.py  59)         from cryptography.hazmat.primitives.kdf import pbkdf2
src/derivepassphrase/exporter/vault_v03_and_below.py  60)     except ModuleNotFoundError as exc:
src/derivepassphrase/exporter/vault_v03_and_below.py  61) 

src/derivepassphrase/exporter/vault_v03_and_below.py  62)         class _DummyModule:  # pragma: no cover

src/derivepassphrase/exporter/vault_v03_and_below.py  63)             def __init__(self, exc: type[Exception]) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py  64)                 self.exc = exc
src/derivepassphrase/exporter/vault_v03_and_below.py  65) 

src/derivepassphrase/exporter/vault_v03_and_below.py  66)             def __getattr__(self, name: str) -> Any:  # noqa: ANN401
src/derivepassphrase/exporter/vault_v03_and_below.py  67)                 def func(*args: Any, **kwargs: Any) -> Any:  # noqa: ANN401,ARG001

src/derivepassphrase/exporter/vault_v03_and_below.py  68)                     raise self.exc
src/derivepassphrase/exporter/vault_v03_and_below.py  69) 
src/derivepassphrase/exporter/vault_v03_and_below.py  70)                 return func
src/derivepassphrase/exporter/vault_v03_and_below.py  71) 

src/derivepassphrase/exporter/vault_v03_and_below.py  72)         crypt_exceptions = crypt_utils = _DummyModule(exc)
src/derivepassphrase/exporter/vault_v03_and_below.py  73)         ciphers = hashes = hmac = padding = _DummyModule(exc)
src/derivepassphrase/exporter/vault_v03_and_below.py  74)         algorithms = modes = pbkdf2 = _DummyModule(exc)

src/derivepassphrase/exporter/vault_v03_and_below.py  75)         STUBBED = True
src/derivepassphrase/exporter/vault_v03_and_below.py  76)     else:
src/derivepassphrase/exporter/vault_v03_and_below.py  77)         STUBBED = False

src/derivepassphrase/exporter/vault_v03_and_below.py  78) 

src/derivepassphrase/exporter/vault_native.py         79) __all__ = ('export_vault_native_data',)
src/derivepassphrase/exporter/vault_native.py         80) 

src/derivepassphrase/exporter/vault_v03_and_below.py  81) logger = logging.getLogger(__name__)
src/derivepassphrase/exporter/vault_v03_and_below.py  82) 
src/derivepassphrase/exporter/vault_v03_and_below.py  83) 
src/derivepassphrase/exporter/vault_v03_and_below.py  84) def _h(bs: bytes | bytearray) -> str:
src/derivepassphrase/exporter/vault_v03_and_below.py  85)     return 'bytes.fromhex({!r})'.format(bs.hex(' '))
src/derivepassphrase/exporter/vault_v03_and_below.py  86) 
src/derivepassphrase/exporter/vault_v03_and_below.py  87) 

src/derivepassphrase/exporter/vault_v03_and_below.py  88) class VaultNativeConfigParser(abc.ABC):

src/derivepassphrase/exporter/vault_v03_and_below.py  89)     """A base parser for vault's native configuration format.
src/derivepassphrase/exporter/vault_v03_and_below.py  90) 
src/derivepassphrase/exporter/vault_v03_and_below.py  91)     Certain details are specific to the respective vault versions, and
src/derivepassphrase/exporter/vault_v03_and_below.py  92)     are abstracted out.  This class by itself is not instantiable
src/derivepassphrase/exporter/vault_v03_and_below.py  93)     because of this.
src/derivepassphrase/exporter/vault_v03_and_below.py  94) 
src/derivepassphrase/exporter/vault_v03_and_below.py  95)     """
src/derivepassphrase/exporter/vault_v03_and_below.py  96) 

src/derivepassphrase/exporter/vault_v03_and_below.py  97)     def __init__(self, contents: Buffer, password: str | Buffer) -> None:

src/derivepassphrase/exporter/vault_v03_and_below.py  98)         """Initialize the parser.
src/derivepassphrase/exporter/vault_v03_and_below.py  99) 
src/derivepassphrase/exporter/vault_v03_and_below.py 100)         Args:
src/derivepassphrase/exporter/vault_v03_and_below.py 101)             contents:
src/derivepassphrase/exporter/vault_v03_and_below.py 102)                 The binary contents of the encrypted configuration file.
src/derivepassphrase/exporter/vault_v03_and_below.py 103) 
src/derivepassphrase/exporter/vault_v03_and_below.py 104)                 Note: On disk, these are usually stored in
src/derivepassphrase/exporter/vault_v03_and_below.py 105)                 base64-encoded form, not in the "raw" form as needed
src/derivepassphrase/exporter/vault_v03_and_below.py 106)                 here.
src/derivepassphrase/exporter/vault_v03_and_below.py 107) 
src/derivepassphrase/exporter/vault_v03_and_below.py 108)             password:
src/derivepassphrase/exporter/vault_v03_and_below.py 109)                 The vault master key/master passphrase the file is
src/derivepassphrase/exporter/vault_v03_and_below.py 110)                 encrypted with.  Must be non-empty.  See
src/derivepassphrase/exporter/vault_v03_and_below.py 111)                 [`derivepassphrase.exporter.get_vault_key`][] for
src/derivepassphrase/exporter/vault_v03_and_below.py 112)                 details.
src/derivepassphrase/exporter/vault_v03_and_below.py 113) 
src/derivepassphrase/exporter/vault_v03_and_below.py 114)                 If this is a text string, then the UTF-8 encoding of the
src/derivepassphrase/exporter/vault_v03_and_below.py 115)                 string is used as the binary password.
src/derivepassphrase/exporter/vault_v03_and_below.py 116) 

src/derivepassphrase/exporter/vault_native.py        117)         Warning:
src/derivepassphrase/exporter/vault_native.py        118)             Non-public class, provided for didactical and educational
src/derivepassphrase/exporter/vault_native.py        119)             purposes only. Subject to change without notice, including
src/derivepassphrase/exporter/vault_native.py        120)             removal.
src/derivepassphrase/exporter/vault_native.py        121) 

src/derivepassphrase/exporter/vault_v03_and_below.py 122)         """

src/derivepassphrase/exporter/vault_v03_and_below.py 123)         if not password:

src/derivepassphrase/exporter/vault_v03_and_below.py 124)             msg = 'Password must not be empty'

src/derivepassphrase/exporter/vault_v03_and_below.py 125)             raise ValueError(msg)  # noqa: DOC501

src/derivepassphrase/exporter/vault_v03_and_below.py 126)         self._contents = bytes(contents)

src/derivepassphrase/exporter/vault_v03_and_below.py 127)         self._iv_size = 0
src/derivepassphrase/exporter/vault_v03_and_below.py 128)         self._mac_size = 0
src/derivepassphrase/exporter/vault_v03_and_below.py 129)         self._encryption_key = b''
src/derivepassphrase/exporter/vault_v03_and_below.py 130)         self._encryption_key_size = 0
src/derivepassphrase/exporter/vault_v03_and_below.py 131)         self._signing_key = b''
src/derivepassphrase/exporter/vault_v03_and_below.py 132)         self._signing_key_size = 0
src/derivepassphrase/exporter/vault_v03_and_below.py 133)         self._message = b''
src/derivepassphrase/exporter/vault_v03_and_below.py 134)         self._message_tag = b''
src/derivepassphrase/exporter/vault_v03_and_below.py 135)         self._iv = b''
src/derivepassphrase/exporter/vault_v03_and_below.py 136)         self._payload = b''

src/derivepassphrase/exporter/vault_v03_and_below.py 137)         self._password = password
src/derivepassphrase/exporter/vault_v03_and_below.py 138)         self._sentinel: object = object()
src/derivepassphrase/exporter/vault_v03_and_below.py 139)         self._data: Any = self._sentinel
src/derivepassphrase/exporter/vault_v03_and_below.py 140) 

src/derivepassphrase/exporter/vault_v03_and_below.py 141)     def __call__(self) -> Any:  # noqa: ANN401
src/derivepassphrase/exporter/vault_v03_and_below.py 142)         """Return the decrypted and parsed vault configuration.
src/derivepassphrase/exporter/vault_v03_and_below.py 143) 
src/derivepassphrase/exporter/vault_v03_and_below.py 144)         Raises:
src/derivepassphrase/exporter/vault_v03_and_below.py 145)             cryptography.exceptions.InvalidSignature:
src/derivepassphrase/exporter/vault_v03_and_below.py 146)                 The encrypted configuration does not contain a valid
src/derivepassphrase/exporter/vault_v03_and_below.py 147)                 signature.
src/derivepassphrase/exporter/vault_v03_and_below.py 148)             ValueError:
src/derivepassphrase/exporter/vault_v03_and_below.py 149)                 The format is invalid, in a non-cryptographic way.  (For
src/derivepassphrase/exporter/vault_v03_and_below.py 150)                 example, it contains an unsupported version marker, or
src/derivepassphrase/exporter/vault_v03_and_below.py 151)                 unexpected extra contents, or invalid padding.)
src/derivepassphrase/exporter/vault_v03_and_below.py 152) 
src/derivepassphrase/exporter/vault_v03_and_below.py 153)         """

src/derivepassphrase/exporter/vault_v03_and_below.py 154)         if self._data is self._sentinel:
src/derivepassphrase/exporter/vault_v03_and_below.py 155)             self._parse_contents()
src/derivepassphrase/exporter/vault_v03_and_below.py 156)             self._derive_keys()
src/derivepassphrase/exporter/vault_v03_and_below.py 157)             self._check_signature()
src/derivepassphrase/exporter/vault_v03_and_below.py 158)             self._data = self._decrypt_payload()

src/derivepassphrase/exporter/vault_v03_and_below.py 159)         return self._data
src/derivepassphrase/exporter/vault_v03_and_below.py 160) 
src/derivepassphrase/exporter/vault_v03_and_below.py 161)     @staticmethod

src/derivepassphrase/exporter/vault_v03_and_below.py 162)     def _pbkdf2(

src/derivepassphrase/exporter/vault_v03_and_below.py 163)         password: str | Buffer, key_size: int, iterations: int

src/derivepassphrase/exporter/vault_v03_and_below.py 164)     ) -> bytes:
src/derivepassphrase/exporter/vault_v03_and_below.py 165)         if isinstance(password, str):
src/derivepassphrase/exporter/vault_v03_and_below.py 166)             password = password.encode('utf-8')
src/derivepassphrase/exporter/vault_v03_and_below.py 167)         raw_key = pbkdf2.PBKDF2HMAC(

src/derivepassphrase/exporter/vault_v03_and_below.py 168)             algorithm=hashes.SHA1(),

src/derivepassphrase/exporter/vault_v03_and_below.py 169)             length=key_size // 2,
src/derivepassphrase/exporter/vault_v03_and_below.py 170)             salt=vault.Vault._UUID,  # noqa: SLF001
src/derivepassphrase/exporter/vault_v03_and_below.py 171)             iterations=iterations,

src/derivepassphrase/exporter/vault_v03_and_below.py 172)         ).derive(bytes(password))

src/derivepassphrase/exporter/vault_v03_and_below.py 173)         logger.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 174)             'binary = pbkdf2(%s, %s, %s, %s, %s) = %s -> %s',
src/derivepassphrase/exporter/vault_v03_and_below.py 175)             repr(password),
src/derivepassphrase/exporter/vault_v03_and_below.py 176)             repr(vault.Vault._UUID),  # noqa: SLF001
src/derivepassphrase/exporter/vault_v03_and_below.py 177)             iterations,
src/derivepassphrase/exporter/vault_v03_and_below.py 178)             key_size // 2,
src/derivepassphrase/exporter/vault_v03_and_below.py 179)             repr('sha1'),
src/derivepassphrase/exporter/vault_v03_and_below.py 180)             _h(raw_key),
src/derivepassphrase/exporter/vault_v03_and_below.py 181)             _h(raw_key.hex().lower().encode('ASCII')),
src/derivepassphrase/exporter/vault_v03_and_below.py 182)         )
src/derivepassphrase/exporter/vault_v03_and_below.py 183)         return raw_key.hex().lower().encode('ASCII')
src/derivepassphrase/exporter/vault_v03_and_below.py 184) 
src/derivepassphrase/exporter/vault_v03_and_below.py 185)     def _parse_contents(self) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py 186)         logger.info('Parsing IV, payload and signature from the file contents')
src/derivepassphrase/exporter/vault_v03_and_below.py 187) 

src/derivepassphrase/exporter/vault_v03_and_below.py 188)         if len(self._contents) < self._iv_size + 16 + self._mac_size:

src/derivepassphrase/exporter/vault_v03_and_below.py 189)             msg = 'Invalid vault configuration file: file is truncated'

src/derivepassphrase/exporter/vault_v03_and_below.py 190)             raise ValueError(msg)
src/derivepassphrase/exporter/vault_v03_and_below.py 191) 

src/derivepassphrase/exporter/vault_v03_and_below.py 192)         def cut(buffer: bytes, cutpoint: int) -> tuple[bytes, bytes]:
src/derivepassphrase/exporter/vault_v03_and_below.py 193)             return buffer[:cutpoint], buffer[cutpoint:]
src/derivepassphrase/exporter/vault_v03_and_below.py 194) 

src/derivepassphrase/exporter/vault_v03_and_below.py 195)         cutpos1 = len(self._contents) - self._mac_size
src/derivepassphrase/exporter/vault_v03_and_below.py 196)         cutpos2 = self._iv_size

src/derivepassphrase/exporter/vault_v03_and_below.py 197) 

src/derivepassphrase/exporter/vault_v03_and_below.py 198)         self._message, self._message_tag = cut(self._contents, cutpos1)
src/derivepassphrase/exporter/vault_v03_and_below.py 199)         self._iv, self._payload = cut(self._message, cutpos2)

src/derivepassphrase/exporter/vault_v03_and_below.py 200) 
src/derivepassphrase/exporter/vault_v03_and_below.py 201)         logger.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 202)             'buffer %s = [[%s, %s], %s]',

src/derivepassphrase/exporter/vault_v03_and_below.py 203)             _h(self._contents),

src/derivepassphrase/exporter/vault_v03_and_below.py 204)             _h(self._iv),
src/derivepassphrase/exporter/vault_v03_and_below.py 205)             _h(self._payload),
src/derivepassphrase/exporter/vault_v03_and_below.py 206)             _h(self._message_tag),

src/derivepassphrase/exporter/vault_v03_and_below.py 207)         )
src/derivepassphrase/exporter/vault_v03_and_below.py 208) 
src/derivepassphrase/exporter/vault_v03_and_below.py 209)     def _derive_keys(self) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py 210)         logger.info('Deriving an encryption and signing key')
src/derivepassphrase/exporter/vault_v03_and_below.py 211)         self._generate_keys()
src/derivepassphrase/exporter/vault_v03_and_below.py 212)         assert (

src/derivepassphrase/exporter/vault_v03_and_below.py 213)             len(self._encryption_key) == self._encryption_key_size

src/derivepassphrase/exporter/vault_v03_and_below.py 214)         ), 'Derived encryption key is invalid'

src/derivepassphrase/exporter/vault_v03_and_below.py 215)         assert (

src/derivepassphrase/exporter/vault_v03_and_below.py 216)             len(self._signing_key) == self._signing_key_size

src/derivepassphrase/exporter/vault_v03_and_below.py 217)         ), 'Derived signing key is invalid'

src/derivepassphrase/exporter/vault_v03_and_below.py 218) 
src/derivepassphrase/exporter/vault_v03_and_below.py 219)     @abc.abstractmethod
src/derivepassphrase/exporter/vault_v03_and_below.py 220)     def _generate_keys(self) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py 221)         raise AssertionError
src/derivepassphrase/exporter/vault_v03_and_below.py 222) 
src/derivepassphrase/exporter/vault_v03_and_below.py 223)     def _check_signature(self) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py 224)         logger.info('Checking HMAC signature')

src/derivepassphrase/exporter/vault_v03_and_below.py 225)         mac = hmac.HMAC(self._signing_key, hashes.SHA256())

src/derivepassphrase/exporter/vault_v03_and_below.py 226)         mac_input = self._hmac_input()
src/derivepassphrase/exporter/vault_v03_and_below.py 227)         logger.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 228)             'mac_input = %s, expected_tag = %s',
src/derivepassphrase/exporter/vault_v03_and_below.py 229)             _h(mac_input),

src/derivepassphrase/exporter/vault_v03_and_below.py 230)             _h(self._message_tag),

src/derivepassphrase/exporter/vault_v03_and_below.py 231)         )
src/derivepassphrase/exporter/vault_v03_and_below.py 232)         mac.update(mac_input)
src/derivepassphrase/exporter/vault_v03_and_below.py 233)         try:

src/derivepassphrase/exporter/vault_v03_and_below.py 234)             mac.verify(self._message_tag)

src/derivepassphrase/exporter/vault_v03_and_below.py 235)         except crypt_exceptions.InvalidSignature:

src/derivepassphrase/exporter/vault_v03_and_below.py 236)             msg = 'File does not contain a valid signature'

src/derivepassphrase/exporter/vault_v03_and_below.py 237)             raise ValueError(msg) from None
src/derivepassphrase/exporter/vault_v03_and_below.py 238) 
src/derivepassphrase/exporter/vault_v03_and_below.py 239)     @abc.abstractmethod
src/derivepassphrase/exporter/vault_v03_and_below.py 240)     def _hmac_input(self) -> bytes:
src/derivepassphrase/exporter/vault_v03_and_below.py 241)         raise AssertionError
src/derivepassphrase/exporter/vault_v03_and_below.py 242) 

src/derivepassphrase/exporter/vault_v03_and_below.py 243)     def _decrypt_payload(self) -> Any:  # noqa: ANN401

src/derivepassphrase/exporter/vault_v03_and_below.py 244)         decryptor = self._make_decryptor()
src/derivepassphrase/exporter/vault_v03_and_below.py 245)         padded_plaintext = bytearray()

src/derivepassphrase/exporter/vault_v03_and_below.py 246)         padded_plaintext.extend(decryptor.update(self._payload))

src/derivepassphrase/exporter/vault_v03_and_below.py 247)         padded_plaintext.extend(decryptor.finalize())
src/derivepassphrase/exporter/vault_v03_and_below.py 248)         logger.debug('padded plaintext = %s', _h(padded_plaintext))

src/derivepassphrase/exporter/vault_v03_and_below.py 249)         unpadder = padding.PKCS7(self._iv_size * 8).unpadder()

src/derivepassphrase/exporter/vault_v03_and_below.py 250)         plaintext = bytearray()
src/derivepassphrase/exporter/vault_v03_and_below.py 251)         plaintext.extend(unpadder.update(padded_plaintext))
src/derivepassphrase/exporter/vault_v03_and_below.py 252)         plaintext.extend(unpadder.finalize())
src/derivepassphrase/exporter/vault_v03_and_below.py 253)         logger.debug('plaintext = %s', _h(plaintext))

src/derivepassphrase/exporter/vault_v03_and_below.py 254)         return json.loads(plaintext)

src/derivepassphrase/exporter/vault_v03_and_below.py 255) 
src/derivepassphrase/exporter/vault_v03_and_below.py 256)     @abc.abstractmethod
src/derivepassphrase/exporter/vault_v03_and_below.py 257)     def _make_decryptor(self) -> ciphers.CipherContext:
src/derivepassphrase/exporter/vault_v03_and_below.py 258)         raise AssertionError
src/derivepassphrase/exporter/vault_v03_and_below.py 259) 
src/derivepassphrase/exporter/vault_v03_and_below.py 260) 

src/derivepassphrase/exporter/vault_v03_and_below.py 261) class VaultNativeV03ConfigParser(VaultNativeConfigParser):

src/derivepassphrase/exporter/vault_v03_and_below.py 262)     """A parser for vault's native configuration format (v0.3).
src/derivepassphrase/exporter/vault_v03_and_below.py 263) 
src/derivepassphrase/exporter/vault_v03_and_below.py 264)     This is the modern, pre-storeroom configuration format.
src/derivepassphrase/exporter/vault_v03_and_below.py 265) 

src/derivepassphrase/exporter/vault_native.py        266)     Warning:
src/derivepassphrase/exporter/vault_native.py        267)         Non-public class, provided for didactical and educational
src/derivepassphrase/exporter/vault_native.py        268)         purposes only. Subject to change without notice, including
src/derivepassphrase/exporter/vault_native.py        269)         removal.
src/derivepassphrase/exporter/vault_native.py        270) 

src/derivepassphrase/exporter/vault_v03_and_below.py 271)     """
src/derivepassphrase/exporter/vault_v03_and_below.py 272) 

src/derivepassphrase/exporter/vault_v03_and_below.py 273)     KEY_SIZE = 32
src/derivepassphrase/exporter/vault_v03_and_below.py 274) 

src/derivepassphrase/exporter/vault_native.py        275)     def __init__(self, *args: Any, **kwargs: Any) -> None:  # noqa: ANN401

src/derivepassphrase/exporter/vault_v03_and_below.py 276)         super().__init__(*args, **kwargs)

src/derivepassphrase/exporter/vault_v03_and_below.py 277)         self._iv_size = 16
src/derivepassphrase/exporter/vault_v03_and_below.py 278)         self._mac_size = 32

src/derivepassphrase/exporter/vault_v03_and_below.py 279) 

src/derivepassphrase/exporter/vault_native.py        280)     def __call__(self) -> Any:  # noqa: ANN401

src/derivepassphrase/exporter/vault_v03_and_below.py 281)         if self._data is self._sentinel:
src/derivepassphrase/exporter/vault_v03_and_below.py 282)             logger.info('Attempting to parse as v0.3 configuration')
src/derivepassphrase/exporter/vault_v03_and_below.py 283)             return super().__call__()
src/derivepassphrase/exporter/vault_v03_and_below.py 284)         return self._data

src/derivepassphrase/exporter/vault_v03_and_below.py 285) 
src/derivepassphrase/exporter/vault_v03_and_below.py 286)     def _generate_keys(self) -> None:

src/derivepassphrase/exporter/vault_v03_and_below.py 287)         self._encryption_key = self._pbkdf2(self._password, self.KEY_SIZE, 100)
src/derivepassphrase/exporter/vault_v03_and_below.py 288)         self._signing_key = self._pbkdf2(self._password, self.KEY_SIZE, 200)
src/derivepassphrase/exporter/vault_v03_and_below.py 289)         self._encryption_key_size = self._signing_key_size = self.KEY_SIZE

src/derivepassphrase/exporter/vault_v03_and_below.py 290) 
src/derivepassphrase/exporter/vault_v03_and_below.py 291)     def _hmac_input(self) -> bytes:

src/derivepassphrase/exporter/vault_v03_and_below.py 292)         return self._message.hex().lower().encode('ASCII')

src/derivepassphrase/exporter/vault_v03_and_below.py 293) 
src/derivepassphrase/exporter/vault_v03_and_below.py 294)     def _make_decryptor(self) -> ciphers.CipherContext:
src/derivepassphrase/exporter/vault_v03_and_below.py 295)         return ciphers.Cipher(

src/derivepassphrase/exporter/vault_v03_and_below.py 296)             algorithms.AES256(self._encryption_key), modes.CBC(self._iv)

src/derivepassphrase/exporter/vault_v03_and_below.py 297)         ).decryptor()
src/derivepassphrase/exporter/vault_v03_and_below.py 298) 
src/derivepassphrase/exporter/vault_v03_and_below.py 299) 

src/derivepassphrase/exporter/vault_v03_and_below.py 300) class VaultNativeV02ConfigParser(VaultNativeConfigParser):

src/derivepassphrase/exporter/vault_v03_and_below.py 301)     """A parser for vault's native configuration format (v0.2).
src/derivepassphrase/exporter/vault_v03_and_below.py 302) 
src/derivepassphrase/exporter/vault_v03_and_below.py 303)     This is the classic configuration format.  Compared to v0.3, it
src/derivepassphrase/exporter/vault_v03_and_below.py 304)     contains an (accidental) API misuse for the generation of the master
src/derivepassphrase/exporter/vault_v03_and_below.py 305)     keys, a low-entropy method of generating initialization vectors for
src/derivepassphrase/exporter/vault_v03_and_below.py 306)     the AES-CBC encryption step, and extra layers of base64 encoding.
src/derivepassphrase/exporter/vault_v03_and_below.py 307)     Because of these significantly weakened confidentiality guarantees,
src/derivepassphrase/exporter/vault_v03_and_below.py 308)     v0.2 configurations should be upgraded to at least v0.3 as soon as
src/derivepassphrase/exporter/vault_v03_and_below.py 309)     possible.

src/derivepassphrase/exporter/vault_v03_and_below.py 310) 

src/derivepassphrase/exporter/vault_native.py        311)     Warning:
src/derivepassphrase/exporter/vault_native.py        312)         Non-public class, provided for didactical and educational
src/derivepassphrase/exporter/vault_native.py        313)         purposes only. Subject to change without notice, including
src/derivepassphrase/exporter/vault_native.py        314)         removal.
src/derivepassphrase/exporter/vault_native.py        315) 

src/derivepassphrase/exporter/vault_v03_and_below.py 316)     """
src/derivepassphrase/exporter/vault_v03_and_below.py 317) 

src/derivepassphrase/exporter/vault_native.py        318)     def __init__(self, *args: Any, **kwargs: Any) -> None:  # noqa: ANN401

src/derivepassphrase/exporter/vault_v03_and_below.py 319)         super().__init__(*args, **kwargs)

src/derivepassphrase/exporter/vault_v03_and_below.py 320)         self._iv_size = 16
src/derivepassphrase/exporter/vault_v03_and_below.py 321)         self._mac_size = 64

src/derivepassphrase/exporter/vault_v03_and_below.py 322) 

src/derivepassphrase/exporter/vault_native.py        323)     def __call__(self) -> Any:  # noqa: ANN401

src/derivepassphrase/exporter/vault_v03_and_below.py 324)         if self._data is self._sentinel:
src/derivepassphrase/exporter/vault_v03_and_below.py 325)             logger.info('Attempting to parse as v0.2 configuration')
src/derivepassphrase/exporter/vault_v03_and_below.py 326)             return super().__call__()
src/derivepassphrase/exporter/vault_v03_and_below.py 327)         return self._data

src/derivepassphrase/exporter/vault_v03_and_below.py 328) 
src/derivepassphrase/exporter/vault_v03_and_below.py 329)     def _parse_contents(self) -> None:
src/derivepassphrase/exporter/vault_v03_and_below.py 330)         super()._parse_contents()
src/derivepassphrase/exporter/vault_v03_and_below.py 331)         logger.debug('Decoding payload (base64) and message tag (hex)')

src/derivepassphrase/exporter/vault_v03_and_below.py 332)         self._payload = base64.standard_b64decode(self._payload)
src/derivepassphrase/exporter/vault_v03_and_below.py 333)         self._message_tag = bytes.fromhex(self._message_tag.decode('ASCII'))

src/derivepassphrase/exporter/vault_v03_and_below.py 334) 
src/derivepassphrase/exporter/vault_v03_and_below.py 335)     def _generate_keys(self) -> None:

src/derivepassphrase/exporter/vault_v03_and_below.py 336)         self._encryption_key = self._pbkdf2(self._password, 8, 16)
src/derivepassphrase/exporter/vault_v03_and_below.py 337)         self._signing_key = self._pbkdf2(self._password, 16, 16)
src/derivepassphrase/exporter/vault_v03_and_below.py 338)         self._encryption_key_size = 8
src/derivepassphrase/exporter/vault_v03_and_below.py 339)         self._signing_key_size = 16

src/derivepassphrase/exporter/vault_v03_and_below.py 340) 
src/derivepassphrase/exporter/vault_v03_and_below.py 341)     def _hmac_input(self) -> bytes:

src/derivepassphrase/exporter/vault_v03_and_below.py 342)         return base64.standard_b64encode(self._message)

src/derivepassphrase/exporter/vault_v03_and_below.py 343) 
src/derivepassphrase/exporter/vault_v03_and_below.py 344)     def _make_decryptor(self) -> ciphers.CipherContext:

src/derivepassphrase/exporter/vault_v03_and_below.py 345)         def evp_bytestokey_md5_one_iteration_no_salt(
src/derivepassphrase/exporter/vault_v03_and_below.py 346)             data: bytes, key_size: int, iv_size: int

src/derivepassphrase/exporter/vault_v03_and_below.py 347)         ) -> tuple[bytes, bytes]:
src/derivepassphrase/exporter/vault_v03_and_below.py 348)             total_size = key_size + iv_size
src/derivepassphrase/exporter/vault_v03_and_below.py 349)             buffer = bytearray()
src/derivepassphrase/exporter/vault_v03_and_below.py 350)             last_block = b''

src/derivepassphrase/exporter/vault_v03_and_below.py 351)             salt = b''

src/derivepassphrase/exporter/vault_v03_and_below.py 352)             logging.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 353)                 (
src/derivepassphrase/exporter/vault_v03_and_below.py 354)                     'data = %s, salt = %s, key_size = %s, iv_size = %s, '
src/derivepassphrase/exporter/vault_v03_and_below.py 355)                     'buffer length = %s, buffer = %s'
src/derivepassphrase/exporter/vault_v03_and_below.py 356)                 ),
src/derivepassphrase/exporter/vault_v03_and_below.py 357)                 _h(data),
src/derivepassphrase/exporter/vault_v03_and_below.py 358)                 _h(salt),
src/derivepassphrase/exporter/vault_v03_and_below.py 359)                 key_size,
src/derivepassphrase/exporter/vault_v03_and_below.py 360)                 iv_size,
src/derivepassphrase/exporter/vault_v03_and_below.py 361)                 len(buffer),
src/derivepassphrase/exporter/vault_v03_and_below.py 362)                 _h(buffer),
src/derivepassphrase/exporter/vault_v03_and_below.py 363)             )
src/derivepassphrase/exporter/vault_v03_and_below.py 364)             while len(buffer) < total_size:
src/derivepassphrase/exporter/vault_v03_and_below.py 365)                 with warnings.catch_warnings():
src/derivepassphrase/exporter/vault_v03_and_below.py 366)                     warnings.simplefilter(
src/derivepassphrase/exporter/vault_v03_and_below.py 367)                         'ignore', crypt_utils.CryptographyDeprecationWarning
src/derivepassphrase/exporter/vault_v03_and_below.py 368)                     )

src/derivepassphrase/exporter/vault_v03_and_below.py 369)                     block = hashes.Hash(hashes.MD5())

src/derivepassphrase/exporter/vault_v03_and_below.py 370)                 block.update(last_block)
src/derivepassphrase/exporter/vault_v03_and_below.py 371)                 block.update(data)
src/derivepassphrase/exporter/vault_v03_and_below.py 372)                 block.update(salt)
src/derivepassphrase/exporter/vault_v03_and_below.py 373)                 last_block = block.finalize()
src/derivepassphrase/exporter/vault_v03_and_below.py 374)                 buffer.extend(last_block)
src/derivepassphrase/exporter/vault_v03_and_below.py 375)                 logging.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 376)                     'buffer length = %s, buffer = %s', len(buffer), _h(buffer)
src/derivepassphrase/exporter/vault_v03_and_below.py 377)                 )
src/derivepassphrase/exporter/vault_v03_and_below.py 378)             logging.debug(
src/derivepassphrase/exporter/vault_v03_and_below.py 379)                 'encryption_key = %s, iv = %s',
src/derivepassphrase/exporter/vault_v03_and_below.py 380)                 _h(buffer[:key_size]),
src/derivepassphrase/exporter/vault_v03_and_below.py 381)                 _h(buffer[key_size:total_size]),
src/derivepassphrase/exporter/vault_v03_and_below.py 382)             )
src/derivepassphrase/exporter/vault_v03_and_below.py 383)             return bytes(buffer[:key_size]), bytes(buffer[key_size:total_size])
src/derivepassphrase/exporter/vault_v03_and_below.py 384) 

src/derivepassphrase/exporter/vault_v03_and_below.py 385)         data = base64.standard_b64encode(self._iv + self._encryption_key)

src/derivepassphrase/exporter/vault_v03_and_below.py 386)         encryption_key, iv = evp_bytestokey_md5_one_iteration_no_salt(
src/derivepassphrase/exporter/vault_v03_and_below.py 387)             data, key_size=32, iv_size=16

src/derivepassphrase/exporter/vault_v03_and_below.py 388)         )
src/derivepassphrase/exporter/vault_v03_and_below.py 389)         return ciphers.Cipher(
src/derivepassphrase/exporter/vault_v03_and_below.py 390)             algorithms.AES256(encryption_key), modes.CBC(iv)
src/derivepassphrase/exporter/vault_v03_and_below.py 391)         ).decryptor()
src/derivepassphrase/exporter/vault_v03_and_below.py 392) 
src/derivepassphrase/exporter/vault_v03_and_below.py 393) 

src/derivepassphrase/exporter/vault_native.py        394) def export_vault_native_data(
src/derivepassphrase/exporter/vault_native.py        395)     contents: Buffer | None = None,
src/derivepassphrase/exporter/vault_native.py        396)     key: str | Buffer | None = None,
src/derivepassphrase/exporter/vault_native.py        397)     *,
src/derivepassphrase/exporter/vault_native.py        398)     try_formats: Sequence[str] = ('v0.3', 'v0.2'),
src/derivepassphrase/exporter/vault_native.py        399) ) -> Any:  # noqa: ANN401
src/derivepassphrase/exporter/vault_native.py        400)     """Export the full configuration stored in vault native format.
src/derivepassphrase/exporter/vault_native.py        401) 
src/derivepassphrase/exporter/vault_native.py        402)     Args:
src/derivepassphrase/exporter/vault_native.py        403)         contents:
src/derivepassphrase/exporter/vault_native.py        404)             The binary encrypted contents of the vault configuration
src/derivepassphrase/exporter/vault_native.py        405)             file.  If not given, then query
src/derivepassphrase/exporter/vault_native.py        406)             [`derivepassphrase.exporter.get_vault_path`][] for the
src/derivepassphrase/exporter/vault_native.py        407)             correct filename and read the contents from there.
src/derivepassphrase/exporter/vault_native.py        408) 
src/derivepassphrase/exporter/vault_native.py        409)             Note: On disk, these are usually stored in base64-encoded
src/derivepassphrase/exporter/vault_native.py        410)             form, not in the "raw" form as needed here.
src/derivepassphrase/exporter/vault_native.py        411)         key:
src/derivepassphrase/exporter/vault_native.py        412)             Encryption key/password for the configuration file, usually
src/derivepassphrase/exporter/vault_native.py        413)             the username, or passed via the `VAULT_KEY` environment
src/derivepassphrase/exporter/vault_native.py        414)             variable.  If not given, then query
src/derivepassphrase/exporter/vault_native.py        415)             [`derivepassphrase.exporter.get_vault_key`][] for the value.
src/derivepassphrase/exporter/vault_native.py        416)         try_formats:
src/derivepassphrase/exporter/vault_native.py        417)             A sequence of formats to try out, in order.  Each key must
src/derivepassphrase/exporter/vault_native.py        418)             be one of `v0.2` or `v0.3`.
src/derivepassphrase/exporter/vault_native.py        419) 
src/derivepassphrase/exporter/vault_native.py        420)     Returns:
src/derivepassphrase/exporter/vault_native.py        421)         The vault configuration, as recorded in the configuration file.
src/derivepassphrase/exporter/vault_native.py        422) 
src/derivepassphrase/exporter/vault_native.py        423)         This may or may not be a valid configuration according to vault
src/derivepassphrase/exporter/vault_native.py        424)         or derivepassphrase.
src/derivepassphrase/exporter/vault_native.py        425) 
src/derivepassphrase/exporter/vault_native.py        426)     Raises:
src/derivepassphrase/exporter/vault_native.py        427)         RuntimeError:
src/derivepassphrase/exporter/vault_native.py        428)             Something went wrong during data collection, e.g. we
src/derivepassphrase/exporter/vault_native.py        429)             encountered unsupported or corrupted data in the storeroom.
src/derivepassphrase/exporter/vault_native.py        430)         json.JSONDecodeError:
src/derivepassphrase/exporter/vault_native.py        431)             An internal JSON data structure failed to parse from disk.
src/derivepassphrase/exporter/vault_native.py        432)             The storeroom is probably corrupted.
src/derivepassphrase/exporter/vault_native.py        433)         ValueError:
src/derivepassphrase/exporter/vault_native.py        434)             The requested formats to try out are invalid, or the
src/derivepassphrase/exporter/vault_native.py        435)             encrypted contents aren't in any of the attempted
src/derivepassphrase/exporter/vault_native.py        436)             configuration formats.
src/derivepassphrase/exporter/vault_native.py        437) 
src/derivepassphrase/exporter/vault_native.py        438)     """
src/derivepassphrase/exporter/vault_native.py        439)     if contents is None:
src/derivepassphrase/exporter/vault_native.py        440)         with open(exporter.get_vault_path(), 'rb') as infile:
src/derivepassphrase/exporter/vault_native.py        441)             contents = base64.standard_b64decode(infile.read())
src/derivepassphrase/exporter/vault_native.py        442)     if key is None:
src/derivepassphrase/exporter/vault_native.py        443)         key = exporter.get_vault_key()
src/derivepassphrase/exporter/vault_native.py        444)     stored_exception: Exception | None = None
src/derivepassphrase/exporter/vault_native.py        445)     for config_format in try_formats:
src/derivepassphrase/exporter/vault_native.py        446)         match config_format:
src/derivepassphrase/exporter/vault_native.py        447)             case 'v0.2':
src/derivepassphrase/exporter/vault_native.py        448)                 try:
src/derivepassphrase/exporter/vault_native.py        449)                     return VaultNativeV02ConfigParser(contents, key)()
src/derivepassphrase/exporter/vault_native.py        450)                 except ValueError as exc:
src/derivepassphrase/exporter/vault_native.py        451)                     exc.__context__ = stored_exception
src/derivepassphrase/exporter/vault_native.py        452)                     stored_exception = exc
src/derivepassphrase/exporter/vault_native.py        453)             case 'v0.3':
src/derivepassphrase/exporter/vault_native.py        454)                 try:
src/derivepassphrase/exporter/vault_native.py        455)                     return VaultNativeV03ConfigParser(contents, key)()
src/derivepassphrase/exporter/vault_native.py        456)                 except ValueError as exc:
src/derivepassphrase/exporter/vault_native.py        457)                     exc.__context__ = stored_exception
src/derivepassphrase/exporter/vault_native.py        458)                     stored_exception = exc
src/derivepassphrase/exporter/vault_native.py        459)             case _:  # pragma: no cover
src/derivepassphrase/exporter/vault_native.py        460)                 msg = (
src/derivepassphrase/exporter/vault_native.py        461)                     f'Invalid vault native configuration format: '
src/derivepassphrase/exporter/vault_native.py        462)                     f'{config_format!r}'
src/derivepassphrase/exporter/vault_native.py        463)                 )
src/derivepassphrase/exporter/vault_native.py        464)                 raise ValueError(msg)
src/derivepassphrase/exporter/vault_native.py        465)     msg = (
src/derivepassphrase/exporter/vault_native.py        466)         f'Not a valid vault native configuration. '
src/derivepassphrase/exporter/vault_native.py        467)         f'(We tried: {try_formats!r}.)'
src/derivepassphrase/exporter/vault_native.py        468)     )
src/derivepassphrase/exporter/vault_native.py        469)     raise stored_exception or ValueError(msg)
src/derivepassphrase/exporter/vault_native.py        470) 
src/derivepassphrase/exporter/vault_native.py        471) 

src/derivepassphrase/exporter/vault_v03_and_below.py 472) if __name__ == '__main__':
src/derivepassphrase/exporter/vault_v03_and_below.py 473)     import os
src/derivepassphrase/exporter/vault_v03_and_below.py 474) 
src/derivepassphrase/exporter/vault_v03_and_below.py 475)     logging.basicConfig(level=('DEBUG' if os.getenv('DEBUG') else 'WARNING'))

src/derivepassphrase/exporter/vault_v03_and_below.py 476)     with open(exporter.get_vault_path(), 'rb') as infile:

src/derivepassphrase/exporter/vault_v03_and_below.py 477)         contents = base64.standard_b64decode(infile.read())

src/derivepassphrase/exporter/vault_v03_and_below.py 478)     password = exporter.get_vault_key()

src/derivepassphrase/exporter/vault_v03_and_below.py 479)     try:

src/derivepassphrase/exporter/vault_v03_and_below.py 480)         config = VaultNativeV03ConfigParser(contents, password)()

src/derivepassphrase/exporter/vault_v03_and_below.py 481)     except ValueError:

src/derivepassphrase/exporter/vault_v03_and_below.py 482)         config = VaultNativeV02ConfigParser(contents, password)()