Struct CustomHeaderProvider 

pub struct CustomHeaderProvider { /* private fields */ }

Validates a custom HTTP header credential (e.g. X-Internal-Token).

The transport layer extracts the value of the configured header and wraps it in Credentials::CustomHeader before passing it to this provider.

Examples

use mcp_kit::auth::{CustomHeaderProvider, AuthenticatedIdentity};

let provider = CustomHeaderProvider::new("x-internal-token", |value| async move {
    if value == "trusted" {
        Ok(AuthenticatedIdentity::new("internal-service"))
    } else {
        Err(mcp_kit::McpError::Unauthorized("invalid token".into()))
    }
});

Implementations

impl CustomHeaderProvider

pub fn new<F, Fut>(header_name: impl Into<String>, f: F) -> Self

where F: Fn(String) -> Fut + Send + Sync + 'static, Fut: Future<Output = McpResult<AuthenticatedIdentity>> + Send + 'static,

Create a provider that validates values from the named header.

header_name is case-insensitive; it will be normalised to lowercase.

pub fn header_name(&self) -> &str

The header name this provider expects (normalised to lowercase).

Trait Implementations

impl AuthProvider for CustomHeaderProvider

fn authenticate<'a>(&'a self, credentials: &'a Credentials) -> AuthFuture<'a>

Validate credentials and return the authenticated identity, or an error.

fn accepts(&self, credentials: &Credentials) -> bool

Returns true if this provider knows how to handle the given credential variant. Used by CompositeAuthProvider to select the right delegate without unnecessarily calling authenticate.