Skip to content

Commit b677f6a

Browse files
mnm678lukpueh
authored andcommitted
Clarify recovery from ffwd on top-level roles
Clarify what files to delete or untrust in various situations to recover from a fast-forward attack on top-level metadata.
1 parent e4a6f9e commit b677f6a

File tree

1 file changed

+19
-7
lines changed

1 file changed

+19
-7
lines changed

tuf-spec.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1133,16 +1133,28 @@ repo](https://github.com/theupdateframework/specification/issues).
11331133
cycle, report the potential freeze attack. On the next update cycle, begin
11341134
at step 0 and version N of the root metadata file.
11351135

1136-
* **1.9**. **If the timestamp and / or snapshot keys have been rotated, then
1137-
delete the trusted timestamp and snapshot metadata files.** This is done in
1138-
order to recover from fast-forward attacks after the repository has been
1139-
compromised and recovered. A _fast-forward attack_ happens when attackers
1140-
arbitrarily increase the version numbers of: (1) the timestamp metadata, (2)
1141-
the snapshot metadata, and / or (3) the targets, or a delegated targets,
1142-
metadata file in the snapshot metadata. Please see [the Mercury
1136+
* **1.9**. **Fast-forward attack recovery** A _fast-forward attack_ happens
1137+
when attackers arbitrarily increase the version numbers in any of the
1138+
timestamp, snapshot, targets, or delegated targets metadata. To recover from
1139+
fast-forward attacks after the repository has been compromised and recovered,
1140+
certain metadata files need to be deleted as specified in this section.
1141+
Please see [the Mercury
11431142
paper](https://ssl.engineering.nyu.edu/papers/kuppusamy-mercury-usenix-2017.pdf)
11441143
for more details.
11451144

1145+
* **1.9.1**. **Targets recovery** If a threshold of targets keys are removed
1146+
from the root metadata, delete the old top-level targets, snapshot, and
1147+
timestamp metadata files.
1148+
1149+
* **1.9.2**. **Snapshot recovery** If a threshold of snapshot keys have
1150+
been removed in the new trusted root metadata compared to the previous
1151+
trusted root metadata, delete the old snapshot and timestamp metadata
1152+
files.
1153+
1154+
* **1.9.3**. **Timestamp recovery** If a threshold of timestamp keys have
1155+
been removed from the new trusted root metadata compared to the previous
1156+
trusted root metadata, delete the old timestamp metadata file.
1157+
11461158
* **1.10**. **Set whether consistent snapshots are used as per the trusted
11471159
root metadata file** (see Section 4.3).
11481160

0 commit comments

Comments
 (0)