Skip to content

Commit 7373883

Browse files
DDI: Add recomendation for LUKS encrypted partitions
Add note clarifying LUKS encryption vs dm-verity protection to inform users not to confuse confidentiality with integrity and authenticity. Addresses systemd/systemd#38854 (comment)
1 parent 801eefd commit 7373883

1 file changed

Lines changed: 9 additions & 1 deletion

File tree

specs/discoverable_disk_image.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,17 @@ extensions, portable services, containers and more, and shall be protected by si
1414
into one. They are designed to be composable and stackable, and provide security by default.
1515

1616
## Image Format
17+
1718
The images use the GPT partition table verbatim, so it will not be redefined here. Each partition contains
1819
a standard Linux filesystem (e.g.: `erofs`), so again this will not be redefined here.
1920
The [DPS](discoverable_partitions_specification.md) defines the GUIDs to use and the format of the
20-
`dm-verity` signature partition's JSON content.
21+
`dm-verity` signature partition's JSON content. The [DPS](discoverable_partitions_specification.md)
22+
allows optional LUKS encryption for additional confidentiality. Note that LUKS encryption by default does not
23+
provide authentication or integrity protection[^1]. A LUKS encrypted partition should be protected by signed
24+
`dm-verity`.
25+
26+
[^1]: LUKS2 supports authenticated encryption as an experimental feature.
27+
See [cryptsetup(8) - Authenticated disk encryption](https://man.archlinux.org/man/cryptsetup.8#Authenticated_disk_encryption_(EXPERIMENTAL))
2128

2229
It is recommended to use a sector size of 512 bytes or 4096 for DDIs. Software operating with DDIs should
2330
automatically derive the sector size used for a DDI by looking for the `EFI PART` magic string at offsets 512
@@ -34,6 +41,7 @@ The MIME type for DDIs is `application/vnd.efi.img`, [as per
3441
IANA](https://www.iana.org/assignments/media-types/application/vnd.efi.img).
3542

3643
## Image Version
44+
3745
If the DDI is versioned, the version format described in the
3846
[Version Format Specification](version_format_specification.md) must be used. The underscore character (`_`)
3947
must be used to separate the version from the name of the image. For example: `foo_1.2.raw` denotes a `foo`

0 commit comments

Comments
 (0)