jwt-lab 0.1.1

JWT crate for Rust: decode, verify, sign, mutate, JWK/JWKS, algorithm selection, time validation, and secure APIs.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

use crate::{b64, types::{Header, Claims, Jwt}, Error, Result};

/// Decode a JWT token into its components
///
/// # Arguments
///
/// * `token` - The JWT token string to decode
///
/// # Returns
///
/// Returns a `Result` containing the decoded JWT or an error if the token is malformed
///
/// # Errors
///
/// - `Error::Malformed` if the token doesn't have exactly 3 parts separated by dots
/// - `Error::Base64` if base64url decoding fails
/// - `Error::Json` if JSON parsing of header or payload fails
pub fn decode(token: &str) -> Result<Jwt> {
    let parts: Vec<&str> = token.split('.').collect();
    if parts.len() != 3 { return Err(Error::Malformed); }
    let header: Header = serde_json::from_slice(&b64::decode_url(parts[0])?)
        .map_err(|e| Error::Json(e.to_string()))?;
    let claims_map: serde_json::Map<String, serde_json::Value> =
        serde_json::from_slice(&b64::decode_url(parts[1])?).map_err(|e| Error::Json(e.to_string()))?;
    Ok(Jwt {
        header,
        claims: Claims(claims_map),
        signature_b64: parts[2].to_string(),
        raw_header_b64: parts[0].to_string(),
        raw_payload_b64: parts[1].to_string(),
    })
}

impl crate::types::Jwt {
    /// 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
    pub fn decode(token: &str) -> Result<Self> { decode(token) }
}