0.5.2 |
|
---|
#81 in #aes
31KB
446 lines
🚨 DEPRECATED! 🚨
Miscreant is no-longer maintained! The Rust successor is the aes-siv
crate, which is the evolution of the original Miscreant codebase.
The best crypto you've never heard of, brought to you by Phil Rogaway
Rust 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.
About AES-SIV and AES-PMAC-SIV
AES-SIV and AES-PMAC-SIV provide nonce-reuse misuse-resistance (NRMR): accidentally reusing a nonce with this construction is not a security catastrophe, unlike more popular AES encryption modes like AES-GCM where nonce reuse leaks both the authentication key and the XOR of both plaintexts, both of which can potentially be leveraged for full plaintext recovery attacks.
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.
Requirements
miscreant.rs requires Rust 1.36+.
To enable hardware accelerated AES support on x86/x86_64 using Intel AES-NI
instructions, you will need to pass the following RUSTFLAGS
:
RUSTFLAGS=-Ctarget-feature=+aes,+ssse3
You can configure your ~/.cargo/config
to always pass these flags:
[build]
rustflags = ["-Ctarget-feature=+aes,+ssse3"]
Help and Discussion
Have questions? Want to suggest a feature or change?
- Gitter: web-based chat about Miscreant projects including miscreant.rs
- Google Group: join via web or email (miscreant-crypto+subscribe@googlegroups.com)
Security Notice
Though this library is written by cryptographic professionals, it has not undergone a thorough security audit, and cryptographic professionals are still humans that make mistakes.
This library makes an effort to use constant time operations throughout its implementation, however actual constant time behavior has not been verified.
Use this library at your own risk.
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.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/miscreant/miscreant
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as noted below, without any additional terms or conditions.
License
Copyright (c) 2017-2019 The Miscreant Developers.
miscreant.rs is licensed under either of:
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Dependencies
~680KB
~14K SLoC