Skip to content

Latest commit

 

History

History
90 lines (62 loc) · 2.86 KB

README.md

File metadata and controls

90 lines (62 loc) · 2.86 KB

RustCrypto: MD5

crate Docs Apache2/MIT licensed Rust Version Project Chat Build Status

Pure Rust implementation of the MD5 cryptographic hash algorithm.

⚠️ Security Warning

This crate is provided for the purposes of legacy interoperability with protocols and systems which mandate the use of MD5.

However, MD5 is cryptographically broken and unsuitable for further use.

Collision attacks against MD5 are both practical and trivial, and theoretical attacks against MD5's preimage resistance have been found.

RFC 6151 advises no new IETF protocols can be designed MD5-based constructions, including HMAC-MD5.

Examples

use md5::{Md5, Digest};
use hex_literal::hex;

let mut hasher = Md5::new();
hasher.update(b"hello world");
let hash = hasher.finalize();

assert_eq!(hash, hex!("5eb63bbbe01eeed093cb22bb8f5acdc3"));

// Hex-encode hash using https://docs.rs/base16ct
let hex_hash = base16ct::lower::encode_string(&hash);
assert_eq!(hex_hash, "5eb63bbbe01eeed093cb22bb8f5acdc3");

Also, see the examples section in the RustCrypto/hashes readme.

Minimum Supported Rust Version

Rust 1.72 or higher.

Minimum supported Rust version can be changed in the future, but it will be done with a minor version bump.

SemVer Policy

  • All on-by-default features of this library are covered by SemVer
  • MSRV is considered exempt from SemVer as noted above

License

The crate is licensed under either of:

at your option.

Contribution

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 above, without any additional terms or conditions.