hessra-ffi 0.3.0

C FFI bindings for Hessra token verification and configuration
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

use std::ffi::CString;
use std::os::raw::c_char;
use std::ptr;

/// Result type for Hessra FFI functions.
#[allow(non_camel_case_types)]
#[repr(C)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum HessraResult {
    SUCCESS = 0,
    ERROR_INVALID_TOKEN = 1,
    ERROR_INVALID_KEY = 2,
    ERROR_VERIFICATION_FAILED = 3,
    ERROR_CONFIG_INVALID = 4,
    ERROR_MEMORY = 5,
    ERROR_IO = 6,
    ERROR_INVALID_PARAMETER = 7,
    ERROR_UNKNOWN = 999,
}

impl From<hessra_token::TokenError> for HessraResult {
    fn from(err: hessra_token::TokenError) -> Self {
        match err {
            hessra_token::TokenError::BiscuitError(_) => HessraResult::ERROR_INVALID_TOKEN,
            hessra_token::TokenError::VerificationError(_) => {
                HessraResult::ERROR_VERIFICATION_FAILED
            }
            _ => HessraResult::ERROR_UNKNOWN,
        }
    }
}

impl From<hessra_config::ConfigError> for HessraResult {
    fn from(err: hessra_config::ConfigError) -> Self {
        #[allow(unreachable_patterns)]
        match err {
            hessra_config::ConfigError::MissingBaseUrl => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::InvalidPort => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::MissingCertificate => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::MissingKey => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::MissingServerCA => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::InvalidCertificate(_) => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::IOError(_) => HessraResult::ERROR_IO,
            hessra_config::ConfigError::ParseError(_) => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::AlreadyInitialized => HessraResult::ERROR_CONFIG_INVALID,
            hessra_config::ConfigError::EnvVarError(_) => HessraResult::ERROR_CONFIG_INVALID,
            _ => HessraResult::ERROR_UNKNOWN,
        }
    }
}

/// Get a human-readable error message for a result code
#[no_mangle]
pub extern "C" fn hessra_error_message(result: HessraResult) -> *mut c_char {
    let message = match result {
        HessraResult::SUCCESS => "Success",
        HessraResult::ERROR_INVALID_TOKEN => "Invalid token format",
        HessraResult::ERROR_INVALID_KEY => "Invalid public key",
        HessraResult::ERROR_VERIFICATION_FAILED => "Token verification failed",
        HessraResult::ERROR_CONFIG_INVALID => "Invalid configuration",
        HessraResult::ERROR_MEMORY => "Memory allocation error",
        HessraResult::ERROR_IO => "I/O error",
        HessraResult::ERROR_INVALID_PARAMETER => "Invalid parameter",
        HessraResult::ERROR_UNKNOWN => "Unknown error",
    };

    match CString::new(message) {
        Ok(c_str) => c_str.into_raw(),
        Err(_) => ptr::null_mut(),
    }
}