jwt_hmac

Crates.iojwt_hmac
lib.rsjwt_hmac
version0.2.0
sourcesrc
created_at2021-12-06 22:22:04.683185
updated_at2023-02-15 20:09:42.698456
descriptionA simple library for generating and parsing JWT tokens using HMAC SHA256 as per https://jwt.io/introduction
homepagehttps://github.com/h-i-v-e/jwt_hmac
repositoryhttps://github.com/h-i-v-e/jwt_hmac
max_upload_size
id493421
size10,157
(h-i-v-e)

documentation

README

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

###Encoding example

use jwt_hmac;
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_hmac::create(secret, &claims) {
        Ok(token) => println!("Token: {}", token),
        Err(error) => println!("This can't be happening {}", error)
    }
}

###Decoding example

use jwt_hmac;
use serde::Deserialize;

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

fn main(){
   let secret = "I'm a secret".as_bytes();
   match jwt_hmac::parse::<Claims>(
       secret,
       "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.azXPRJHeWcZ_B5WHtA98gsnowX5gifvMJX2hoH_4YPs"
  ){
         Ok(claims) => println!("Sub: {}", claims.sub),
         Err(error) => match error{
             jwt_hmac::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.

Commit count: 7

cargo fmt