The best crypto you've never heard of, brought to you by Phil Rogaway
Python implementation of Miscreant: Advanced symmetric encryption library which provides the AES-SIV (RFC 5297), AES-PMAC-SIV, and STREAM constructions. These algorithms are easy-to-use (or rather, hard-to-misuse) and support encryption of individual messages or message streams.
AES-SIV provides nonce-reuse misuse-resistance (NRMR): accidentally reusing a nonce with this construction is not a security catastrophe, unlike it is with more popular AES encryption modes like AES-GCM. With AES-SIV, the worst outcome of reusing a nonce is an attacker can see you've sent the same plaintext twice, as opposed to almost all other AES modes where it can facilitate chosen ciphertext attacks and/or full plaintext recovery.
For more information, see the toplevel README.md.
Help and Discussion
Have questions? Want to suggest a feature or change?
- Gitter: web-based chat about miscreant projects including miscreant.py
- Google Group: join via web or email (email@example.com)
This library implements some portions of the construction in pure Python and
therefore these parts are not constant time: though the core cryptography is
provided by the Python
cryptography library including the AES function,
various other parts, particularly the
dbl functions are Python.
These functions act on Python integers, which are boxed. They may reveal timing information which may help an attacker compromise this implementation, possibly even facilitating complete plaintext recovery. The exact extent to which this is possible has not been thoroughly investigated, nor has this library been professionally audited by cryptography experts.
Use this library at your own risk.
This library is tested on Python 2.7 and 3.6.
It depends on the Python
cryptography library. For more information on
installing this library, please see:
Install Miscreant with pip using:
$ pip install miscreant
Please see the Miscreant Wiki for API documentation.
Code of Conduct
We abide by the Contributor Covenant and ask that you do as well.
For more information, please see CODE_OF_CONDUCT.md.
Bug reports and pull requests are welcome on GitHub at https://github.com/miscreant/miscreant