RustCrypto: 哈希

纯 Rust 编写的加密哈希函数集合。

所有算法都位于独立的 crate 中，并使用 digest crate 中的 trait 实现。此外，所有 crate 都不需要标准库（即 no_std 兼容），可以轻松用于裸机或 WebAssembly 编程。

支持的算法

注意：对于新应用，或者当与其他现有标准的兼容性不是主要关注点时，我们强烈建议使用 BLAKE2、SHA-2 或 SHA-3。

算法	crate	Crates.io	文档	MSRV	安全性
Ascon 哈希	ascon-hash				💚
BelT 哈希	belt-hash				💚
BLAKE2	blake2				💚
FSB	fsb				💚
GOST R 34.11-94	gost94				💛
Grøstl (Groestl)	groestl				💚
JH	jh				💚
KangarooTwelve	k12				💚
MD2	md2				💔
MD4	md4				💔
MD5	md5 ❗				💔
RIPEMD	ripemd				💚
SHA-1	sha1				💔
SHA-1 检查	sha1-checked				💛
SHA-2	sha2				💚
SHA-3 (Keccak)	sha3				💚
SHABAL	shabal				💚
Skein	skein				💚
SM3 (OSCCA GM/T 0004-2012)	sm3				💚
Streebog (GOST R 34.11-2012)	streebog				💛
Tiger	tiger				💚
Whirlpool	whirlpool				💚

注意：blake3 crate 实现了此存储库中其余哈希使用的 digest traits，但由 BLAKE3 团队维护。

安全级别图例

以下描述了每个哈希函数（即算法，而不是具体实现）相关的安全级别评级

有关更多信息，请参阅维基百科上的安全性页面。

容器名称

尽可能情况下，容器以与容器文件夹相同的名称发布。md5 md5 的拥有者拒绝参与此项目。此容器未实现 digest 特性，因此与 RustCrypto 生态系统不兼容。这就是我们以 md-5 的形式发布我们的 MD5 实现，并使用 ❗ 标记的原因。请注意，库本身被命名为 md5，即在 use 语句中，您应使用 md5，而不是 md_5。

SHA-1 实现之前以 sha-1 的形式发布，但自 v0.10.0 版本以来已迁移到 sha1。 sha-1 将继续接收 v0.10.x 补丁更新，但在 sha1 v0.11 版本发布后将被弃用。

最低支持的 Rust 版本（MSRV）策略

MSRV 的增加被视为破坏性更改，并且只有在进行小版本号增加时才会执行。

示例

让我们以 SHA-2 为例，演示如何使用此存储库中的容器。

首先将 sha2 容器添加到您的 Cargo.toml

[dependencies]
sha2 = "0.10"

请注意，此存储库中的所有容器默认都启用了 std 功能。因此，如果您计划在 no_std 环境中使用容器，请勿忘记禁用它

[dependencies]
sha2 = { version = "0.10", default-features = false }

sha2 和其他哈希实现容器为了方便起见重新导出 digest 容器和 Digest 特性，因此您无需将其作为显式依赖项包含在您的 Cargo.toml 中。

现在您可以编写以下代码

use sha2::{Sha256, Digest};

let mut hasher = Sha256::new();
let data = b"Hello world!";
hasher.update(data);
// `update` can be called repeatedly and is generic over `AsRef<[u8]>`
hasher.update("String data");
// Note that calling `finalize()` consumes hasher
let hash = hasher.finalize();
println!("Binary hash: {:?}", hash);

在此示例中 hash 的类型是 GenericArray<u8, U32>，它是 generic-array 容器中定义的 [u8; 32] 的泛型替代品。如果您需要将哈希值序列化为字符串，您可以使用类似 base16ct 和 base64ct 的容器。

use base64ct::{Base64, Encoding};

let base64_hash = Base64::encode_string(&hash);
println!("Base64-encoded hash: {}", base64_hash);

let hex_hash = base16ct::lower::encode_string(&hash);
println!("Hex-encoded hash: {}", hex_hash);

除了调用 update 之外，您还可以使用链式方法

use sha2::{Sha256, Digest};

let hash = Sha256::new()
    .chain_update(b"Hello world!")
    .chain_update("String data")
    .finalize();

如果有一个完整消息可用，那么您可以使用方便的 Digest::digest 方法

use sha2::{Sha256, Digest};

let hash = Sha256::digest(b"my message");

哈希可读对象

如果您想从实现 Read 特性的类型中哈希数据，则可以依赖 Write 特性的实现（需要启用默认的 std 功能）

use sha2::{Sha256, Digest};
use std::{fs, io};

let mut file = fs::File::open(&path)?;
let mut hasher = Sha256::new();
let n = io::copy(&mut file, &mut hasher)?;
let hash = hasher.finalize();

基于哈希的消息认证码（HMAC）

如果您想计算基于哈希的消息认证码（HMAC），可以使用来自哈希消息认证码（HMAC）的通用实现，该实现来自hmac包，这是RustCrypto/MACs仓库的一部分。

通用代码

您可以在Digest特质（或来自digest包的其他特质）上编写通用代码，它将在不同的哈希函数上工作。

use sha2::{Sha256, Sha512, Digest};

// Toy example, do not use it in practice!
// Instead use crates from: https://github.com/RustCrypto/password-hashing
fn hash_password<D: Digest>(password: &str, salt: &str, output: &mut [u8]) {
    let mut hasher = D::new();
    hasher.update(password.as_bytes());
    hasher.update(b"$");
    hasher.update(salt.as_bytes());
    output.copy_from_slice(&hasher.finalize())
}

let mut buf1 = [0u8; 32];
hash_password::<Sha256>("my_password", "abcd", &mut buf1);

let mut buf2 = [0u8; 64];
hash_password::<Sha512>("my_password", "abcd", &mut buf2);

如果您想使用特质对象作为哈希函数，可以使用DynDigest特质。

use digest::DynDigest;

// Dynamic hash function
fn use_hasher(hasher: &mut dyn DynDigest, data: &[u8]) -> Box<[u8]> {
    hasher.update(data);
    hasher.finalize_reset()
}

// You can use something like this when parsing user input, CLI arguments, etc.
// DynDigest needs to be boxed here, since function return should be sized.
fn select_hasher(s: &str) -> Box<dyn DynDigest> {
    match s {
        "md5" => Box::new(md5::Md5::default()),
        "sha1" => Box::new(sha1::Sha1::default()),
        "sha224" => Box::new(sha2::Sha224::default()),
        "sha256" => Box::new(sha2::Sha256::default()),
        "sha384" => Box::new(sha2::Sha384::default()),
        "sha512" => Box::new(sha2::Sha512::default()),
        _ => unimplemented!("unsupported digest: {}", s),
    }
}

let mut hasher1 = select_hasher("md5");
let mut hasher2 = select_hasher("sha512");

// the `&mut *hasher` is to DerefMut the value out of the Box
// this is equivalent to `DerefMut::deref_mut(&mut hasher)`

// can be reused due to `finalize_reset()`
let hash1_1 = use_hasher(&mut *hasher1, b"foo");
let hash1_2 = use_hasher(&mut *hasher1, b"bar");
let hash2_1 = use_hasher(&mut *hasher2, b"foo");

许可证

此仓库中的所有包均受以下任一许可证的许可：

• Apache License，版本2.0
• MIT许可证

任选其一。

贡献

除非您明确声明，否则根据Apache-2.0许可证定义，您有意提交以包含在本作品中的任何贡献将按上述方式双重许可，不附加任何额外条款或条件。