acmex 0.8.0

AcmeX: High-performance, extensible ACME v2 (RFC 8555) client and server in Rust, supporting multiple DNS providers, storage backends, and crypto libraries.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! # AcmeX - ACME v2 Client Library
//!
//! A comprehensive Rust library for interacting with ACME v2 servers (RFC 8555).
//! Supports Let's Encrypt, Google Trust Services, ZeroSSL, and custom ACME implementations.
//!
//! ## Features
//!
//! - **Complete ACME v2 Protocol Support**: Full RFC 8555 implementation
//! - **Multiple Challenge Types**: HTTP-01, DNS-01, TLS-ALPN-01
//! - **Account Management**: Registration, key rollover, deactivation
//! - **Order Management**: Certificate ordering and finalization
//! - **Storage Flexibility**: File-based (default) or Redis-backed storage
//! - **Async/Await**: Built on Tokio for high performance
//!
//! ## Quick Start
//!
//! ```rust,no_run
//! use acmex::prelude::*;
//!
//! #[tokio::main]
//! async fn main() -> acmex::Result<()> {
//!     // Create a client for Let's Encrypt staging
//!     let config = AcmeConfig::new("https://acme-staging-v02.api.letsencrypt.org/directory");
//!
//!     // ... use the client
//!     Ok(())
//! }
//! ```

// Module declarations
pub mod account;
pub mod ca;
pub mod certificate;
pub mod challenge;
pub mod cli;
pub mod client;
pub mod config;
pub mod crypto;
pub mod dns;
pub mod error;
pub mod metrics;
pub mod notifications;
pub mod orchestrator;
pub mod order;
pub mod protocol;
pub mod renewal;
pub mod scheduler;
pub mod server;
pub mod storage;
pub mod transport;
pub mod types;

// Re-exports for convenience
pub use account::{Account, AccountManager, KeyPair, KeyRollover};
pub use ca::{CAConfig, CertificateAuthority, Environment};
pub use certificate::CertificateChain;
pub use challenge::{
    CachingDnsResolver, ChallengeSolver, ChallengeSolverRegistry, Dns01Solver, DnsCache,
    DnsProvider, Http01Solver, MockDnsProvider, TlsAlpn01Solver,
};
pub use client::{AcmeClient, AcmeConfig, CertificateBundle};
pub use config::{AcmeSettings, ChallengeSettings, Config, RenewalSettings, StorageSettings};
#[cfg(feature = "dns-alibaba")]
pub use dns::AlibabaCloudDnsProvider;
#[cfg(feature = "dns-azure")]
pub use dns::AzureDnsProvider;
#[cfg(feature = "dns-cloudns")]
pub use dns::ClouDnsProvider;
#[cfg(feature = "dns-cloudflare")]
pub use dns::CloudFlareDnsProvider;
#[cfg(feature = "dns-digitalocean")]
pub use dns::DigitalOceanDnsProvider;
#[cfg(feature = "dns-godaddy")]
pub use dns::GodaddyDnsProvider;
#[cfg(feature = "dns-google")]
pub use dns::GoogleCloudDnsProvider;
#[cfg(feature = "dns-huawei")]
pub use dns::HuaweiCloudDnsProvider;
#[cfg(feature = "dns-linode")]
pub use dns::LinodeDnsProvider;
#[cfg(feature = "dns-route53")]
pub use dns::Route53DnsProvider;
#[cfg(feature = "dns-tencent")]
pub use dns::TencentCloudDnsProvider;
pub use error::{AcmeError, Result};
pub use metrics::{HealthStatus, MetricsRegistry};
pub use notifications::{EventType, WebhookClient, WebhookConfig, WebhookEvent, WebhookManager};
pub use orchestrator::{CertificateProvisioner, DomainValidator, Orchestrator};
pub use order::{
    Authorization, CertificateRevocation, Challenge, CsrGenerator, FinalizationRequest,
    NewOrderRequest, Order, OrderManager, parse_certificate_chain, verify_certificate_domains,
};
pub use protocol::{Directory, DirectoryManager, Jwk, JwsSigner, NonceManager};
pub use renewal::{RenewalHook, SimpleRenewalScheduler};
pub use scheduler::{AdvancedRenewalScheduler, CleanupScheduler, RenewalScheduler};
pub use server::{HealthCheck, WebhookHandler, start_server};
#[cfg(feature = "redis")]
pub use storage::RedisStorage;
pub use storage::{EncryptedStorage, FileStorage};
pub use types::{
    AuthorizationStatus, ChallengeType, Contact, Identifier, OrderStatus, RevocationReason,
};

/// Prelude module with commonly used types
pub mod prelude {
    pub use crate::{
        AcmeClient, AcmeConfig,
        account::{Account, AccountManager, KeyPair, KeyRollover},
        certificate::CertificateChain,
        crypto::{Base64Encoding, Sha256Hash},
        error::{AcmeError, Result},
        orchestrator::{CertificateProvisioner, DomainValidator, Orchestrator},
        order::{
            Authorization, CertificateRevocation, Challenge, FinalizationRequest, NewOrderRequest,
            Order,
        },
        protocol::{Directory, DirectoryManager, Jwk, JwsSigner, NonceManager},
        scheduler::{AdvancedRenewalScheduler, CleanupScheduler},
        transport::HttpClient,
        types::{
            AuthorizationStatus, ChallengeType, Contact, Identifier, OrderStatus, RevocationReason,
        },
    };
}