constellation/disk-mapper
Daniel Weiße bb8d2c8a5c
cryptsetup: enable detached header (#3927)
* deps: update go-cryptsetup
* cryptsetup: use detached headers when opening existing crypt devices
* cryptsetup: only activate disks with detached header

---------

Signed-off-by: Daniel Weiße <dw@edgeless.systems>
2025-08-28 10:34:24 +02:00
..
cmd license: change headers 2025-07-15 23:34:48 +02:00
internal cryptsetup: enable detached header (#3927) 2025-08-28 10:34:24 +02:00
recoverproto deps: update Go dependencies (#3735) 2025-04-02 16:20:47 +02:00
README.md dev-docs: Go package docs (#958) 2023-01-19 15:57:50 +01:00

disk-mapper

The disk-mapper is a binary that runs during the initramfs of a Constellation node.

If running on a new node, it handles setting up the node's state disk by creating an integrity protected encrypted partition.

On a rebooting node, the disk-mapper handles recovery of the node by requesting a decryption key for its state disk. Once the disk is decrypted, the measurement salt is read from disk and used to extend a PCR to mark the node as initialized.

Testing

Integration test is available in disk-mapper/test/integration_test.go. The integration test requires root privileges since it uses dm-crypt. Build and run the test:

go test -c -tags=integration ./disk-mapper/internal/test/
sudo ./test.test