From 4b28b1757a868b452d909d9283840092bfdb8479 Mon Sep 17 00:00:00 2001 From: tv Date: Mon, 16 Nov 2026 17:13:22 +0000 Subject: federation: a signature's blob holds an empty reserved field The design named the blob's hash and key, and said a signature is checked as continuum checks a user's, which takes `sha256` beside `sha512`, and any reserved field. Only the signer can vary that field, as it is signed, but one builder asked it empty and another didn't. It is empty, as `ssh-keygen` writes it, and the hash `sha512`, beyond what continuum's check asks. --- docs/federation.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/federation.md b/docs/federation.md index 750e0b0..a43dadc 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -125,9 +125,10 @@ Spread out: (Changing the policy). * **`sig`**: an SSH signature (`ssh-keygen -Y sign`, namespace `continuum-federation`) over the event's bytes without `sig`: the SSHSIG blob of version 1, hashed with - `sha512`, its key the event's `key`, in base64, padded and canonical, unarmored. It is - checked as continuum checks a user's signature, strictly *(checked: - `access::sshsig::verify_blob`)*. + `sha512`, its key the event's `key`, its reserved field empty, as `ssh-keygen` writes + it, in base64, padded and canonical, unarmored. It is checked as continuum checks a + user's signature, strictly *(checked: `access::sshsig::verify_blob`)*, which takes + `sha256` too, and any reserved field: the federation asks `sha512` and an empty one. Three things no party signs, as their bytes need no signer, each without `party`, `key` and `sig`: a version event (Changing the policy), and a federation's root and a fork's, -- cgit v1.3.1