diff options
| author | tv <tv@krebsco.de> | 2026-11-14 05:52:42 +0000 |
|---|---|---|
| committer | tv <tv@krebsco.de> | 2026-11-14 05:52:42 +0000 |
| commit | 2261607e502a8fbde100367d53756d1586fd9b75 (patch) | |
| tree | f21d1f3dfd73d67d0734438354cd72e8b00684ed | |
| parent | 045ad69f6b59ea5be7b1ac1a4e405b531b8544f0 (diff) | |
federation: a key's own retirement takes back nothing seen
A key retires itself only from where it stands, its cut holding all it
signed that the retiring change's history holds. But whoever commits
the retirement chooses that history: on dependencies from long ago a
stolen device key retired itself from there, and what its user had
signed with it since was outside the cut.
A key's own retirement now takes back nothing that a node of its user
or of a root had in its history without it, as far as an unvouch
reaches. A key above still cuts a stolen key off from before the theft.
| -rw-r--r-- | docs/federation.md | 15 |
1 files changed, 9 insertions, 6 deletions
diff --git a/docs/federation.md b/docs/federation.md index 0ea6497..8ceac00 100644 --- a/docs/federation.md +++ b/docs/federation.md @@ -764,9 +764,11 @@ doesn't depend on who asks or when: a change's history is fixed by its hash. * **Who retires what.** A key above another retires it with any cut: a user whose device key was stolen cuts it off from before the theft. A key retires itself only from where it stands (its cut must hold everything it signed that the retiring - change's history holds): rotating, not rewriting. No key retires one beside or above - it, so a stolen device key can't cut off the keys above it, nor undo what it signed - before. + change's history holds), and, since whoever commits the retirement chooses that + history, takes back nothing that a node of its user or of a root had in its history + without the retirement, as far as an unvouch reaches (Unvouching): rotating, not + rewriting. No key retires one beside or above it, so a stolen device key can't cut + off the keys above it, nor undo what it signed before. * **What a cut keeps, it names.** Beside the cut, a `retire` lists by digest what it keeps of what the key signed: what is within the cut of the epoch's own, which every node checks where the statement is taken, as it checks a number; and what it keeps @@ -1507,8 +1509,9 @@ the steps before: change holds, by the creation of its root that remains over all the changes, its creations ordered by the other roots' nodes alone, and none while two contest; or given by a decision); it is within every cut set for that key (by a `retire` that - counts, or a decision); and it isn't past its limit (Users), by the limit that - holds. A `retire`, a stop and an `unvouch` are never outside a cut they set + counts, or a decision; a key's own retirement leaves in what a node of its user or + of a root had seen without it); and it isn't past its limit (Users), by the limit + that holds. A `retire`, a stop and an `unvouch` are never outside a cut they set themselves. A user is **out** where it counts through no `create` or `vouch` any more, or where it gave itself up. It is **gone** once seen out for `gone`, or where a decision freed its name; and gone it stays, whatever is vouched or cut off after. @@ -2208,7 +2211,7 @@ Keys: | 55 | Steals a device key and signs with it | Take it until a key above cuts it off, then leave out what is outside the cut; a value it replaced is read again | 3 | unit: `a_retired_key_counts_within_its_cut`, `the_value_before_counts_again`; sim: `a_stolen_key_cut_off` | | 56 | Signs with a retired key, saying it saw nothing of the retiring | Hold it (valid as written), leave it out | 3 | unit: `backdated_past_a_cut` | | 57 | With a stolen device key, retires the keys above or beside it | Refuse | 3 | unit: `no_key_retires_one_above` | -| 58 | With a stolen device key, retires that key from long ago, to undo what its user signed | Refuse: a key retires itself from where it stands | 3 | unit: `a_key_retires_itself_forward` | +| 58 | With a stolen device key, retires that key from long ago, on old dependencies, to undo what its user signed with it since | Valid as written, and it takes back nothing a node of its user or of a root had seen without it: what the user signed since stands. A key above cuts the theft off | 3 | unit: `a_key_retires_itself_forward`, `a_retirement_on_old_dependencies_keeps_what_was_seen` | | 59 | A key retires itself; a node commits its own stop | Each counts: a cut never leaves out its own statement | 2 | unit: `a_cut_never_reaches_itself` | | 60 | With a stolen key, retires the keys below it, stops nodes, unvouches, releases names | A key above cuts it off from before: all of it is taken back, but what became final on it | 3 | unit: `a_cut_takes_back_what_the_key_cut` | | 61 | Is unvouched with a key that is then cut off from before, and claimed names while out | In again, its earlier claims having stood all along; what it claimed while out gives way to what was claimed in sight of it meanwhile. Gone stays gone | 5 | unit: `an_unvouch_cut_off` | |
