Python reference implementation of The Update Framework (TUF)
Find a file
Vladimir Diaz 6920105301
Document change to --consistent_snapshot in CLI.md
Signed-off-by: Vladimir Diaz <vladimir.v.diaz@gmail.com>
2018-04-02 13:57:01 -04:00
.github Add issue and pull request templates 2017-09-28 17:01:56 -04:00
docs Document change to --consistent_snapshot in CLI.md 2018-04-02 13:57:01 -04:00
tests Edit test conditions affected by new settings 2018-03-27 14:44:10 -04:00
tuf Rename --consistent_snapshot to --consistent 2018-04-02 13:56:16 -04:00
.gitignore Ignore virtualenv and pyenv files 2017-10-11 11:34:07 -04:00
.gitmodules Remove ssl_commons and ssl_crypto submodules 2017-01-09 13:00:25 -05:00
.pyup.yml Fix .pyup.yml 2018-03-29 11:09:24 -04:00
.travis.yml Fix before_script entries 2017-12-07 10:36:31 -05:00
ci-requirements.txt Add Pylint dependency to CI and dev requirement files 2017-11-15 16:29:49 -05:00
dev-requirements.txt Remove hashes from dev-requirements.txt 2018-03-29 10:51:09 -04:00
LICENSE Move license files to root directory 2018-02-05 10:27:04 -05:00
LICENSE-MIT Move license files to root directory 2018-02-05 10:27:04 -05:00
MANIFEST.in Update MANIFEST.in following reorganization of directory structure 2018-01-31 17:33:14 -05:00
pylintrc Add logging-not-lazy to pylintrc 2017-12-22 10:26:31 -05:00
README.rst Replace Justin's listed email address 2018-03-23 15:54:38 -04:00
requirements.txt Generate new requirements.txt based on setup.py 2018-03-29 10:48:46 -04:00
setup.cfg Update release files. 2014-07-16 12:51:35 -04:00
setup.py Upgrade securesystemslib to 0.10.11 (removes deprecated cryptography methods) 2018-03-29 10:47:44 -04:00
tox.ini Drop support for Python 3.3 and use ci-requirements in tox.ini 2017-11-09 11:12:48 -05:00

A Framework for Securing Software Update Systems
------------------------------------------------

.. image:: https://travis-ci.org/theupdateframework/tuf.svg?branch=develop
   :target: https://travis-ci.org/theupdateframework/tuf
   :alt: Travis

.. image:: https://coveralls.io/repos/theupdateframework/tuf/badge.svg?branch=develop
   :target: https://coveralls.io/r/theupdateframework/tuf?branch=develop
   :alt: Coveralls

.. image:: https://pyup.io/repos/github/theupdateframework/tuf/shield.svg
   :target: https://pyup.io/repos/github/theupdateframework/tuf/
   :alt: pyup

.. image:: https://pyup.io/repos/github/theupdateframework/tuf/python-3-shield.svg
   :target: https://pyup.io/repos/github/theupdateframework/tuf/
   :alt: Python 3

.. image:: https://app.fossa.io/api/projects/git%2Bgithub.com%2Ftheupdateframework%2Ftuf.svg?type=shield
   :target: https://app.fossa.io/projects/git%2Bgithub.com%2Ftheupdateframework%2Ftuf?ref=badge_shield
   :alt: FOSSA

.. image:: https://bestpractices.coreinfrastructure.org/projects/1351/badge
   :target: https://bestpractices.coreinfrastructure.org/projects/1351
   :alt: CII

.. raw:: html

   <img
   src="https://github.com/theupdateframework/artwork/blob/master/tuf-logo-text.svg"
   height="200px">

---------------------------------------------------------------

The Update Framework (TUF) helps developers secure new or existing software
update systems, which are often found to be vulnerable to many known attacks.
TUF addresses this widespread problem by providing a comprehensive, flexible
security framework that developers can integrate with any software update
system.  The framework can be easily integrated (or implemented in the native
programming languages of these update systems) due to its concise,
self-contained architecture and specification.  `Adopters <docs/ADOPTERS.md>`_
have so far implemented the framework in the Go (`1
<https://github.com/theupdateframework/notary>`_, `2
<https://github.com/flynn/go-tuf>`_), `Haskell
<https://www.well-typed.com/blog/2015/07/hackage-security-alpha/>`_, `Python
<https://github.com/theupdateframework/tuf>`_, `Ruby
<https://medium.com/square-corner-blog/securing-rubygems-with-tuf-part-1-d374fdd05d85>`_,
and `Rust <https://github.com/heartsucker/rust-tuf>`_ programming languages.

TUF is hosted by the `Cloud Native Computing Foundation
<https://www.cncf.io/>`_ (CNCF) and follows the `CNCF Code of Conduct
<https://github.com/cncf/foundation/blob/master/code-of-conduct.md>`_.

Documentation
-------------
* `Overview <docs/OVERVIEW.rst>`_
* `Specification <https://github.com/theupdateframework/specification/blob/master/tuf-spec.md>`_
* `Getting Started <docs/GETTING_STARTED.rst>`_
* `Governance <docs/GOVERNANCE.md>`_

Contact
-------
Please contact us via our `mailing list
<https://groups.google.com/forum/?fromgroups#!forum/theupdateframework>`_.
Questions, feedback, and suggestions are welcomed on this low-volume mailing
list.

Security Issues and Bugs
------------------------

Security issues can be reported by emailing jcappos@nyu.edu.

At a minimum, the report must contain the following:

* Description of the vulnerability.
* Steps to reproduce the issue.

Optionally, reports that are emailed can be encrypted with PGP.  You should use
PGP key fingerprint **E9C0 59EC 0D32 64FA B35F  94AD 465B F9F6 F8EB 475A**.

Please do not use the GitHub issue tracker to submit vulnerability reports.
The issue tracker is intended for bug reports and to make feature requests.
Major feature requests, such as design changes to the specification, should
be proposed via a `TUF Augmentation Proposal <docs/TAP.rst>`_.

License
-------

This work is `dual-licensed <https://en.wikipedia.org/wiki/Multi-licensing>`_
and distributed under the (1) MIT License and (2) Apache License, Version 2.0.
Please see `LICENSE-MIT <LICENSE-MIT>`_ and `LICENSE
<LICENSE>`_.


Acknowledgements
----------------

This project is managed by Prof. Justin Cappos and other members of the `Secure
Systems Lab <https://ssl.engineering.nyu.edu/>`_ at NYU.

This material is based upon work supported by the National Science Foundation
under Grant Nos. CNS-1345049 and CNS-0959138. Any opinions, findings, and
conclusions or recommendations expressed in this material are those of the
author(s) and do not necessarily reflect the views of the National Science
Foundation.