Struct Claims

pub struct Claims<T> {
    pub expiration: Option<DateTime<Utc>>,
    pub not_before: Option<DateTime<Utc>>,
    pub issued_at: Option<DateTime<Utc>>,
    pub custom: T,
}

Claims encoded in a token.

Claims are comprised of a “standard” part (exp, nbf and iat claims as per JWT spec), and custom fields. iss, sub and aud claims are not in the standard part due to a variety of data types they can be reasonably represented by.

Fields

expiration: Option<DateTime<Utc>>

Expiration time of the token.

not_before: Option<DateTime<Utc>>

Minimum time at which token is valid.

issued_at: Option<DateTime<Utc>>

Time of token issuance.

custom: T

Custom claims.

Implementations

impl Claims<Empty>

pub const fn empty() -> Claims<Empty>

Creates an empty claims instance.

impl<T> Claims<T>

pub const fn new(custom_claims: T) -> Claims<T>

Creates a new instance with the provided custom claims.

pub fn set_duration<F>( self, options: &TimeOptions<F>, duration: TimeDelta, ) -> Claims<T>

where F: Fn() -> DateTime<Utc>,

Sets the expiration claim so that the token has the specified duration. The current timestamp is taken from options.

pub fn set_duration_and_issuance<F>( self, options: &TimeOptions<F>, duration: TimeDelta, ) -> Claims<T>

where F: Fn() -> DateTime<Utc>,

Atomically sets issued_at and expiration claims: first to the current time (taken from options), and the second to match the specified duration of the token.

pub fn set_not_before(self, moment: DateTime<Utc>) -> Claims<T>

Sets the nbf claim.

pub fn validate_expiration<F>( &self, options: &TimeOptions<F>, ) -> Result<&Claims<T>, ValidationError>

where F: Fn() -> DateTime<Utc>,

Validates the expiration claim.

This method will return an error if the claims do not feature an expiration time, or if it is in the past (subject to the provided options).

pub fn validate_maturity<F>( &self, options: &TimeOptions<F>, ) -> Result<&Claims<T>, ValidationError>

where F: Fn() -> DateTime<Utc>,

Validates the maturity time (nbf claim).

This method will return an error if the claims do not feature a maturity time, or if it is in the future (subject to the provided options).

Trait Implementations

impl<T> Clone for Claims<T>

where T: Clone,

fn clone(&self) -> Claims<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Claims<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Claims<T>

where T: Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Claims<T>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Ord for Claims<T>

where T: Ord,

fn cmp(&self, other: &Claims<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T> PartialEq for Claims<T>

where T: PartialEq,

fn eq(&self, other: &Claims<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> PartialOrd for Claims<T>

where T: PartialOrd,

fn partial_cmp(&self, other: &Claims<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> Serialize for Claims<T>

where T: Serialize,

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Eq for Claims<T>

where T: Eq,

impl<T> StructuralPartialEq for Claims<T>