Rust密钥管理库tor-keymgr的使用指南

tor-keymgr是Tor项目中的一个Rust库，专门用于安全高效的密钥存储与加密操作。它为Tor网络客户端和服务器提供了密钥管理的基础设施。

主要功能

• 安全存储加密密钥
• 提供密钥生成和轮换功能
• 支持多种密钥类型和加密算法
• 实现密钥的持久化存储
• 提供密钥访问控制机制

基本使用方法

添加依赖

首先在Cargo.toml中添加依赖：

[dependencies]
tor-keymgr = "0.1"

创建密钥存储

use tor_keymgr::KeyMgr;

// 创建一个新的密钥管理器
let key_mgr = KeyMgr::new();

生成和存储密钥

use tor_keymgr::KeyType;

// 生成一个新的Ed25519密钥对
let key_type = KeyType::Ed25519Keypair;
let key_name = "my_key".to_string();

key_mgr.generate_and_store(key_type, &key_name)?;

检索密钥

// 检索之前存储的密钥
let retrieved_key = key_mgr.get(&key_name, key_type)?;

match retrieved_key {
    Some(key) => println!("找到密钥: {:?}", key),
    None => println!("未找到指定密钥"),
}

密钥轮换

// 轮换现有密钥
key_mgr.rotate(&key_name, key_type)?;

高级用法

自定义密钥存储后端

use tor_keymgr::{KeyMgr, KeyStore};

struct MyCustomKeyStore;

impl KeyStore for MyCustomKeyStore {
    // 实现必要的trait方法
}

let custom_store = MyCustomKeyStore;
let key_mgr = KeyMgr::with_store(Box::new(custom_store));

加密密钥材料

use tor_keymgr::EncryptedKey;

// 加密密钥
let plaintext_key = b"my_secret_key";
let encrypted = EncryptedKey::encrypt(plaintext_key, "strong_password")?;

// 解密密钥
let decrypted = encrypted.decrypt("strong_password")?;
assert_eq!(decrypted, plaintext_key);

安全注意事项

1. 始终确保密钥存储位置的安全
2. 定期轮换敏感密钥
3. 不要将密钥硬编码在源代码中
4. 使用强密码保护加密的密钥材料
5. 在生产环境中实现适当的访问控制

完整示例演示

以下是内容中提供的示例代码：

use tor_keymgr::{KeyMgr, KeyType};

fn main() -> anyhow::Result<()> {
    // 初始化密钥管理器
    let key_mgr = KeyMgr::new();
    
    // 定义密钥名称和类型
    let key_name = "example_ed25519_key".to_string();
    let key_type = KeyType::Ed25519Keypair;
    
    // 生成并存储密钥
    key_mgr.generate_and_store(key_type, &key_name)?;
    
    // 检索并使用密钥
    if let Some(key) = key_mgr.get(&key_name, key_type)? {
        println!("成功获取密钥: {:?}", key);
        
        // 使用密钥进行加密/签名操作...
    }
    
    // 轮换密钥
    key_mgr.rotate(&key_name, key_type)?;
    
    // 删除密钥
    key_mgr.remove(&key_name, key_type)?;
    
    Ok(())
}

完整示例demo

下面是一个更完整的示例，展示了tor-keymgr库的完整使用流程：

use tor_keymgr::{KeyMgr, KeyType, EncryptedKey};
use anyhow::Result;

fn main() -> Result<()> {
    // 1. 初始化密钥管理器
    let key_mgr = KeyMgr::new();
    
    // 2. 定义密钥信息
    let key_name = "secure_communication_key".to_string();
    let key_type = KeyType::Ed25519Keypair;
    
    // 3. 生成并存储密钥
    println!("正在生成新密钥...");
    key_mgr.generate_and_store(key_type, &key_name)?;
    println!("密钥生成并存储成功");
    
    // 4. 检索密钥
    println!("尝试检索密钥...");
    match key_mgr.get(&key_name, key_type)? {
        Some(key) => {
            println!("成功检索到密钥");
            
            // 5. 演示加密密钥材料
            println!("加密密钥材料...");
            let encrypted = EncryptedKey::encrypt(b"secret_data", "my_strong_password")?;
            
            // 6. 演示解密
            let decrypted = encrypted.decrypt("my_strong_password")?;
            println!("解密成功: {:?}", decrypted);
        }
        None => println!("未找到密钥"),
    }
    
    // 7. 密钥轮换
    println!("轮换密钥...");
    key_mgr.rotate(&key_name, key_type)?;
    println!("密钥轮换完成");
    
    // 8. 删除密钥
    println!("删除密钥...");
    key_mgr.remove(&key_name, key_type)?;
    println!("密钥删除完成");
    
    Ok(())
}

这个完整示例展示了以下功能：

1. 初始化密钥管理器
2. 定义密钥名称和类型
3. 生成并存储新密钥
4. 检索现有密钥
5. 使用EncryptedKey加密敏感数据
6. 解密加密数据
7. 轮换密钥
8. 安全删除密钥

tor-keymgr为Tor网络应用提供了强大而灵活的密钥管理解决方案，通过合理使用可以显著提升应用的安全性。