Skip to content

Commit 5b6279e

Browse files
committed
Update wildcard pattern behavior
This commit adds explicit examples of targets that are not matched by a wildcard. It also adds a note warning users that incorrect assumptions about wildcard behavior can potentially lead to an untrusted role signing for a target. Signed-off-by: Aditya Sirish <aditya@saky.in>
1 parent 53bb11d commit 5b6279e

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

tuf-spec.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Title: The Update Framework Specification
33
Shortname: TUF
44
Status: LS
55
Abstract: A framework for securing software update systems.
6-
Date: 2023-04-14
6+
Date: 2024-02-23
77
Editor: Justin Cappos, NYU
88
Editor: Trishank Karthik Kuppusamy, Datadog
99
Editor: Joshua Lock, Verizon
@@ -1093,8 +1093,17 @@ attributes are OPTIONAL, if used, exactly one of them should be set.
10931093
`"foo-version-2.tgz"` and `"foo-version-a.tgz"`, but not
10941094
`"foo-version-alpha.tgz"`.
10951095
* a <a>PATHPATTERN</a> of `"*.tgz"` would match `"foo.tgz"` and `"bar.tgz"`,
1096-
but not `"targets/foo.tgz"`
1097-
* a <a>PATHPATTERN</a> of `"foo.tgz"` would match only `"foo.tgz"`
1096+
but not `"targets/foo.tgz"`.
1097+
* a <a>PATHPATTERN</a> of `"foo.tgz"` would match only `"foo.tgz"`.
1098+
* a <a>PATHPATTERN</a> of `"foo/*"` matches `"foo/bar.tgz"` but not
1099+
`"foo/baz/bar.tgz"`, `"foo/bar/baz/bar.tgz"`, and so on.
1100+
1101+
Note: It is important to understand the functioning of path patterns to
1102+
avoid mistaken assumptions that can lead to a false sense of security. For
1103+
example, an assumption that `"foo/*"` applies recursively to all files in
1104+
subdirectories of `foo` in a terminating delegation could allow a subsequent
1105+
delegated role that should not be trusted to sign for a target.
1106+
10981107

10991108

11001109
Prioritized delegations allow clients to resolve conflicts between delegated

0 commit comments

Comments
 (0)