jsonwebkey

JSON Web Key (JWK) (de)serialization, generation, and conversion.

Note: requires rustc nightly >= 1.45 for conveniences around fixed-size arrays.

Goals

tl;dr: get keys into a format that can be used by other crates; be as safe as possible while doing so.

Serialization and deserialization of Required and Recommended key types (HS256, RS256, ES256)
Conversion to PEM for interop with existing JWT libraries (e.g., jsonwebtoken)
Key generation (particularly for testing)

Non-goals

be a fully-featured JOSE framework

Example

extern crate jsonwebtoken as jwt;
extern crate jsonwebkey as jwk;

fn main() {
    let jwk_str = r#"{
        "kty": "EC",
        "d": "ZoKQ9j4dhIBlMRVrv-QG8P_T9sutv3_95eio9MtpgKg",
        "crv": "P-256",
        "x": "QOMHmv96tVlJv-uNqprnDSKIj5AiLTXKRomXYnav0N0",
        "y": "TjYZoHnctatEE6NCrKmXQdJJPnNzZEX8nBmZde3AY4k"
    }"#;
    let jwk = jwk::JsonWebKey::from_str(jwk_str).unwrap();
    let encoding_key = jwk::EncodingKey::from_ec_der(jwk.to_der().unwrap());
    let token = jwt::encode(&jwt::Header::default(), &() /* claims */, encoding_key).unwrap();
}

1.2 KiB Raw Blame History

jsonwebkey

Example

1.2 KiB

Raw Blame History