Skip to content

Commit 085d453

Browse files
lukpuehmnm678trishankatdatadog
committed
Refine wording in root key migration paragraph
Co-Authored-By: mnm678 <[email protected]> Co-Authored-By: Trishank Karthik Kuppusamy <[email protected]>
1 parent 9da1787 commit 085d453

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

tuf-spec.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1296,19 +1296,20 @@ non-volatile storage as FILENAME.EXT.
12961296

12971297
Clients that have outdated root keys can update to the latest set of trusted
12981298
root keys, by incrementally downloading all intermediate root metadata
1299-
files, and verifying that each root metadata at a given version is signed by
1300-
a threshold of keys defined in the previous version of root, and a threshold
1301-
of keys defined in that given version of root.
1299+
files, and verifying that each current version of the root metadata is
1300+
signed by a threshold of keys specified by its immediate predecessor as well
1301+
as a threshold of keys specified by itself.
13021302
For example, if there is a 1.root.json that has threshold 2 and a
13031303
2.root.json that has threshold 3, 2.root.json MUST be signed by at least 2
1304-
keys defined in 1.root.json and at least 3 keys defined in 2.root.json.
1305-
The client starts the root keys update update process with the latest
1306-
version of root metadata available on the client, and stops when no newer
1307-
root metadata is available from the repository. This ensures that an
1308-
outdated client can always correctly re-trace the chain of trust across
1309-
multiple root key updates, even if the latest set of root keys on the client
1310-
dates back multiple root metadata versions. See step 1 of the client
1311-
application workflow in Section 5 for more details.
1304+
keys defined in 1.root.json and at least 3 keys defined in 2.root.json. The
1305+
client starts the root key update process with the latest version of root
1306+
metadata available on the client, and stops when no version N+1 (where N is
1307+
the latest trusted version) of the root metadata is available from the
1308+
repository. This ensures that an outdated client can always correctly
1309+
re-trace the chain of trust across multiple root key updates, even if the
1310+
latest set of root keys on the client dates back multiple root metadata
1311+
versions. See step 1 of the client application workflow in Section 5 for
1312+
more details.
13121313

13131314
To replace a delegated developer key, the role that delegated to that key
13141315
just replaces that key with another in the signed metadata where the

0 commit comments

Comments
 (0)