msw/CISS.debian.live.builder
SHA256
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 6 Wiki Activity

V8.13.408.2025.11.13
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m19s
Details

Browse Source 
Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
This commit is contained in:
Marc S. Weidner
2025-11-13 07:21:00 +01:00
parent dc15003750
commit dae9662c02
1 changed files with 17 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/MAN_CISS_ISO_BOOT_CHAIN.md
View File

@@ -79,12 +79,13 @@ end
# 6. LUKS/dm-integrity Layering # 6. LUKS/dm-integrity Layering
```mermaid ```mermaid
flowchart TD; flowchart TD
%%
A[Plain device (/live/rootfs.crypt)] --> B[dm-integrity (HMAC-SHA-512, 4 KiB)];
B --> C[dm-crypt (AES-XTS-512)]; A["Plain device (/live/rootfs.crypt)"] --> B["dm-integrity (HMAC-SHA-512, 4 KiB)"];
C --> D[Mapped device /dev/mapper/crypt_liveiso]; B --> C["dm-crypt (AES-XTS-512)"];
D --> E[SquashFS mount /run/live/rootfs]; C --> D["/dev/mapper/crypt_liveiso"];
D --> E["SquashFS mount /run/live/rootfs"];
``` ```
**Note:** Encrypt-then-MAC at the block layer (functionally AEAD-equivalent). Any manipulation ⇒ hard I/O error. **Note:** Encrypt-then-MAC at the block layer (functionally AEAD-equivalent). Any manipulation ⇒ hard I/O error.
@@ -186,15 +187,16 @@ dmsetup table --showkeys CHILD # expect integrity hmac sha512 4096
# 13. Diagram: Trust Chain & Verification Paths # 13. Diagram: Trust Chain & Verification Paths
```mermaid ```mermaid
flowchart TD; flowchart TD
%%
A[Build time: pin EXP_FPR + embed ISO key] --> B[ISO artifacts: sha512sum.txt + .sig];
B --> C[Boot early (0030): gpgv verify + FPR pin]; A["Build time: pin EXP_FPR + embed ISO key"] --> B["ISO artifacts: sha512sum.txt + .sig"];
C -->|OK| D[LUKS open (0025)]; B --> C["Boot early (0030): gpgv verify + FPR pin"];
D --> E[Mount RootFS]; C -->|OK| D["LUKS open (0025)"];
E --> F[Boot late (0045): gpgv verify + FPR pin (root key)]; D --> E["Mount RootFS"];
F --> G[dmsetup health: crypt(XTS) over integrity(HMAC-SHA-512)]; E --> F["Boot late (0045): gpgv verify + FPR pin (root key)"];
C -- FAIL --> X[Abort]; F --> G["dmsetup health: crypt(XTS) over integrity(HMAC-SHA-512)"];
C -- FAIL --> X["Abort"];
F -- FAIL --> X; F -- FAIL --> X;
G -- FAIL --> X; G -- FAIL --> X;
``` ```