sasl/client/mechanisms/
plain.rs

1//! Provides the SASL "PLAIN" mechanism.
2
3use crate::client::{Mechanism, MechanismError};
4use crate::common::{Credentials, Identity, Password, Secret};
5use alloc::string::String;
6use alloc::vec::Vec;
7
8/// A struct for the SASL PLAIN mechanism.
9pub struct Plain {
10    username: String,
11    password: String,
12}
13
14impl Plain {
15    /// Constructs a new struct for authenticating using the SASL PLAIN mechanism.
16    ///
17    /// It is recommended that instead you use a `Credentials` struct and turn it into the
18    /// requested mechanism using `from_credentials`.
19    pub fn new<N: Into<String>, P: Into<String>>(username: N, password: P) -> Plain {
20        Plain {
21            username: username.into(),
22            password: password.into(),
23        }
24    }
25}
26
27impl Mechanism for Plain {
28    fn name(&self) -> &str {
29        "PLAIN"
30    }
31
32    fn from_credentials(credentials: Credentials) -> Result<Plain, MechanismError> {
33        if let Secret::Password(Password::Plain(password)) = credentials.secret {
34            if let Identity::Username(username) = credentials.identity {
35                Ok(Plain::new(username, password))
36            } else {
37                Err(MechanismError::PlainRequiresUsername)
38            }
39        } else {
40            Err(MechanismError::PlainRequiresPlaintextPassword)
41        }
42    }
43
44    fn initial(&mut self) -> Vec<u8> {
45        let mut auth = Vec::new();
46        auth.push(0);
47        auth.extend(self.username.bytes());
48        auth.push(0);
49        auth.extend(self.password.bytes());
50        auth
51    }
52}
sasl/client/mechanisms/plain.rs

sasl/client/mechanisms/
plain.rs
