Struct MetadataCache 

pub struct MetadataCache { /* private fields */ }

AS metadata cache.

Implementations

impl MetadataCache

pub fn new( fetcher: DocumentFetcherFn, expected_issuer: impl Into<String>, fetch_settings: FetchSettings, refresh_seconds: u64, on_change: Option<MetadataChangeCallback>, ) -> Self

Create a new metadata cache.

fetcher MUST GET the AS metadata document. expected_issuer is the issuer the application configured; the discovered document is rejected if its issuer field does not match exactly (RFC 8414).

pub fn document_cache(&self) -> Arc<DocumentCache>

Underlying DocumentCache (for aclose() plumbing).

pub async fn aclose(&self)

Cancel any background refresh task.

pub async fn get_metadata(&self) -> Result<Value, AuthplaneError>

Return the cached metadata document, refreshing if expired.

pub async fn refresh(&self) -> Result<Value, AuthplaneError>

Force-refresh and return the metadata document.

pub async fn endpoint(&self, key: &str) -> Result<String, AuthplaneError>

Read a specific endpoint URL out of the cached metadata.

pub async fn get_jwks_uri(&self) -> Result<String, AuthplaneError>

Convenience accessor for jwks_uri. The URL is validated through the fetch settings (HTTPS-only, SSRF, …).

pub async fn get_token_endpoint(&self) -> Result<String, AuthplaneError>

Convenience accessor for token_endpoint.

pub async fn get_introspection_endpoint(&self) -> Result<String, AuthplaneError>

Convenience accessor for introspection_endpoint.

pub async fn get_revocation_endpoint(&self) -> Result<String, AuthplaneError>

Convenience accessor for revocation_endpoint.

Trait Implementations

impl Clone for MetadataCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetadataCache

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

Formats the value using the given formatter.