Struct UserStore 

pub struct UserStore { /* private fields */ }

In-memory, serializable collection of users keyed by name.

Implementations

impl UserStore

pub fn new() -> Self

Create an empty store.

pub fn create_user( &mut self, name: &str, password: &str, role: &str, ) -> Result<(), AuthError>

Create a new user.

Errors if name already exists or role is not a known builtin. The password is hashed with argon2id before storage.

pub fn authenticate(&self, name: &str, candidate: &str) -> Option<&User>

Authenticate a user by name + candidate password.

Returns Some(&User) only on a verified match. Unknown user or wrong password both return None.

pub fn set_role(&mut self, name: &str, role: &str) -> Result<(), AuthError>

Reassign a user’s role.

Errors if the user is unknown or the role is not a known builtin.

pub fn set_password( &mut self, name: &str, new_password: &str, ) -> Result<(), AuthError>

Replace a user’s password with a new argon2id hash, preserving role.

Errors if the user is unknown. The new plaintext is held in a buffer that is zeroed on drop.

pub fn delete_user(&mut self, name: &str) -> Result<(), AuthError>

Remove a user. Errors if the user is unknown.

pub fn len(&self) -> usize

Number of users in the store.

pub fn is_empty(&self) -> bool

Whether the store has no users. When empty, the server falls back to the legacy shared-password authentication path.

pub fn list_users(&self) -> Vec<(String, String)>

List users as (name, role) pairs. Never exposes password hashes.

pub fn save(&self, dir: &Path) -> Result<()>

Persist the store to dir/auth.json as pretty JSON.

On Unix the file is written with mode 0600.

pub fn load(dir: &Path) -> Result<Self>

Load the store from dir/auth.json.

If the file does not exist, returns an empty store.

Trait Implementations

impl Clone for UserStore

fn clone(&self) -> UserStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UserStore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for UserStore

fn default() -> UserStore

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UserStore

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UserStore

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.