rsasl 2.3.0

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

use crate::property::{Property, SizedProperty};

/// Iterations of a hash or key derivation algorithm used
#[non_exhaustive]
pub struct Iterations;
impl SizedProperty<'_> for Iterations {
    type Value = u32;
}

/// The Salt added to the password
#[non_exhaustive]
pub struct Salt;
impl Property<'_> for Salt {
    type Value = [u8];
}

/// The algorithm name
#[non_exhaustive]
pub struct AlgorithmName;
impl Property<'_> for AlgorithmName {
    type Value = str;
}

/// Retrieve a stored SCRAM password from persistent storage
///
/// This property is used by SCRAM mechanisms to retrieve the secrets required to authenticate an
/// user.
#[non_exhaustive]
pub struct ScramStoredPassword<'a> {
    pub iterations: u32,
    pub salt: &'a [u8],
    pub stored_key: &'a [u8],
    pub server_key: &'a [u8],
}
impl<'a> ScramStoredPassword<'a> {
    #[must_use]
    pub const fn new(
        iterations: u32,
        salt: &'a [u8],
        stored_key: &'a [u8],
        server_key: &'a [u8],
    ) -> Self {
        Self {
            iterations,
            salt,
            stored_key,
            server_key,
        }
    }
}
impl<'a> Property<'a> for ScramStoredPassword<'static> {
    type Value = ScramStoredPassword<'a>;
}

/// Callback to store generated keys for future use
///
/// actionable but also satisfiable, depends.
/// This property is used by the SCRAM mechanism on the client side of an authentication, and
/// an action callback for this property will be issued when the server has been authenticated.
/// This allows a client to store the derived keys in a persistent database and use them in
/// future authentication exchanges.
#[non_exhaustive]
pub struct ScramCachedPassword<'a> {
    pub client_key: &'a [u8],
    pub server_key: &'a [u8],
}
impl<'a> Property<'a> for ScramCachedPassword<'static> {
    type Value = ScramCachedPassword<'a>;
}

/// A salted and hashed password
#[non_exhaustive]
pub struct SaltedPassword;
impl Property<'_> for SaltedPassword {
    type Value = [u8];
}