ring for Rust: 完整指南及示例

这是什么以及为什么需要它

ring 是 Rust 语言的一个加密库，提供安全、经过验证且高性能的基本加密原语实现。它基于 BoringSSL（Google 对 OpenSSL 的一个分支）的代码，并专注于安全性、易用性和最小化攻击面。与更通用的库（如 openssl 或 rust-crypto）不同，ring 有意限制了支持的算法集，排除了过时或不安全的算法（例如 DES、RC4、MD5），从而降低了意外使用弱加密的风险。

为什么需要 ring？如果您正在开发一个 Rust 应用程序，需要执行哈希（SHA-256、SHA-512）、对称加密（AES-GCM、ChaCha20-Poly1305）、非对称加密和签名（RSA、ECDSA、Ed25519）、随机数生成或密钥协商（X25519、ECDH），那么 ring 是最佳选择。它被广泛应用于 rustls（Rust 的 TLS 实现）、reqwest（HTTP 客户端）和 webpki（证书验证）等项目。该库不需要外部依赖（Linux/macOS 上除 libc 外），并且可以通过 Cargo 编译，使其成为嵌入式系统和交叉编译的理想选择。

ring 的主要优势：安全性（持续审计，无不安全算法）、性能（使用来自 BoringSSL 的优化汇编代码）和 API 简洁性（类型和函数数量最少，文档清晰）。ring 不提供高级抽象，例如证书或协议处理——这些由单独的 crate 处理。相反，它提供了可以安全组合的构建块。

安装

要将 ring 添加到 Rust 项目，请在项目根目录中执行以下命令：

cargo add ring

或者手动添加到 Cargo.toml 文件中：

[dependencies]\nring = "0.17"

截至撰写本文时，最新版本是 0.17.x。请确保您已安装 Rust（rustc 1.70+）。ring 需要 C 编译器（gcc、clang 或 msvc）来构建 BoringSSL 的原生组件。在 Windows 上，可能需要安装 Build Tools for Visual Studio。

快速入门——最小工作示例

创建一个新项目，并将 src/main.rs 的内容替换为以下代码，该代码计算字符串的 SHA-256 哈希值：

use ring::digest::{Context, SHA256};\nuse ring::rand::SystemRandom;\n\nfn main() {\n    // SHA-256 哈希\n    let mut context = Context::new(&SHA256);\n    context.update("Hello, ring!".as_bytes());\n    let digest = context.finish();\n    println!("SHA-256: {:?}", digest);\n\n    // 生成随机字节\n    let rng = SystemRandom::new();\n    let mut random_bytes = [0u8; 32];\n    ring::rand::fill(&rng, &mut random_bytes).unwrap();\n    println!("Random bytes: {:02x?}", random_bytes);\n}

使用命令 cargo run 运行程序。您将看到 SHA-256 哈希值和 32 个十六进制格式的随机字节。

主要方法/函数

1. ring::digest::digest

签名： pub fn digest(algorithm: &'static Algorithm, data: &[u8]) -> Digest

描述： 使用指定的算法（SHA256、SHA384、SHA512、SHA1）计算 data 的哈希值。这是一个用于简单情况的单次传递函数。

use ring::digest::{digest, SHA256};\n\nlet data =