rsasl 2.3.1

The Rust SASL framework, aimed at both middleware-style protocol implementation and application code. Designed to make SASL authentication simple and safe while handing as much control to the user as possible.
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

use crate::alloc::boxed::Box;

/// Provider side channel binding callback
///
/// This trait is designed to be implemented by a protocol implementation so it can more easily
/// abstract away over the specific TLS implementation in use while still providing channel binding
/// data during the exchange.
pub trait ChannelBindingCallback {
    /// Return channel binding data for the channel binding type `cbname`
    ///
    ///
    fn get_cb_data(&self, cbname: &str) -> Option<&[u8]>;
}

#[allow(dead_code)]
#[derive(Debug)]
pub struct NoChannelBindings;
impl ChannelBindingCallback for NoChannelBindings {
    fn get_cb_data(&self, _cbname: &str) -> Option<&[u8]> {
        None
    }
}

pub struct ThisCb {
    name: &'static str,
    value: Box<[u8]>,
}
impl ThisCb {
    #[allow(unused)]
    pub fn new(name: &'static str, value: Box<[u8]>) -> Self {
        Self { name, value }
    }
}
impl ChannelBindingCallback for ThisCb {
    fn get_cb_data(&self, cbname: &str) -> Option<&[u8]> {
        if self.name == cbname {
            Some(self.value.as_ref())
        } else {
            None
        }
    }
}

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

    use crate::config::SASLConfig;
    use crate::mechname::Mechname;
    use crate::prelude::SessionError;
    use crate::sasl::SASLClient;
    use crate::typed::Tagged;

    use crate::validate::{NoValidation, Validate};

    #[test]
    #[allow(unreachable_code)]
    fn test_this_cb() {
        let cbdata = b"foobar";
        let thiscb = ThisCb::new("this-cb", cbdata.to_vec().into_boxed_slice());
        let config = SASLConfig::with_credentials(None, String::new(), String::new()).unwrap();
        let sasl = SASLClient::with_cb(config, thiscb);
        let session = sasl
            .start_suggested(&[Mechname::parse(b"PLAIN").unwrap()])
            .unwrap();

        let mut tagged_option = Tagged::<'_, NoValidation>(None);
        let validate = Validate::new::<NoValidation>(&mut tagged_option);
        session
            .get_cb_data("this-cb", validate, &mut |cb| {
                println!("got {cb:?}");
                assert_eq!(cb, cbdata);
                Ok(())
            })
            .unwrap();

        let mut tagged_option = Tagged::<'_, NoValidation>(None);
        let validate = Validate::new::<NoValidation>(&mut tagged_option);
        let e = session
            .get_cb_data("blahblubb", validate, &mut |_cb| {
                panic!("returned cbdata that should not be there!");
                Ok(())
            })
            .unwrap_err();
        match e {
            SessionError::MissingChannelBindingData(name) if name.as_str() == "blahblubb" => {}
            e => panic!("Expected MissingChannelBindingData error, received {e:?}"),
        }
    }

    static_assertions::assert_obj_safe!(ChannelBindingCallback);
}