Cataclysm-jwt

Simple session builder for JWT with support for RS256 and HS256 for Cataclysm.

Instalation

Simply add the dependecy to Cargo.toml file:

cataclysm-jwt = { git = "https://github.com/Arthur-phys/cataclysm-jwt.git" }

Configuration

The crate has three optional features:

• lax-security: disables checking for 'aud', 'iss', 'exp', 'iat' and 'nbf' fields
• jwk-alg: Enables checking JWK for optional field 'alg'
• jwk-use: Enables checking JWK for optional fiel 'use'

Examples

Two examples can be found under the examples folder. One is provided here for completeness:

const aud: &str = "AUDIENCE";
const iss: &str = "ISSUER";
const jwks_url: &str = "URL";
 
// Function requires a session as argument
async fn index(session: Session) -> Response {

    // Parameters on JWT Payload can be obtained easily:
    let iat = session.get("iat").unwrap();
    let name = session.get("name").unwrap();
    println!("Token issued at: {}",iat);
    println!("Name of person: {}",name);
    Response::ok().body("Hello, World!")

}


#[tokio::main]
async fn main() -> Result<(),Error> {

    let server = Server::builder(
        Branch::<()>::new("/").with(Method::Get.to(index))
    ).session_creator(
        // Builder requires a session
        // Assymmetric session built in this case
        JWTSessionBuilder::with_rs256().aud(aud)
        .iss(iss)
        // Used url for JWKs 
        .add_from_jwks(jwks_url)
        .await?
        .build()?
    )
    .build().unwrap();
 
    server.run("127.0.0.1:8000").await.unwrap();

    Ok(())

}

Documentation

https://arthur-phys.github.io/cataclysm-jwt/cataclysm_jwt/