Expand description
Protected local vaults (E16.2).
Keys are stored as KeyRef (slot + generation), never as exported raw
key bytes on this path. A digest in a slot is a handle, not a secret dump.
§What this module cannot enforce (E16.7)
Remote wipe and attestation cannot guarantee safety after endpoint
compromise or seizure. An unlocked or coerced device can disclose
accessible plaintext. Crash dumps must omit key material
(crash_dump_redacted is true when crash_dump_allowed is false).
Hardware-backed references are reported only when a real token exists;
this Linux CI path does not fake a TPM.
Structs§
- KeyRef
- Slot + generation handle. Not raw key bytes.
- Local
Vault - Sealed
Profile Blob - Catalog profile sealed under a wrap key. Ciphertext is not a key dump.
- Vault
Slot
Constants§
- NOTIFICATION_
PREVIEW_ MAX_ BYTES - Maximum notification preview size. Not a full payload.
- SEALED_
PROFILE_ PLAIN_ LEN profile_u8+control_count+ catalog digest.- VAULT_
SLOTS
Functions§
- crash_
dump_ redacted - True when dumps must not include key material (
crash_dump_allowedis false). - hardware_
key_ ref_ supported - Hardware-backed
KeyRefsupport. Presence of/dev/tpm0is not enough: this crate has no TPM token binding and must not fake one. - load_
key_ ref - Loads
key_ref; error when absent/invalid. - load_
ref - Load the stored digest. Denied if the vault/slot is locked; Expired if
nowis at or past the slot deadline. Generation mismatch is stale. - lock
- Irreversible local lock. There is no unlock / backdoor API.
- notification_
preview_ max_ bytes notification-preview-maxsize in bytes.- open_
profile_ blob - Open a sealed catalog profile. Wrong key is CryptoFailure (fail closed).
- require_
hardware_ backed_ p4 - P4-with-hardware-token requirement. Unsupported hardware is unavailable, never a silent software downgrade.
- seal_
profile_ blob - Seal a catalog profile. Locked vaults fail closed. Zero keys are Malformed.
- store_
ref - Store a key reference digest. Raw secret bytes are not accepted here.