Skip to main content

AuthenticatorChain

Struct AuthenticatorChain 

Source
pub struct AuthenticatorChain { /* private fields */ }
Expand description

An ordered set of Authenticators tried in turn.

The chain is what makes “idp is one authenticator among several” structural rather than aspirational: plexus-idp registers its bearer, cookie, and API-key authenticators into a chain, and a nostr gateway would push one more in without any of them knowing about each other.

§Ordering and short-circuiting

Authenticators are tried in insertion order. The first one whose authenticate returns anything other than Unsupported decides the outcome — success or failure. A malformed JWT therefore does not fall through to the API-key authenticator hoping it will be luckier.

Implementations§

Source§

impl AuthenticatorChain

Source

pub fn new() -> Self

An empty chain, which rejects everything.

Source

pub fn with(self, authenticator: Arc<dyn Authenticator>) -> Self

Append an authenticator.

Source

pub fn try_with( self, authenticator: Arc<dyn Authenticator>, ) -> Result<Self, String>

Append an authenticator, refusing one whose name the chain already holds (IDENTITY-27): two providers of one name would mint one namespace. The error is the repeated name.

Source

pub fn names(&self) -> Vec<&str>

The names of the registered authenticators, in order.

Source

pub fn is_empty(&self) -> bool

Is the chain empty?

Source

pub async fn authenticate( &self, presentation: &Presentation, ) -> Result<Authenticated, AuthnRejection>

Try each authenticator in order.

Returns the first non-Unsupported outcome. If every authenticator declines, the last Unsupported is returned (or a synthetic one for an empty chain), so the caller can tell “nobody handles this” from “somebody handled it and said no”.

Trait Implementations§

Source§

impl Clone for AuthenticatorChain

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AuthenticatorChain

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for AuthenticatorChain

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl SessionValidator for AuthenticatorChain

Adapts a chain to the existing perimeter.

The cookie header a SessionValidator receives is offered to the chain as a Presentation::Cookie; if no authenticator claims it, it is retried as a Presentation::Bearer, because plexus-idp’s validator has always accepted a bare token in the cookie position and callers depend on that.

Source§

fn validate<'life0, 'life1, 'async_trait>( &'life0 self, cookie_value: &'life1 str, ) -> Pin<Box<dyn Future<Output = Option<AuthContext>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Validate a cookie header value and return an AuthContext if valid. Read more
Source§

fn alive(&self, ctx: &AuthContext) -> Result<(), String>

AUTH-11: whether an identity this validator produced still stands — asked while the connection it opened stays open, so a signed-out or expired session’s socket is closed rather than left to its next call. Err: why not, in words for the caller. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more