Skip to main content

Module config

Module config 

Source
Expand description

Central configuration hub and certificate lifecycle management.

This module provides the Config struct, which is the primary entry point for managing TLS certificates. It coordinates certificate obtainment, renewal, revocation, and caching across multiple issuers and a persistent storage backend.

§Usage

use certon::config::Config;

let config = Config::builder()
    .storage(my_storage)
    .build();

config.manage_sync(&["example.com".into()]).await?;

Structs§

Config
Central configuration for automatic TLS certificate management.
ConfigBuilder
Builder for constructing a Config with sensible defaults.

Enums§

IssuerPolicy
Controls how issuers are selected when obtaining or renewing certificates.

Constants§

EVENT_CACHED_MANAGED_CERT
Event emitted when a managed certificate is cached (loaded from storage into the in-memory CertCache).
EVENT_CERT_FAILED
Event emitted when a certificate obtain or renewal operation failed.
EVENT_CERT_OBTAINED
Event emitted when a certificate has been successfully obtained.
EVENT_CERT_OBTAINING
Event emitted when a certificate obtain operation begins.
EVENT_CERT_RENEWED
Event emitted when a certificate has been successfully renewed.
EVENT_CERT_REVOKED
Event emitted when a certificate has been revoked.

Traits§

CertificateSelector
Trait for custom certificate selection logic during TLS handshakes.