Skip to content

Commit b94091e

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 b94091e

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

specs/discoverable_disk_image.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,14 @@ 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 alone does not
23+
provide authentication or integrity protection. A LUKS encrypted partition shall be protected by signed
24+
`dm-verity`.
2125

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

3640
## Image Version
41+
3742
If the DDI is versioned, the version format described in the
3843
[Version Format Specification](version_format_specification.md) must be used. The underscore character (`_`)
3944
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)