pypuf 2.0.0

No project description provided

pypuf: Cryptanalysis of Physically Unclonable Functions

pypuf is a toolbox for simulation, testing, and attacking Physically Unclonable Functions.

Studies and Results

pypuf is used in the following projects:

• 2020, Wisiol et al.: Splitting the Interpose PUF: A Novel Modeling Attack Strategy: Modeling attacks on the Interpose PUF using Logistic Regression in a Divide-and-Conquer strategy.
• 2020, Wisiol et al.: Short Paper: XOR Arbiter PUFs have Systematic Response Bias: Empirical and theoretical study of XOR Arbiter PUF response bias for unbiased arbiter chains.
• 2019, Wisiol et al.: Breaking the Lightweight Secure PUF: Understanding the Relation of Input Transformations and Machine Learning Resistance: An advanced machine learning attack on the Lightweight Secure PUF.
• 2019, Wisiol et al.: Why Attackers Lose: Design and Security Analysis of Arbitrarily Large XOR Arbiter PUFs: Simulation of the stabiltiy of Majority Vote XOR Arbiter PUFs.

Please check out the archived version of pypuf v1 to find the original code used in these projects.

Using pypuf

To get started, please check out the documentation.

Contribute

Testing, linting, licensing.

Update Documentation and Check Doc Tests

1. install sphinx-build xdoctest
2. xdoctest pypuf
3. cd docs
4. make clean
5. make doctest && make html

Maintainer: Prepare New Release

1. Make sure docs are testing and building without error (see above)
2. Commit all changes
3. Clean up dist/ folder
4. Set up new release version: RELEASE=x.y.z
5. Update version to x.y.z in setup.py and docs/conf.py
6. Commit with message "Release Version vx.y.z": git commit -p -m "Release Version v$RELEASE"
7. Tag commit using git tag -as v$RELEASE -m "Release Version v$RELEASE"
8. If applicable, adjust dev and/or stable tags.
9. Push
   1. branch: git push
   2. tag: git push origin v$RELEASE
10. Set environment variables GITHUB_TOKEN to a GitHub token, TWINE_USERNAME and TWINE_PASSWORD to PyPi credentials.
11. Publish using publish nils-wisiol pypuf
12. At zenedo.org, make sure the author list and project title are correct
13. Bump DOI in README (badge, citation section)
14. Bump DOI in docs index.rst (image src and link)
15. git commit -p -m "docs: Bump DOI for v$RELEASE"

Citation

pypuf is published via Zenodo. Please cite this work as (update date and version as appropriate)

Nils Wisiol, Christoph Gräbnitz, Christopher Mühl, Benjamin Zengin, Tudor Soroceanu, & Niklas Pirnay. (2020, June 23). pypuf: Cryptanalysis of Physically Unclonable Functions (Version v0.0.7). Zenodo. http://doi.org/10.5281/zenodo.3904267

or download BibTeX directly from Zenodo.