Trait rsasl::mechanism::Authentication

source · [−]

pub trait Authentication {
    fn step(
        &mut self, 
        session: &mut SessionData, 
        input: Option<&[u8]>, 
        writer: &mut dyn Write
    ) -> StepResult;

    fn encode(&mut self, _input: &[u8]) -> Result<Box<[u8]>, SessionError> { ... }
    fn decode(&mut self, _input: &[u8]) -> Result<Box<[u8]>, SessionError> { ... }
}

Expand description

Trait implemented to be one party in an authentication exchange

This trait is used irrespectively of the side of the authentication exchange, i.e. it gets used both on the client side and on the server side. If the Mechanism being implemented is not symmetric but has different behaviour depending on the side an Implementation should define two distinct types representing the client and server side:

// Data required for both sides
struct Common {
    step: usize,
    hash: [u8; 64],
}
#[repr(transparent)]
pub struct Client(Common);
#[repr(transparent)]
pub struct Server(Common);

impl Authentication for Client {
    fn step(&mut self, session: &mut SessionData, input: Option<&[u8]>, writer: &mut dyn Write) -> StepResult {
        match self.0.step {
            0 => { }
            _ => { }
        }
    }
}
impl Authentication for Server {
    fn step(&mut self, session: &mut SessionData, input: Option<&[u8]>, writer: &mut dyn Write) -> StepResult {
    }
}