pqc-fips 0.0.3

Imported pqc-combo v0.1.0
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
113
114
115
116
117

// ------------------------------------------------------------------------
// PQC-COMBO v0.0.7
// FIPS 140-3 State Machine Implementation
// ------------------------------------------------------------------------

use crate::error::{PqcError, Result};
use core::sync::atomic::{AtomicU8, Ordering};

/// FIPS 140-3 Module States
#[repr(u8)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum FipsState {
    Uninitialized = 0,
    POST = 1,
    Operational = 2,
    Error = 3,
}

impl From<u8> for FipsState {
    fn from(val: u8) -> Self {
        match val {
            0 => FipsState::Uninitialized,
            1 => FipsState::POST,
            2 => FipsState::Operational,
            3 => FipsState::Error,
            _ => FipsState::Error,
        }
    }
}

static FIPS_STATE: AtomicU8 = AtomicU8::new(FipsState::Uninitialized as u8);

pub fn get_fips_state() -> FipsState {
    FipsState::from(FIPS_STATE.load(Ordering::Acquire))
}

fn set_fips_state(state: FipsState) {
    FIPS_STATE.store(state as u8, Ordering::Release);
}

pub(crate) fn enter_post_state() {
    set_fips_state(FipsState::POST);
}

pub(crate) fn enter_operational_state() {
    set_fips_state(FipsState::Operational);
}

pub(crate) fn enter_error_state() {
    set_fips_state(FipsState::Error);
}

pub fn is_operational() -> bool {
    get_fips_state() == FipsState::Operational
}

pub fn check_operational() -> Result<()> {
    let current_state = get_fips_state();
    match current_state {
        FipsState::Operational => Ok(()),
        FipsState::Uninitialized => Err(PqcError::FipsNotInitialized),
        FipsState::POST => Err(PqcError::FipsPostInProgress),
        FipsState::Error => Err(PqcError::FipsErrorState),
    }
}

pub fn reset_fips_state() {
    set_fips_state(FipsState::Uninitialized);
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_initial_state() {
        reset_fips_state();
        assert_eq!(get_fips_state(), FipsState::Uninitialized);
        assert!(!is_operational());
    }

    #[test]
    fn test_state_transitions() {
        reset_fips_state();
        
        enter_post_state();
        assert_eq!(get_fips_state(), FipsState::POST);
        assert!(!is_operational());
        
        enter_operational_state();
        assert_eq!(get_fips_state(), FipsState::Operational);
        assert!(is_operational());
        
        enter_error_state();
        assert_eq!(get_fips_state(), FipsState::Error);
        assert!(!is_operational());
    }

    #[test]
    fn test_check_operational() {
        reset_fips_state();
        
        assert!(check_operational().is_err());
        assert_eq!(check_operational().unwrap_err(), PqcError::FipsNotInitialized);
        
        enter_post_state();
        assert!(check_operational().is_err());
        assert_eq!(check_operational().unwrap_err(), PqcError::FipsPostInProgress);
        
        enter_operational_state();
        assert!(check_operational().is_ok());
        
        enter_error_state();
        assert!(check_operational().is_err());
        assert_eq!(check_operational().unwrap_err(), PqcError::FipsErrorState);
    }
}