Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add more text describing threshold computation #154

Merged

Commits on Aug 17, 2023

  1. Add signature threshold computation advice

    Several implementations have made similar errors -- counting multiple
    signatures by the same keyid -- when implementing signature threshold
    computation, for example the reference implementation:
    GHSA-pwqf-9h7j-7mv8
    theupdateframework/python-tuf@83ac7be
    
    Add some extra description to the detailed client workflow to further
    explain that a threshold of signatures should only count one signature
    per key.
    
    Signed-off-by: Joshua Lock <jlock@vmware.com>
    joshuagl committed Aug 17, 2023
    Configuration menu
    Copy the full SHA
    c06c4d5 View commit details
    Browse the repository at this point in the history
  2. Recommend signatures only contain one sig per keyid

    In an attempt to help implementers protect against incorrect threshold
    computation, update "File formats" to suggest that the signatures list
    contain only a single signature per keyid at metadata creation time.
    
    Suggested-by: Jussi Kukkonen <jkukkonen@vmware.com>
    Signed-off-by: Joshua Lock <jlock@vmware.com>
    joshuagl committed Aug 17, 2023
    Configuration menu
    Copy the full SHA
    f005792 View commit details
    Browse the repository at this point in the history
  3. Address review comments

    Be more explicit that each KEYID can only count one signature towards the
    threshold.
    
    Signed-off-by: Joshua Lock <joshuagloe@gmail.com>
    joshuagl committed Aug 17, 2023
    Configuration menu
    Copy the full SHA
    48120a6 View commit details
    Browse the repository at this point in the history
  4. Bump version and date

    Signed-off-by: Joshua Lock <joshuagloe@gmail.com>
    joshuagl committed Aug 17, 2023
    Configuration menu
    Copy the full SHA
    ec2e1ac View commit details
    Browse the repository at this point in the history