From 7aabf7ec57bff1f4783daebedb903dc0cdb00fae Mon Sep 17 00:00:00 2001 From: Nicholas Rempel Date: Wed, 14 Dec 2022 11:03:35 -0800 Subject: [PATCH] Remove example from README.md --- README.md | 130 +----------------------------------------------------- 1 file changed, 1 insertion(+), 129 deletions(-) diff --git a/README.md b/README.md index 88034d5..6594a6d 100644 --- a/README.md +++ b/README.md @@ -31,132 +31,4 @@ specification. ## Getting started -```rust -use std::time::Duration; - -use rcgen::{Certificate, CertificateParams, DistinguishedName}; -use tokio::time::sleep; -use tracing::{error, info}; - -use acme::{ - Account, AuthorizationStatus, ChallengeType, Identifier, LetsEncrypt, NewAccount, NewOrder, - OrderStatus, -}; - -async fn provision(names: Vec) -> anyhow::Result<()> { - // Create a new account. This will generate a fresh ECDSA key for you. - // Alternatively, restore an account from serialized credentials by - // using `Account::from_credentials()`. - - let account = Account::create( - &NewAccount { - contact: &[], - terms_of_service_agreed: true, - only_return_existing: false, - }, - LetsEncrypt::Staging.url(), - ) - .await?; - - // Create the ACME order based on the given domain names. - // Note that this only needs an `&Account`, so the library will let you - // process multiple orders in parallel for a single account. - - let identifiers = names - .iter() - .map(|name| Identifier::Dns(name.into())) - .collect::>(); - let (mut order, state) = account - .new_order(&NewOrder { - identifiers: &identifiers, - }) - .await - .unwrap(); - - info!("order state: {:#?}", state); - assert!(matches!(state.status, OrderStatus::Pending)); - - // Pick the desired challenge type and prepare the response. - - let authorizations = order.authorizations(&state.authorizations).await.unwrap(); - let mut challenges = Vec::with_capacity(authorizations.len()); - for authz in &authorizations { - match authz.status { - AuthorizationStatus::Pending => {} - AuthorizationStatus::Valid => continue, - _ => todo!(), - } - - // We'll use the DNS challenges for this example, but you could - // pick something else to use here. - - let challenge = authz - .challenges - .iter() - .find(|c| c.r#type == ChallengeType::Dns01) - .ok_or_else(|| anyhow::anyhow!("no dns01 challenge found"))?; - - let Identifier::Dns(identifier) = &authz.identifier; - // TODO: set up the challenge response here. - challenges.push((identifier, &challenge.url)); - } - - // Let the server know we're ready to accept the challenges. - - for (_, url) in &challenges { - order.set_challenge_ready(url).await.unwrap(); - } - - // Exponentially back off until the order becomes ready or invalid. - - let mut tries = 1u8; - let mut delay = Duration::from_millis(250); - let state = loop { - sleep(delay).await; - let state = order.state().await.unwrap(); - if let OrderStatus::Ready | OrderStatus::Invalid = state.status { - info!("order state: {:#?}", state); - break state; - } - - delay *= 2; - tries += 1; - match tries < 5 { - true => info!(?state, tries, "order is not ready, waiting {delay:?}"), - false => { - error!(?state, tries, "order is not ready"); - return Err(anyhow::anyhow!("order is not ready")); - } - } - }; - - if state.status == OrderStatus::Invalid { - return Err(anyhow::anyhow!("order is invalid")); - } - - let mut names = Vec::with_capacity(challenges.len()); - for (identifier, _) in challenges { - names.push(identifier.to_owned()); - } - - // If the order is ready, we can provision the certificate. - // Use the rcgen library to create a Certificate Signing Request. - - let mut params = CertificateParams::new(names.clone()); - params.distinguished_name = DistinguishedName::new(); - let cert = Certificate::from_params(params).unwrap(); - let csr = cert.serialize_request_der()?; - - // Finalize the order and print certificate chain, private key and account credentials. - - let cert_chain_pem = order.finalize(&csr, &state.finalize).await.unwrap(); - info!("certficate chain:\n\n{}", cert_chain_pem,); - info!("private key:\n\n{}", cert.serialize_private_key_pem()); - info!( - "account credentials:\n\n{}", - serde_json::to_string_pretty(&account.credentials()).unwrap() - ); - - Ok(()) -} -``` +See the [examples](examples) directory for an example of how to use instant-acme. \ No newline at end of file