Enum ClientMode 

pub enum ClientMode {
    Live,
    Emulator {
        host: String,
    },
}

Selects whether an crate::auth::AuthClient talks to production Firebase or a local emulator instance.

Variants

Live

Talk to production Firebase Authentication.

Emulator

Talk to a local Firebase Auth Emulator at host (e.g. localhost:9099).

Fields

host: String

The emulator’s host and port.

Implementations

impl ClientMode

pub fn resolve(explicit_emulator_host: Option<String>) -> Self

Resolves the mode to use: an explicitly-requested emulator host takes priority, then the FIREBASE_AUTH_EMULATOR_HOST environment variable, and otherwise ClientMode::Live.

pub fn endpoints(&self) -> IdentityToolkitEndpoints

Builds the Identity Toolkit endpoint set for this mode.

pub fn requires_bearer_token(&self) -> bool

Whether requests in this mode require an OAuth2 bearer token.

The Firebase Auth Emulator does not enforce authentication.

pub fn emulator_api_key(&self) -> Option<&'static str>

The dummy key= query parameter value to attach to Identity Toolkit REST calls in emulator mode, or None in live mode.

Every Identity Toolkit v1 accounts:* endpoint requires an API key query parameter to be present, even on the emulator — it isn’t validated there, but its absence produces the same PERMISSION_DENIED / “The request is missing a valid API key.” error the production API returns for unauthenticated calls. Production calls instead rely solely on the OAuth2 bearer token (see Self::requires_bearer_token) and must not send this parameter.

Trait Implementations

impl Clone for ClientMode

fn clone(&self) -> ClientMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientMode

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

Formats the value using the given formatter.