Struct jwt_compact::Renamed

pub struct Renamed<A> { /* private fields */ }

Algorithm that uses a custom name when creating and validating tokens.

Examples

use jwt_compact::{alg::{Hs256, Hs256Key}, prelude::*, Empty, Renamed};

let alg = Renamed::new(Hs256, "HS2");
let key = Hs256Key::new(b"super_secret_key_donut_steel");
let token_string = alg.token(&Header::empty(), &Claims::empty(), &key)?;

let token = UntrustedToken::new(&token_string)?;
assert_eq!(token.algorithm(), "HS2");
// Note that the created token cannot be verified against the original algorithm
// since the algorithm name recorded in the token header doesn't match.
assert!(Hs256.validator::<Empty>(&key).validate(&token).is_err());

// ...but the modified alg is working as expected.
assert!(alg.validator::<Empty>(&key).validate(&token).is_ok());

Implementations

impl<A: Algorithm> Renamed<A>

pub fn new(algorithm: A, new_name: &'static str) -> Self

Creates a renamed algorithm.

Trait Implementations

impl<A: Algorithm> Algorithm for Renamed<A>

type SigningKey = <A as Algorithm>::SigningKey

Key used when issuing new tokens.

type VerifyingKey = <A as Algorithm>::VerifyingKey

Key used when verifying tokens. May coincide with Self::SigningKey for symmetric algorithms (e.g., HS*).

type Signature = <A as Algorithm>::Signature

Signature produced by the algorithm.

fn name(&self) -> Cow<'static, str>

Returns the name of this algorithm, as mentioned in the alg field of the JWT header.

fn sign( &self, signing_key: &Self::SigningKey, message: &[u8], ) -> Self::Signature

Signs a message with the signing_key.

fn verify_signature( &self, signature: &Self::Signature, verifying_key: &Self::VerifyingKey, message: &[u8], ) -> bool

Verifies the message against the signature and verifying_key.

impl<A: Clone> Clone for Renamed<A>

fn clone(&self) -> Renamed<A>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<A: Debug> Debug for Renamed<A>

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

Formats the value using the given formatter.

impl<A: Copy> Copy for Renamed<A>