Struct TimeOptions 

#[non_exhaustive]
pub struct TimeOptions {
    pub now: Option<DateTime<Utc>>,
    pub leeway: Duration,
}

Available on crate feature vc only.

The validation time and the clock skew allowed around it.

Examples

use std::time::Duration;

use chrono::{TimeZone as _, Utc};
use identity_kit::vc::validation::TimeOptions;

let fixed = TimeOptions::at(Utc.with_ymd_and_hms(2019, 11, 6, 0, 0, 0).unwrap())
    .with_leeway(Duration::from_secs(60));
assert_eq!(fixed.now().to_rfc3339(), "2019-11-06T00:00:00+00:00");
assert_eq!(fixed.leeway, Duration::from_secs(60));
assert!(TimeOptions::default().now() > fixed.now());

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

now: Option<DateTime<Utc>>

The validation time; the current time when None.

leeway: Duration

How far nbf, exp and iat may miss the validation time and still pass; zero by default.

Implementations

impl TimeOptions

pub fn at(now: DateTime<Utc>) -> Self

Options validating at now.

pub fn with_leeway(self, leeway: Duration) -> Self

These options with leeway.

pub fn now(&self) -> DateTime<Utc>

The validation time.

pub fn check( &self, not_before: Option<DateTime<Utc>>, expires: Option<DateTime<Utc>>, issued_at: Option<DateTime<Utc>>, ) -> Result<(), ValidationError>

Checks that now is within [not_before, expires) with the leeway, and that issued_at is not in the future.

Errors

ValidationError::NotYetValid, ValidationError::Expired or ValidationError::IssuedInFuture.

pub fn check_claims(&self, claims: &JwtClaims) -> Result<(), ValidationError>

Checks the registered time claims of claims: nbf, exp and iat.

Errors

As check, or ValidationError::Credential for a claim out of range.

Trait Implementations

impl Clone for TimeOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimeOptions

impl Debug for TimeOptions

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

Formats the value using the given formatter.

impl Default for TimeOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TimeOptions

impl PartialEq for TimeOptions

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TimeOptions