Trait rustls::server::StoresServerSessions
source · [−]pub trait StoresServerSessions: Send + Sync {
fn put(&self, key: Vec<u8>, value: Vec<u8>) -> bool;
fn get(&self, key: &[u8]) -> Option<Vec<u8>>;
fn take(&self, key: &[u8]) -> Option<Vec<u8>>;
fn can_cache(&self) -> bool;
}
Expand description
A trait for the ability to store server session data.
The keys and values are opaque.
Both the keys and values should be treated as highly sensitive data, containing enough key material to break all security of the corresponding sessions.
Implementations can be lossy (in other words, forgetting key/value pairs) without any negative security consequences.
However, note that take
must reliably delete a returned
value. If it does not, there may be security consequences.
put
and take
are mutating operations; this isn’t expressed
in the type system to allow implementations freedom in
how to achieve interior mutability. Mutex
is a common
choice.
Required methods
Store session secrets encoded in value
against key
,
overwrites any existing value against key
. Returns true
if the value was stored.
Find a value with the given key
. Return it, or None
if it doesn’t exist.
Find a value with the given key
. Return it and delete it;
or None if it doesn’t exist.