Enum Credentials 

#[non_exhaustive]
pub enum Credentials {
    Bearer {
        token: String,
    },
    ApiKey {
        key: String,
    },
    Basic {
        username: String,
        password: String,
    },
    CustomHeader {
        header_name: String,
        value: String,
    },
    ClientCertificate {
        der: Vec<u8>,
    },
    None,
}

Raw credentials extracted from a request before validation.

This enum is transport-agnostic — it represents the normalized form of whatever the client sent, regardless of whether the transport is HTTP/SSE, stdio, or something else entirely.

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.

Bearer

Authorization: Bearer <token> header.

Fields

token: String

ApiKey

X-Api-Key: <key> header, or ?api_key=<key> query parameter.

Fields

key: String

Basic

Authorization: Basic <base64(username:password)> header.

Fields

username: String

password: String

CustomHeader

A custom single-header credential. The header name is normalized to lowercase.

Fields

header_name: String

value: String

ClientCertificate

Verified TLS peer certificate (mTLS). Contains the DER-encoded bytes of the leaf certificate.

Fields

der: Vec<u8>

None

No credentials were present in the request. Used to distinguish “unauthenticated request” from “invalid credentials”.

Implementations

impl Credentials

pub fn is_none(&self) -> bool

Returns true if no credentials were provided.

pub fn kind(&self) -> &'static str

Returns a short label for logging/metrics (does not include secret values).

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

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

Formats the value using the given formatter.