Struct CertmagicResolver 

pub struct CertmagicResolver { /* private fields */ }

Sync rustls resolver: cache fast-path (scheme A) + optional background remediation (scheme C).

Implementations

impl CertmagicResolver

pub fn new<S>(source: S) -> Self

where S: Into<ResolverSource>,

Create a resolver backed by an in-memory certificate cache or config.

Passing Arc<Cache> selects the cache-only form. Passing Arc<Config> keeps the legacy certmagic form and retains its default-name behavior. The resolver starts in cache-only mode; use Self::with_background_remediation when an uncached name should trigger a detached on-demand obtain.

pub fn from_cache(cache: Arc<Cache>) -> Self

Create a cache-only resolver explicitly.

pub fn from_config(config: Arc<Config>) -> Self

Create a resolver explicitly from a complete Config.

pub fn with_background_remediation(config: Arc<Config>, enabled: bool) -> Self

Create a resolver and choose whether cache misses should schedule a background on-demand obtain.

pub fn with_on_demand(cache: Arc<Cache>, on_demand: Arc<OnDemandConfig>) -> Self

Create a resolver with cache-owned on-demand settings.

The cache owner supplies the complete issuance pipeline. Keeping the OnDemandConfig here preserves the simple constructor shape while retaining certmagic’s fail-closed admission and retry logic in Config.

pub fn set_default_server_name(&mut self, name: Option<String>)

Set the server name used when the ClientHello has no SNI.

pub fn set_fallback_server_name(&mut self, name: Option<String>)

Set the server name used when no certificate matches the requested SNI.

pub async fn set_challenge_cert(&self, domain: String, cert: Arc<CertifiedKey>)

Register a TLS-ALPN-01 challenge certificate for domain.

pub async fn remove_challenge_cert(&self, domain: &str)

Remove a previously registered TLS-ALPN-01 challenge certificate.

pub async fn set_default_cert(&self, cert: Arc<CertifiedKey>)

Set the certificate used as the final resolver fallback.

pub async fn clear_default_cert(&self)

Clear the resolver’s final fallback certificate.

Trait Implementations

impl Debug for CertmagicResolver

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

Formats the value using the given formatter.

impl ResolvesServerCert for CertmagicResolver

fn resolve(&self, client_hello: ClientHello<'_>) -> Option<Arc<CertifiedKey>>

Choose a certificate chain and matching key given simplified ClientHello information.

fn only_raw_public_keys(&self) -> bool

Return true when the server only supports raw public keys.