Rust安全加密库solsec的使用，solsec提供高性能密码学算法和网络安全解决方案

以下是solsec库的完整使用示例，包含代码注释说明：

// 导入必要的模块
use solsec::{Scanner, ScanOptions, OutputFormat};
use std::path::PathBuf;

fn main() {
    // 1. 初始化扫描器
    let scanner = Scanner::new();
    
    // 2. 配置扫描参数
    let scan_path = PathBuf::from("./contracts"); // 扫描合约目录
    let output_dir = PathBuf::from("./security_audit"); // 输出目录
    
    let options = ScanOptions {
        output_dir: Some(output_dir),
        formats: vec![
            OutputFormat::Html,  // 生成HTML报告
            OutputFormat::Json,  // 生成JSON报告
            OutputFormat::Markdown // 生成Markdown报告
        ],
        fail_on_critical: true,  // 发现严重漏洞时失败
        verbose: true,           // 显示详细输出
        ..Default::default()     // 其他参数使用默认值
    };
    
    // 3. 执行安全扫描
    match scanner.scan(&scan_path, options) {
        Ok(results) => {
            // 4. 处理扫描结果
            println!("安全扫描完成！");
            
            // 显示问题统计
            println!("发现安全问题统计:");
            println!("危急: {}", results.critical_issues());
            println!("高: {}", results.high_issues());
            println!("中: {}", results.medium_issues());
            println!("低: {}", results.low_issues());
            
            // 检查生成的报告
            if let Some(html_path) = results.html_report_path() {
                println!("HTML报告已生成: {}", html_path.display());
            }
            
            if let Some(json_path) = results.json_report_path() {
                println!("JSON报告已生成: {}", json_path.display());
            }
            
            // 5. 根据严重问题退出码
            if results.has_critical_issues() {
                eprintln!("发现危急安全问题，请立即修复！");
                std::process::exit(1);
            }
        }
        Err(e) => {
            eprintln!("扫描过程中发生错误: {}", e);
            std::process::exit(1);
        }
    }
}

功能说明

1. 初始化扫描器：

   • 创建Scanner实例准备执行安全扫描

2. 配置扫描参数：

   • 设置要扫描的合约目录路径
   • 指定输出报告目录
   • 配置输出格式(HTML/JSON/Markdown)
   • 设置发现危急漏洞时失败

3. 执行扫描：

   • 调用scan()方法执行安全分析
   • 处理可能发生的错误

4. 处理结果：

   • 显示发现的安全问题统计
   • 检查生成的报告文件路径
   • 根据问题严重程度采取不同操作

5. 退出处理：

   • 发现危急漏洞时返回非零退出码
   • 适合CI/CD流水线集成

高级用法

自定义安全规则

use solsec::plugin::{Rule, RuleResult, Severity};
use std::path::Path;
use anyhow::Result;

// 自定义敏感数据检查规则
struct SensitiveDataRule;

impl Rule for SensitiveDataRule {
    fn name(&self) -> &str {
        "sensitive_data"
    }

    fn description(&self) -> &str {
        "检查合约中是否包含敏感数据"
    }

    fn check(&self, content: &str, _path: &Path) -> Result<Vec<RuleResult>> {
        let mut issues = Vec::new();
        let sensitive_keywords = ["private_key", "secret", "password"];
        
        for (line_num, line) in content.lines().enumerate() {
            for keyword in &sensitive_keywords {
                if line.contains(keyword) {
                    issues.push(RuleResult {
                        severity: Severity::High,
                        message: format!("检测到敏感关键字: {}", keyword),
                        line_number: Some(line_num + 1),
                        column: None,
                        code_snippet: Some(line.trim().to_string()),
                        suggestion: Some("避免在合约中硬编码敏感数据".to_string()),
                    });
                }
            }
        }
        
        Ok(issues)
    }
}

集成测试

#[cfg(test)]
mod tests {
    use super::*;
    use solsec::ScanOptions;
    use tempfile::tempdir;

    #[test]
    fn test_scan_with_critical_issues() {
        let scanner = Scanner::new();
        let test_contract = PathBuf::from("./test_contracts/vulnerable");
        let output = tempdir().unwrap();
        
        let options = ScanOptions {
            output_dir: Some(output.path().to_path_buf()),
            fail_on_critical: true,
            ..Default::default()
        };
        
        let result = scanner.scan(&test_contract, options);
        assert!(result.is_err());
    }
}

这个完整示例展示了如何：

1. 初始化配置扫描器
2. 设置扫描参数和输出选项
3. 处理扫描结果和生成报告
4. 实现自定义安全规则
5. 编写集成测试

您可以根据实际需求调整扫描选项和输出格式，solsec还支持通过配置文件进一步定制扫描行为。