1 Cryptsetup 2.4.3 Release Notes
2 ==============================
3 Stable security bug-fix release that fixes CVE-2021-4122.
5 All users of cryptsetup 2.4.x must upgrade to this version.
7 Changes since version 2.4.2
8 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 * Fix possible attacks against data confidentiality through LUKS2 online
11 reencryption extension crash recovery (CVE-2021-4122).
13 An attacker can modify on-disk metadata to simulate decryption in
14 progress with crashed (unfinished) reencryption step and persistently
15 decrypt part of the LUKS device.
17 This attack requires repeated physical access to the LUKS device but
18 no knowledge of user passphrases.
20 The decryption step is performed after a valid user activates
21 the device with a correct passphrase and modified metadata.
22 There are no visible warnings for the user that such recovery happened
23 (except using the luksDump command). The attack can also be reversed
24 afterward (simulating crashed encryption from a plaintext) with
25 possible modification of revealed plaintext.
27 The size of possible decrypted data depends on configured LUKS2 header
28 size (metadata size is configurable for LUKS2).
29 With the default parameters (16 MiB LUKS2 header) and only one
30 allocated keyslot (512 bit key for AES-XTS), simulated decryption with
31 checksum resilience SHA1 (20 bytes checksum for 4096-byte blocks),
32 the maximal decrypted size can be over 3GiB.
34 The attack is not applicable to LUKS1 format, but the attacker can
35 update metadata in place to LUKS2 format as an additional step.
36 For such a converted LUKS2 header, the keyslot area is limited to
37 decrypted size (with SHA1 checksums) over 300 MiB.
39 The issue is present in all cryptsetup releases since 2.2.0.
40 Versions 1.x, 2.0.x, and 2.1.x are not affected, as these do not
41 contain LUKS2 reencryption extension.
43 The problem was caused by reusing a mechanism designed for actual
44 reencryption operation without reassessing the security impact for new
45 encryption and decryption operations. While the reencryption requires
46 calculating and verifying both key digests, no digest was needed to
47 initiate decryption recovery if the destination is plaintext (no
48 encryption key). Also, some metadata (like encryption cipher) is not
49 protected, and an attacker could change it. Note that LUKS2 protects
50 visible metadata only when a random change occurs. It does not protect
51 against intentional modification but such modification must not cause
52 a violation of data confidentiality.
54 The fix introduces additional digest protection of reencryption
55 metadata. The digest is calculated from known keys and critical
56 reencryption metadata. Now an attacker cannot create correct metadata
57 digest without knowledge of a passphrase for used keyslots.
58 For more details, see LUKS2 On-Disk Format Specification version 1.1.0.
60 The former reencryption operation (without the additional digest) is no
61 longer supported (reencryption with the digest is not backward
62 compatible). You need to finish in-progress reencryption before
63 updating to new packages. The alternative approach is to perform
64 a repair command from the updated package to recalculate reencryption
65 digest and fix metadata.
66 The reencryption repair operation always require a user passphrase.
68 WARNING: Devices with older reencryption in progress can be no longer
69 activated without performing the action mentioned above.
71 Encryption in progress can be detected by running the luksDump command
72 (output includes reencrypt keyslot with reencryption parameters). Also,
73 during the active reencryption, no keyslot operations are available
74 (change of passphrases, etc.).
76 The issue was found by Milan Broz as cryptsetup maintainer.
80 * Add configure option --disable-luks2-reencryption to completely disable
81 LUKS2 reencryption code.
83 When used, the libcryptsetup library can read metadata with
84 reencryption code, but all reencryption API calls and cryptsetup
85 reencrypt commands are disabled.
87 Devices with online reencryption in progress cannot be activated.
88 This option can cause some incompatibilities. Please use with care.
90 * Improve internal metadata validation code for reencryption metadata.
92 * Add updated documentation for LUKS2 On-Disk Format Specification
93 version 1.1.0 (with reencryption extension description and updated
94 metadata description). See docs/on-disk-format-luks2.pdf or online
95 version in https://gitlab.com/cryptsetup/LUKS2-docs repository.
97 * Fix support for bitlk (BitLocker compatible) startup key with new
98 metadata entry introduced in Windows 11.
100 * Fix space restriction for LUKS2 reencryption with data shift.
101 The code required more space than was needed.