Compact JWT implementation in Rust

Documentation:

Minimalistic JSON web token (JWT) implementation with focus on type safety and secure cryptographic primitives.

Usage

Add this to your Crate.toml:

toml [dependencies] jwt-compact = "0.5.0"

See the crate docs for the examples of usage.

Features

Algorithm-specific signing and verifying keys (i.e., type safety).
Key strength requirements from [RFC 7518] are expressed with wrapper types.
Easy to extend to support new signing algorithms.
The crate supports more compact [CBOR] encoding of the claims.
Basic [JWK] functionality for key conversion from human-readable formats (JSON / YAML / TOML) and computing [key thumbprints].
HS256, HS384 and HS512 algorithms are implemented via pure Rust [sha2] crate.
The crate supports EdDSA algorithm with the Ed25519 elliptic curve, and ES256K algorithm with the secp256k1 elliptic curve. Both curves are widely used in crypto community and believed to be securely generated (there are some doubts about parameter generation for elliptic curves used in standard ES* algorithms).
RSA algorithms (RS* and PS*) are supported via pure Rust [rsa] crate.
Supports the no_std mode. No-std support and WASM compatibility are explicitly tested.

Missing features

Built-in checks of some claims (e.g., iss – the token issuer). This is intentional: depending on the use case, such claims can have different semantics and thus be represented by different datatypes (e.g., iss may be a human-readable short ID, a hex-encoded key digest, etc.)

Supported Rust Versions

The base crate is compatible with Rust 1.51+. The k256 cryptographic backend requires Rust 1.56+, while other backends are compatible with 1.51+.

Alternatives

[jsonwebtoken], [frank_jwt] or [biscuit] may be viable alternatives depending on the use case (e.g., none of them seems to implement EdDSA or ES256K algorithms).

License

Licensed under the Apache-2.0 license.