Struct PairingGuard 

pub struct PairingGuard { /* private fields */ }

Implementations

impl PairingGuard

pub fn new(require_pairing: bool, existing_tokens: &[String]) -> Self

pub fn pairing_code(&self) -> Option<String>

The one-time pairing code (generated only on first startup when no tokens exist).

pub fn require_pairing(&self) -> bool

Whether pairing is required at all.

pub async fn try_pair( &self, code: &str, client_id: &str, ) -> Result<Option<String>, u64>

Attempt to pair with the given code. Returns a bearer token on success. Returns Err(lockout_seconds) if locked out due to brute force. client_id identifies the client for per-client lockout accounting.

pub fn is_authenticated(&self, token: &str) -> bool

Check if a bearer token is valid (compares against stored hashes).

pub fn is_paired(&self) -> bool

Returns true if the gateway is already paired (has at least one token).

pub fn tokens(&self) -> Vec<String>

Get all paired token hashes (for persisting to config).

pub fn revoke_token(&self, token: &str) -> bool

pub fn revoke_token_hash(&self, token_hash: &str) -> bool

Revoke a paired token by its SHA-256 hash. Returns true if removed.

pub fn revoke_all_tokens(&self) -> usize

pub fn generate_new_pairing_code(&self) -> Option<String>

Generate a new pairing code that pairs an additional client. Does not revoke existing tokens. To rotate a compromised token, pair with revoke_token/revoke_token_hash + a config persist pass.

pub fn generate_pairing_code_if_vacant( &self, ) -> Result<String, GeneratePairingCodeError>

pub fn token_hash(token: &str) -> String

Get the token hash for a given plaintext token (for device registry lookup).

pub fn authenticate_and_hash(&self, token: &str) -> Option<String>

Check if a token is paired and return its hash.

Trait Implementations

impl Clone for PairingGuard

fn clone(&self) -> PairingGuard

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PairingGuard

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

Formats the value using the given formatter.