Skip to content

Record the Mac's device key item layout in ADR 0013 - #297

Merged
sudoHG merged 1 commit into
mainfrom
sudoHG/adr-0013-key-item-tag
Nov 10, 2026
Merged

sudoHG merged 1 commit into
mainfrom
sudoHG/adr-0013-key-item-tag

Conversation

@sudoHG

@sudoHG sudoHG commented Nov 10, 2026

Copy link
Copy Markdown
Owner

ADR 0013 specifies the HMAC tag of the Mac's paired-device list but not of the Secure Enclave key items. #287 (PR #296) added a tag to each key item after its cross review, because any process on the Mac can use a blob it holds and could plant usable blobs before the first pairing. This records that layout next to the key storage in ADR 0013, matching DeviceKeyBlobAuthentication in Sources/AskKeyVault/Vault+Devices.swift.

Docs only; no code change.

  • python3 scripts/check_hygiene.py: passes

#287 authenticates each Secure Enclave key item with an HMAC tag under a
key derived from the vault key, so blobs another process planted before
the first pairing are refused. ADR 0013 described the paired-device list
tag but not the key items; record the layout next to the key storage.
@sudoHG
sudoHG merged commit 5bec2fd into main Nov 10, 2026
3 checks passed
@sudoHG
sudoHG deleted the sudoHG/adr-0013-key-item-tag branch November 10, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant