[−][src]Crate jwts
Rust implementation of JSON Web Tokens, see https://tools.ietf.org/html/rfc7519
Examples
Sign
use jwts::Claims; use jwts::jws::{Algorithm, Key, Token}; let mut claims = Claims::new(); claims.iss = Some("sea".to_owned()); let mut token = Token::with_payload(claims); // custom the header like: // token.header.cty = Some("application/example".to_owned()); let key = Key::new(b"secret", Algorithm::HS256); let token = token.sign(&key).unwrap_or_default(); assert_eq!(token, "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJzZWEifQ.L0DLtDjydcSK-c0gTyOYbmUQ_LUCZzqAGCINn2OLhFs");
Parse and Verify
use jwts::{Claims, jws}; use jwts::jws::{Algorithm, Config, Key, SignatureValidation, Token}; let key = Key::new(b"secret", Algorithm::HS256); let signature_validation = SignatureValidation::Key(key); // use key resolver like: // let signature_validation = SignatureValidation::KeyResolver(|header, payload| { // // return a Key here // }); let config = Config { signature_validation, iat_validation: true, nbf_validation: true, exp_validation: true, expected_iss: Some("sea".to_owned()), expected_sub: None, expected_aud: None, expected_jti: None, }; let token = "a jwt token"; let token: Option<Token<Claims>> = jws::parse(token, &config) .map(Option::Some) .unwrap_or_else(|err| { println!("{:?}", err.kind()); None }); println!("{:?}", token);
Custom Claims
use jwts::{Claims, jws}; use jwts::jws::{Algorithm, Key, Token}; #[macro_use] extern crate serde_derive; #[derive(Debug, Serialize, Deserialize)] struct CustomClaims { iss: String, } let claims = CustomClaims { iss: "sea".to_owned(), }; let mut token = Token::with_payload(claims); let key = Key::new(b"secret", Algorithm::HS256); let token = token.sign(&key).unwrap_or_default(); let token: Token<CustomClaims> = jws::parse_validate_none(&token).unwrap(); println!("{:?}", token);
Re-exports
pub use crate::error::Error; |
pub use crate::error::ErrorKind; |
Modules
error | Errors |
jws | Signed JWTs, see https://tools.ietf.org/html/rfc7515 |
Structs
Claims | Registered Claim Names, see https://tools.ietf.org/html/rfc7519#section-4.1 |