ciphern 0.2.1

Enterprise-grade cryptographic library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

// Copyright (c) 2025 Kirky.X
//
// Licensed under the MIT License
// See LICENSE file in the project root for full license information.

//! FIPS Compliance Examples
//!
//! This module demonstrates FIPS compliance features and best practices
//! when using Ciphern in regulated environments.

#[path = "_common/mod.rs"]
mod common;

use common::print_section;

/// Run all FIPS compliance examples
pub fn run_all() -> Result<(), Box<dyn std::error::Error>> {
    run_fips_mode_example()?;
    run_algorithm_validation_example()?;
    run_self_test_example()?;
    Ok(())
}

/// FIPS Mode Example
///
/// Demonstrates enabling and using FIPS 140-2 compliant mode.
pub fn run_fips_mode_example() -> Result<(), Box<dyn std::error::Error>> {
    print_section("FIPS 140-2 Compliant Mode Example");

    println!("  Checking FIPS mode status...");

    let is_enabled = ciphern::is_fips_enabled();
    println!("  FIPS mode enabled: {}", is_enabled);

    let algorithms = ciphern::get_fips_approved_algorithms();
    println!("  Approved algorithms count: {}", algorithms.len());
    for algo in &algorithms {
        println!("    - {:?}", algo);
    }

    println!("  ✓ FIPS mode example completed!");

    Ok(())
}

/// Algorithm Validation Example
///
/// Demonstrates validating algorithms for FIPS compliance.
pub fn run_algorithm_validation_example() -> Result<(), Box<dyn std::error::Error>> {
    print_section("Algorithm Validation Example");

    println!("  FIPS approved algorithms:\n");

    let algorithms = vec![
        ciphern::Algorithm::AES256GCM,
        ciphern::Algorithm::ECDSAP384,
        ciphern::Algorithm::Ed25519,
        ciphern::Algorithm::RSA3072,
    ];

    for algo in &algorithms {
        let is_approved = ciphern::get_fips_approved_algorithms().contains(algo);
        println!(
            "  {:?}: {}",
            algo,
            if is_approved {
                "Approved"
            } else {
                "Not approved"
            }
        );
    }

    println!("  ✓ Algorithm validation example completed!");

    Ok(())
}

/// Self-Test Example
///
/// Demonstrates FIPS-required self-tests.
pub fn run_self_test_example() -> Result<(), Box<dyn std::error::Error>> {
    print_section("Self-Tests Example");

    println!("  Note: FIPS self-tests run automatically on library initialization\n");

    let is_enabled = ciphern::is_fips_enabled();
    println!(
        "  FIPS mode: {}",
        if is_enabled { "Enabled" } else { "Disabled" }
    );

    let algorithms = ciphern::get_fips_approved_algorithms();
    println!("  Approved algorithms: {}", algorithms.len());

    if is_enabled {
        println!("  ✓ FIPS self-tests passed during initialization");
    } else {
        println!("  Note: Run with --features fips to enable FIPS self-tests");
    }

    println!("  [OK] Self-test example completed!");

    Ok(())
}

fn main() {
    if let Err(e) = run_all() {
        eprintln!("Error: {}", e);
        std::process::exit(1);
    }
}