Struct Jwt 

pub struct Jwt {
    pub header: Header,
    pub claims: Claims,
    pub signature_b64: String,
    pub raw_header_b64: String,
    pub raw_payload_b64: String,
}

A decoded JWT token

Fields

header: Header

The JWT header

claims: Claims

The JWT claims (payload)

signature_b64: String

The signature as base64url-encoded string

raw_header_b64: String

The raw header as base64url-encoded string

raw_payload_b64: String

The raw payload as base64url-encoded string

Implementations

impl Jwt

pub fn decode(token: &str) -> Result<Self>

Decode a JWT token into its components

This is a convenience method that calls the decode function.

Arguments

• token - The JWT token string to decode

Returns

Returns a Result containing the decoded JWT or an error if the token is malformed

impl Jwt

pub fn sign(&self, key: &Key) -> Result<String>

Sign this JWT with the given key

Arguments

• key - The signing key (must match the algorithm in the header)

Returns

Returns a Result containing the signed JWT token or an error

Errors

• Error::DisabledAlg if the algorithm is not enabled via feature flags
• Error::Key if the key is invalid or doesn’t match the algorithm
• Error::Internal if signing fails

impl Jwt

pub fn verify(&self, key: &Key, opts: VerifyOptions) -> Result<()>

Verify this JWT with the given key and options

Arguments

• key - The verification key
• opts - Verification options

Returns

Returns Ok(()) if verification succeeds, or an error if it fails

pub fn verify_with_jwks(&self, jwks: &Jwks, opts: VerifyOptions) -> Result<()>

Verify this JWT using a JWKS (JSON Web Key Set)

Arguments

• jwks - The JWKS containing the verification keys
• opts - Verification options

Returns

Returns Ok(()) if verification succeeds, or an error if it fails

Errors

• Error::MissingKid if the JWT header doesn’t contain a kid field
• Error::KidNotFound if the kid is not found in the JWKS

impl Jwt

pub fn set(&mut self, path: &str, value: Value) -> Result<()>

Set a claim value using a JSON pointer path

Arguments

• path - JSON pointer path (e.g., “/sub”, “/user/name”)
• value - The value to set

Returns

Returns Ok(()) if the value was set successfully, or an error if the path is invalid

Errors

• Error::Claims if the path is invalid or traverses a non-object

Examples

use jwt_lab::{Jwt, Algorithm, Header, Claims};
use serde_json::json;

let mut jwt = Jwt {
    header: Header { alg: Algorithm::HS256, typ: None, kid: None, extra: Default::default() },
    claims: Claims(serde_json::Map::new()),
    signature_b64: String::new(),
    raw_header_b64: String::new(),
    raw_payload_b64: String::new(),
};

jwt.set("/sub", json!("user123"))?;
jwt.set("/user/name", json!("John Doe"))?;

Trait Implementations

impl Clone for Jwt

fn clone(&self) -> Jwt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Jwt

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

Formats the value using the given formatter.