本庫提供與 ACME 服務（例如 Let's Encrypt）交互的功能，主要涵蓋以下兩大模組：
- account: 負責 ACME 帳戶的創建與管理，包含 JWS 簽名、密鑰對生成、非重放（nonce）管理以及與 ACME 目錄服務的交互。
- order: 用於證書訂單的處理，從新建訂單、挑戰驗證、最終訂單確認到證書下載，並支持 DNS 驗證（目前支援 Cloudflare）。
- 自動管理帳戶的密鑰對與持久化存儲
- 支持 ACME 新帳戶創建流程
- 提供訂單創建、挑戰驗證、CSR 生成與簽名、證書下載等全流程操作
- 支持 Cloudflare DNS API，實現 DNS TXT 記錄的創建與驗證
使用者可以通過兩大主要 API 來完成證書申請流程：
-
帳戶管理（
account模組）：
使用 [Account::new] 或 [AccountBuilder] 建 6920 ACME 帳戶，該過程會自動處理密鑰對生成、目錄交互與帳戶註冊，並將相關資料持久化存儲。 -
訂單管理（
order模組）：
使用 [Order::new] 創建新訂單，然後透過 [Order::finalize]、[Order::validate_challenge] 與 [Order::download_certificate] 進行訂單的最終確認和證書下載。
如需使用 DNS 驗證，可搭配 [Order::dns_provider] 配置 Cloudflare 提供的 DNS TXT 記錄。
以下是一個簡單的示例，展示如何使用該庫完成 ACME 帳戶與訂單的基本操作：
use acme_lib::{account::Account, order::{Order, DnsProvider}};
fn main() -> Result<(), Box<dyn std::error::Error>> {
// 1. 創建 ACME 帳戶
let mut account = Account::new("user@example.com")?;
// 2. 為指定域名建立訂單
let domain = "example.com";
let mut order = Order::new(&mut account, domain)?;
// 3. 如使用 DNS 驗證，先使用 Cloudflare 配置 DNS
order = order.dns_provider(DnsProvider::Cloudflare, "your-cloudflare-api-token")?;
// 4. 驗證挑戰（假設使用 DNS-01 挑戰）
order = order.validate_challenge(&account, order::ChallengeType::Dns01)?;
// 5. 當訂單處於 Ready 狀態，提交 CSR 以最終確認訂單
order.finalize(&account)?;
// 6. 下載證書
order.download_certificate(&account)?;
Ok(())
}更多詳細 API 說明請參考各個模組的文檔。