Struct RemoteKeySet 

pub struct RemoteKeySet { /* private fields */ }

Available on crate feature http only.

A JWKS source that fetches from an HTTP endpoint on every request.

This implementation does not cache keys. Every call to get_key or get_keyset will make an HTTP request.

For production use with high request volumes, wrap this in CachedKeySet:

use jwk_simple::{RemoteKeySet, CachedKeySet};
use std::time::Duration;

let remote = RemoteKeySet::new("https://example.com/.well-known/jwks.json");
let cached = CachedKeySet::new(remote, Duration::from_secs(300));

Examples

use jwk_simple::{KeySource, RemoteKeySet};

let jwks = RemoteKeySet::new("https://example.com/.well-known/jwks.json");
let key = jwks.get_key("my-key-id").await?;

Custom HTTP Client

You can provide a custom reqwest::Client for full control over HTTP behavior:

use jwk_simple::RemoteKeySet;
use std::time::Duration;

let client = reqwest::Client::builder()
    .timeout(Duration::from_secs(10))
    .user_agent("my-app/1.0")
    .build()
    .unwrap();

let jwks = RemoteKeySet::new_with_client(
    "https://example.com/.well-known/jwks.json",
    client,
);

Implementations

impl RemoteKeySet

pub fn new(url: impl Into<String>) -> Self

Creates a new RemoteKeySet from a URL.

Uses a default HTTP client with a 30-second timeout. To customize the client, use new_with_client.

Arguments

• url - The JWKS endpoint URL.

pub fn new_with_client(url: impl Into<String>, client: Client) -> Self

Creates a new RemoteKeySet with a custom HTTP client.

Use this to configure custom timeouts, headers, proxies, TLS settings, etc.

Arguments

• url - The JWKS endpoint URL.
• client - A configured reqwest::Client.

Examples

use jwk_simple::RemoteKeySet;
use std::time::Duration;

let client = reqwest::Client::builder()
    .timeout(Duration::from_secs(10))
    .build()
    .unwrap();

let jwks = RemoteKeySet::new_with_client(
    "https://example.com/.well-known/jwks.json",
    client,
);

Trait Implementations

impl Clone for RemoteKeySet

fn clone(&self) -> RemoteKeySet

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RemoteKeySet

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl KeySource for RemoteKeySet

fn get_key<'life0, 'life1, 'async_trait>( &'life0 self, kid: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Key>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Gets a key by its key ID (kid).

fn get_keyset<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<KeySet>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gets all available keys as a KeySet.