8 releases
0.2.7 | May 10, 2022 |
---|---|
0.2.6 |
|
0.2.5 | Oct 3, 2021 |
0.2.4 | Oct 14, 2020 |
0.1.0 | Dec 25, 2018 |
#6 in #jws
271 downloads per month
46KB
677 lines
jws
This library provides JSON Web Signature encoding, decoding, signing and verification as described in RFC 7515.
Currently, encoding and decoding is available only for the JWS Compact Serialization scheme in the
compact
module.
Signing and verifying is done through the Signer
and Verifier
traits.
The hmac
module contains implementations for these traits that support the HMAC-SHA2 family of algorithms.
Example:
use jws::{JsonObject, JsonValue};
use jws::compact::{decode_verify, encode_sign};
use jws::hmac::{Hs512Signer, HmacVerifier};
fn encode_decode() -> jws::Result<()> {
// Add custom header parameters.
let mut header = JsonObject::new();
header.insert(String::from("typ"), JsonValue::from("text/plain"));
// Encode and sign the message.
let encoded = encode_sign(header, b"payload", &Hs512Signer::new(b"secretkey"))?;
// Decode and verify the message.
let decoded = decode_verify(encoded.data().as_bytes(), &HmacVerifier::new(b"secretkey"))?;
assert_eq!(decoded.payload, b"payload");
assert_eq!(decoded.header.get("typ").and_then(|x| x.as_str()), Some("text/plain"));
Ok(())
}
Dependencies
~1.6–2.4MB
~54K SLoC