#jwt #parse #hs256 #parser #parse-error #derive-deserialize

yanked jwt_hs256_parse

fork form https://github.com/h-i-v-e/jwt_hs256_parse

0.1.1 Aug 16, 2022
0.1.0 Aug 16, 2022

#8 in #parse-error

MIT/Apache

10KB
139 lines

A simple library for generating and parsing JWT tokens using HMAC SHA256 as per https://jwt.io/introduction

###Encoding example

use jwt_hs256_parse;
use serde::Serialize;

#[derive(Serialize)]
struct Claims{
    sub: String,
    name: String,
    admin: bool
}

fn main(){
    let secret = "I'm a secret".as_bytes();
    let claims = Claims{
        sub: "1234567890".to_string(),
        name: "John Doe".to_string(),
        admin: true
    };
    match jwt_hs256_parse::create(secret, &claims) {
        Ok(token) => println!("Token: {}", token),
        Err(error) => println!("This can't be happening {}", error)
    }
}

###Decoding example

use jwt_hs256_parse;
use serde::Deserialize;

#[derive(Deserialize)]
struct Claims{
   sub: String
}

fn main(){
   let secret = "I'm a secret".as_bytes();
   match jwt_hs256_parse::parse::<Claims>(
       secret,
       "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.azXPRJHeWcZ_B5WHtA98gsnowX5gifvMJX2hoH_4YPs"
  ){
         Ok(claims) => println!("Sub: {}", claims.sub),
         Err(error) => match error{
             jwt_hs256_parse::Error::InvalidChecksum => println!("Secret doesn't match"),
             _ => println!("Probably not a valid JWT: {}", error)
         }
     }
}

As illustrated in the examples above you can fill your claims with bloat for the client and have the back end only extract the useful bits when parsing.

Dependencies

~1.4–2.4MB
~51K SLoC