Struct MachineToken 

pub struct MachineToken { /* private fields */ }

The machine token a client presents to a broker, with its provenance.

• Explicit (auth.machine_token / SYNAPS_MACHINE_TOKEN, i.e. a non-empty configured token): fixed. Never replaced by, and never sent alongside, the local file token (prA N1) — even on a loopback endpoint, which may be an ssh -L tunnel to a remote broker.
• None configured + loopback endpoint: the local broker’s <base_dir>/auth-broker.token, read now and re-read after a 401 (prA I2), so a long-lived client started before the broker’s first run, or across a rotation, recovers without a restart.
• None configured + remote endpoint: empty, never reads the file.

Clones share the current value.

Implementations

impl MachineToken

pub fn for_endpoint(endpoint: &str, token: impl Into<String>) -> MachineToken

token is the EXPLICITLY configured token (“” = none configured).

pub fn is_from_local_file(&self) -> bool

Whether this token comes from the local broker token file.

pub fn fixed(token: impl Into<String>) -> MachineToken

Fixed token, never reloaded.

pub fn get(&self) -> String

pub fn reload_after_unauthorized(&self) -> bool

After a 401: re-read the local broker token file. Returns true when a different non-empty token was found (and is now current).

pub async fn send( &self, make: impl Fn(&str) -> RequestBuilder, ) -> Result<Response, Error>

Send a request built with the current token; on a 401 from a loopback broker whose token file has changed, retry once with it.

Trait Implementations

impl Clone for MachineToken

fn clone(&self) -> MachineToken

Returns a duplicate of the value.

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

Performs copy-assignment from source.