Skip to content

Commit fc940bf

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 f89dce8 commit fc940bf

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
@@ -1112,16 +1112,28 @@ repo](https://github.com/theupdateframework/specification/issues).
11121112
cycle, report the potential freeze attack. On the next update cycle, begin
11131113
at step 0 and version N of the root metadata file.
11141114

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

1124+
* **1.9.1**. **Targets recovery** If a threshold of targets keys are removed
1125+
from the root metadata, delete the old top-level targets, snapshot, and
1126+
timestamp metadata files.
1127+
1128+
* **1.9.2**. **Snapshot recovery** If a threshold of snapshot keys have
1129+
been removed in the new trusted root metadata compared to the previous
1130+
trusted root metadata, delete the old snapshot and timestamp metadata
1131+
files.
1132+
1133+
* **1.9.3**. **Timestamp recovery** If a threshold of timestamp keys have
1134+
been removed from the new trusted root metadata compared to the previous
1135+
trusted root metadata, delete the old timestamp metadata file.
1136+
11251137
* **1.10**. **Set whether consistent snapshots are used as per the trusted
11261138
root metadata file** (see Section 4.3).
11271139

0 commit comments

Comments
 (0)