jwks 0.1.3

A library for retrieving and parsing JSON Web Key Sets (JWKS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

# jwks
Fetch and parse JSON Web Key Set (JWKS)

```
cargo add jwks
```

<https://crates.io/crates/jwks>

## Usage

From a jwks url.
```rust
let jwks_url = "https://www.googleapis.com/oauth2/v3/certs";
let jwks = Jwks::from_jwks_url(jwks_url).await.unwrap();
```

From a openid config url.
```rust
let openid_config_url = "https://accounts.google.com/.well-known/openid-configuration";
let jwks = Jwks::from_oidc_url(openid_config_url).await.unwrap();
```

Use with [jsonwebtokn](https://github.com/Keats/jsonwebtoken) to validate a jwt
```rust
use jsonwebtoken::{decode, decode_header, Algorithm, TokenData, Validation};

let jwt = "...base64-encoded-jwt...";

// get the kid from jwt
let header = decode_header(jwt).expect("jwt header should be decoded");
let kid = header.kid.as_ref().expect("jwt header should have a kid");

// get a jwk from jwks by kid
let jwks_url = "https://www.googleapis.com/oauth2/v3/certs";
let jwks = Jwks::from_jwks_url().await.unwrap();
let jwk = jwks.keys.get(kid).expect("jwt refer to a unknown key id");

let validation = Validation::default();
let decoded_token: TokenData<Claims> = decode::<Claims>(jwt, &jwk.decoding_key, &validation).expect("jwt should be valid");
```