#jwks #auth0 #client #json #key #web

jwks_client_rs

JWKS-sync client implementation for Auth0

8 releases (4 breaking)

0.5.0 Dec 13, 2023
0.4.2 Oct 18, 2023
0.4.1 Apr 3, 2023
0.4.0 Nov 11, 2022
0.1.0 Oct 28, 2021

#46 in Authentication

Download history 664/week @ 2023-12-04 946/week @ 2023-12-11 737/week @ 2023-12-18 353/week @ 2023-12-25 511/week @ 2024-01-01 419/week @ 2024-01-08 212/week @ 2024-01-15 518/week @ 2024-01-22 512/week @ 2024-01-29 519/week @ 2024-02-05 584/week @ 2024-02-12 448/week @ 2024-02-19 422/week @ 2024-02-26 742/week @ 2024-03-04 1159/week @ 2024-03-11 716/week @ 2024-03-18

3,039 downloads per month

MIT license

36KB
759 lines

JWKS Client

This lib is used to store Json Web Key Set from your authentication provider. It stores in an internal Cache fetched JWKS and automatically refresh them after a given time.

Installation

Add to your Cargo.toml

# Cargo.toml
[dependencies]
jwks_client_rs = "0.5"

Code example

// Put in your application context or wherever this can live long enough
use jwks_client_rs::source::WebSource;
use jwks_client_rs::JwksClient;

// here you must join your `BASE_AUTH0_URL` env var with `.well-known/jwks.json` or whatever is the jwks url
let url: reqwest::Url = todo!();
let timeout: std::time::Duration = todo!();
// You can define a different source too using `JwksSource` trait
let source: WebSource = WebSource::builder()
    .with_timeout(timeout)
    .with_connect_timeout(timeout)
    .build(url);

let client: JwksClient<WebSource> = JwksClient::builder()
    .build(source);

// Store your client in your application context or whatever
// ..

// Get jwk by kid
use jwks_client_rs::{JsonWebKey, JwksClientError};

let kid: String = todo!();
let result: Result<JsonWebKey, JwksClientError> = app_context.jwks_client.get(kid).await;

It is possible to decode your token validating it has been signed by one of your authentication provider JWKS.

#[derive(serde::Deserialize)]
struct Claims {
    aud: String,
}

let client: JwksClient = todo!();
// Here's the token. Remember to remove "Bearer " from your token in case it is present
let token: &str = todo!();
// The audience the token were released for.
let audience: &str = todo!();
let result: Result<Claims, JwksClientError> = client.decode::<Claims>(token, audience).await;

Example

A working example could be found in examples folder. To run the example:

  • Export the KID env variable (take it from your tenant well known jwks)
  • Export the BASE_AUTH0_URL (by running localauth0 or using your auth0 tenant; the url should be your localauth0 exposed port on localhost or something like https://{your-tenant}.eu.auth0.com)
  • Run in shell cargo run --example get_jwks

Dependencies

~7–22MB
~333K SLoC