Skip to main content

TokenIssuer

Struct TokenIssuer 

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

A service’s token issuer: its signing key (rotatable, the old one kept in the JWKS for one token lifetime and the skew), the lifetime it mints, and the audit sink.

Implementations§

Source§

impl TokenIssuer

Source

pub fn new(key: PeerKey) -> Self

An issuer signing with key, minting tokens of MAX_LIFETIME.

Source

pub fn with_ttl(self, ttl: Duration) -> Self

Tokens of ttl (at most MAX_LIFETIME).

Source

pub fn with_audit(self, sink: Arc<dyn TokenAudit>) -> Self

Audit records also to sink.

Source

pub fn kid(&self) -> String

The signing key’s id now.

Source

pub fn ttl(&self) -> Duration

The lifetime it mints.

Source

pub fn jwks(&self) -> Jwks

The keys a peer verifies with: the current one, and each retired one while a token it signed may still be presented.

Source

pub fn rotate(&self, new: PeerKey) -> String

Sign with new from now; the old key stays in Self::jwks for one token lifetime and the skew, then goes.

Source

pub fn mint(&self, req: MintRequest) -> Result<(String, PeerClaims), TokenError>

Mint one forwarded call’s token (an exchange when req.presented).

Source

pub fn mint_at( &self, req: MintRequest, now: u64, ) -> Result<(String, PeerClaims), TokenError>

Self::mint as of now.

Source

pub fn exchange( &self, subject: &str, proof: Option<&str>, name: &str, peer_key: Option<String>, requested: Option<&[String]>, call: &str, method: &str, seen: &ProofCache, ) -> Result<(String, PeerClaims), TokenError>

RFC 8693 token exchange, as a method answers it: subject (a token this issuer minted, presented by its audience with proof when it is key-bound) becomes a token for audience (peer_key, a name for a pipe), its scope requested narrowed by the presented one.

Source

pub fn verify_own(&self, token: &str) -> Result<PeerClaims, TokenError>

A token this issuer minted (any audience), signature and times checked — what the issuer reads back when a peer presents it.

Trait Implementations§

Source§

impl Debug for TokenIssuer

Source§

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

Formats the value using the given formatter. 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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

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> MaybeSend for T
where T: Send,

Source§

impl<T> MaybeSendSync for T
where T: Send + Sync,

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
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<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

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