Enum Credentials 

#[non_exhaustive]
pub enum Credentials {
    Basic {
        username: String,
        password: String,
    },
    Digest {
        username: String,
        password: String,
    },
    Bearer {
        token: String,
    },
}

Credentials for one of the supported auth schemes.

Basic and Digest both carry a username/password and are treated identically by crate::respond/crate::Authenticator: which wire scheme is actually used is decided by the server’s challenge, not by which variant was constructed (RFC 7235 content negotiation — a server may offer either, or both, in WWW-Authenticate). Use Credentials::new for the common password case; construct Basic/Digest directly only when the caller must pin one scheme.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Basic

Username/password for HTTP Basic auth (RFC 7617) — or RTSP’s reuse of it (RFC 2326 §14/§16).

Fields

username: String

Account username.

password: String

Account password.

Digest

Username/password for HTTP Digest auth (RFC 7616) — or RTSP’s reuse of it (RFC 2326 §14).

Fields

username: String

Account username.

password: String

Account password.

Bearer

A bearer token (RFC 6750) — sent verbatim as Authorization: Bearer <token> with no challenge round-trip required.

Fields

token: String

The opaque bearer token.

Implementations

impl Credentials

pub fn new( username: impl Into<String>, password: impl Into<String>, ) -> Credentials

Convenience constructor for the common password-based case.

Does not commit to Basic or Digest: crate::respond/ crate::Authenticator::from_challenge answer whichever scheme the server’s WWW-Authenticate challenge advertises. Internally this builds a Digest value (the superset — http-auth’s challenge parser inspects the challenge itself, not this variant, to pick the wire scheme), so new("u", "p") behaves identically to a hand-constructed Basic/Digest with the same username/password.

pub fn bearer(token: impl Into<String>) -> Credentials

Constructs a bearer-token credential (RFC 6750).

Trait Implementations

impl Clone for Credentials

fn clone(&self) -> Credentials

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Credentials

Manual Debug (rather than #[derive(Debug)]): every scheme carries a secret (password/token) that must never render verbatim. Usernames are not secret and are shown as-is to keep the output useful for diagnostics.

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

Formats the value using the given formatter.

impl Eq for Credentials

impl PartialEq for Credentials

fn eq(&self, other: &Credentials) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Credentials